mx.rpc.remoting.mxml.RemoteObject (Flex 3.2)

包	mx.rpc.remoting.mxml
类	public dynamic class RemoteObject
继承	RemoteObject RemoteObject AbstractService Proxy Object
实现	IMXMLSupport, IMXMLObject

<mx:RemoteObject> 标签使您可以访问使用 Action Message Format (AMF) 编码的 Java 对象的方法。

MXML 语法

隐藏 MXML 语法

The <mx:RemoteObject> tag accepts the following tag attributes:

 <mx:RemoteObject
  Properties
  concurrency="multiple|single|last"
  destination="No default."
  id="No default."
  endpoint="No default."
  showBusyCursor="false|true"
  source="No default." (currently, Adobe ColdFusion only)
  makeObjectsBindable="false|true"
  
  Events
  fault="No default."
  result="No default."  
 />

<mx:RemoteObject> can have multiple <mx:method> tags, which have the following tag attributes:

 <mx:method
  Properties
  concurrency="multiple|single|last"
  name="No default, required."
  makeObjectsBindable="false|true"
         
 Events
  fault="No default."
  result="No default."
 />

It then can have a single <mx:arguments> child tag which is an array of objects that is passed in order.

	属性	定义方
		channelSet : ChannelSet 提供对服务使用的 ChannelSet 的访问。	AbstractService
		concurrency : String 指示如何处理对同一服务的多个调用的值。	RemoteObject
		constructor : Object 对类对象或给定对象实例的构造函数的引用。	Object
		destination : String 服务的目标。	AbstractService
		endpoint : String 此属性可使开发人员在编译或以编程方式创建 ChannelSet 时快速指定 RemoteObject 目标的端点，而无需引用服务配置文件。	RemoteObject
		makeObjectsBindable : Boolean 当该置为 true 时，返回的匿名对象将强制成为可绑定的对象。	RemoteObject
		operations : Object 如果使用 MXML 标签创建服务，则操作数组通常仅由 MXML 编译器设置。	AbstractService
		prototype : Object [静态] 对类或函数对象的原型对象的引用。	Object
		requestTimeout : int 提供对已发送消息的请求超时（以秒为单位）的访问。	AbstractService
		showBusyCursor : Boolean 如果为 true，在执行服务时会显示忙碌光标。	RemoteObject
		source : String 用于指定客户端上的源值；不支持使用 JavaAdapter 的目标。	RemoteObject

公共方法

隐藏继承的公共方法

显示继承的公共方法

	方法		定义方
		RemoteObject(destination:String = null) 创建一个新的 RemoteObject。	RemoteObject
		disconnect():void 断开此服务的网络连接并删除任何未处理的请求 responder。	AbstractService
		getOperation(name:String):AbstractOperation 返回给定名称的操作。	RemoteObject
		hasOwnProperty(name:String):Boolean 指示对象是否已经定义了指定的属性。	Object
		initialized(document:Object, id:String):void 如果使用标签设置 RemoteObject，则由 MXML 编译器自动调用。	RemoteObject
		isPrototypeOf(theClass:Object):Boolean 指示 Object 类的实例是否在指定为参数的对象的原型链中。	Object
		logout():void 将用户从目标中注销。	AbstractService
		propertyIsEnumerable(name:String):Boolean 指示指定的属性是否存在、是否可枚举。	Object
		setCredentials(username:String, password:String, charset:String = null):void 当在服务器端使用 Data Services 时，为服务访问的目标设置凭据。	AbstractService
		setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void 设置循环操作动态属性的可用性。	Object
		setRemoteCredentials(remoteUsername:String, remotePassword:String, charset:String = null):void 如果远程对象由外部服务（如 ColdFusion 组件 (CFC)）管理，则可以为该远程服务的身份验证机制设置用户名和密码。	RemoteObject
		toString():String 将 RemoteObject 的实例表示为字符串，描述如目标 id 和所分配的通道集等重要属性。	RemoteObject
		valueOf():Object 返回指定对象的原始值。	Object

摘要	定义方
fault	当服务调用失败并且操作自身不处理时，将调度 fault 事件。	AbstractService
invoke	当调用服务操作时，只要在通道尝试发送消息前没有引发错误，将调度 invoke 事件。	AbstractService
result	当服务调用成功返回并且操作自身不处理时，将调度 result 事件。	AbstractService

属性详细信息

concurrency

属性

concurrency:String [读写]

指示如何处理对同一服务的多个调用的值。默认值为 multiple。允许使用的值包括：

multiple 不取消现有请求，开发人员通过谨慎管理事件流来负责确保返回数据的一致性。此为默认。
single 一次仅允许执行一个请求；多个请求会生成错误。
last 发出请求会取消所有现有请求。

实现
public function get concurrency():String
public function set concurrency(value:String):void

endpoint

属性

endpoint:String [读写]

此属性可使开发人员在编译或以编程方式创建 ChannelSet 时快速指定 RemoteObject 目标的端点，而无需引用服务配置文件。如果已经为 RemoteObject 服务设置了 ChannelSet，它也可以覆盖现有的 ChannelSet。

如果端点 url 以“https”开头，将使用 SecureAMFChannel；否则将使用 AMFChannel。可以在端点 url 中使用 {server.name} 和 {server.port} 这两个特殊标记，以指定通道应使用用来加载 SWF 的服务器名称和端口。

注意：当创建 AIR 应用程序时该属性是必需的。

实现
public function get endpoint():String
public function set endpoint(value:String):void

showBusyCursor

属性

showBusyCursor:Boolean [读写]

如果为 true，在执行服务时会显示忙碌光标。默认值为 false。

实现
public function get showBusyCursor():Boolean
public function set showBusyCursor(value:Boolean):void

构造函数详细信息

RemoteObject

()

构造函数

public function RemoteObject(destination:String = null)

创建一个新的 RemoteObject。

参数

destination:String (default = null) — RemoteObject 的目标，应与 services-config.xml 文件中的目标名称匹配。

方法详细信息

getOperation

()

方法

override public function getOperation(name:String):AbstractOperation

返回给定名称的操作。如果之前没有创建该操作，则将在此调用过程中创建一个新的 mx.rpc.remoting.mxml.Operation。通常只需在服务变量之后命名操作即可访问操作 (myService.someOperation)，但如果 Operation 的名称恰好与服务上所定义的方法（如 setCredentials）相匹配，则可以改用此方法来获取 Operation。

参数

name:String — 操作的名称。

AbstractOperation — 为此名称执行的操作。

initialized

()

方法

public function initialized(document:Object, id:String):void

如果使用标签设置 RemoteObject，则由 MXML 编译器自动调用。如果通过 ActionScript 创建 RemoteObject，则可能希望自行调用此方法（因为它对验证任何参数都非常有用）。

参数

	`document:Object` — 此 RemoteObject 所在的 MXML 文档

	`id:String` — 此 RemoteObject 在文档中的 ID

Adobe® Flex™ 3.2 语言参考		全部包 \| 全部类 \| 语言元素 \| 索引 \| 附录 \| 约定 \| 框架无框架
RemoteObject	属性 \| 方法 \| 事件 \| 样式 \| 效果 \| 常量 \| 示例