RemoteObject

包	mx.rpc.remoting
类	public dynamic class RemoteObject
继承	RemoteObject AbstractService Proxy
子类	RemoteObject

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

RemoteObject 类使您可以访问远程应用程序服务器上的类。

公共属性

隐藏继承的公共属性

显示继承的公共属性

	属性		由以下参数定义
		channelSet : ChannelSet 提供对服务使用的 ChannelSet 的访问。	AbstractService
		concurrency : String 指示如何处理对同一服务的多个调用的值。	RemoteObject
		convertParametersHandler : Function 一个可选函数，主要供具有以下需要的框架开发人员使用：安装用传递给每个远程对象调用的参数进行调用的函数。	RemoteObject
		convertResultHandler : Function 一个可选函数，主要供具有以下需要的框架开发人员使用：安装一个挂钩，以便在通知结果处理程序之前处理操作的结果。	RemoteObject
		destination : String 服务的目标。	AbstractService
		endpoint : String 此属性可使开发人员在编译或以编程方式创建 ChannelSet 时快速指定 RemoteObject 目标的端点，而无需引用服务配置文件。	RemoteObject
		makeObjectsBindable : Boolean 当该置为 true 时，返回的匿名对象将强制成为可绑定的对象。	RemoteObject
		managers : Array managers 属性存储修改此服务行为的数据管理器的列表。	AbstractService
		operations : Object 如果使用 MXML 标签创建服务，则操作数组通常仅由 MXML 编译器设置。	AbstractService
		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
		initialize():void 调用以初始化服务。	AbstractService
		logout():void 将用户从目标中注销。	AbstractService
		setCredentials(username:String, password:String, charset:String = null):void 当在服务器端使用 Data Services 时，为服务访问的目标设置凭据。	AbstractService
		setRemoteCredentials(remoteUsername:String, remotePassword:String, charset:String = null):void [覆盖] 如果远程对象由外部服务（如 ColdFusion 组件 (CFC)）管理，则可以为该远程服务的身份验证机制设置用户名和密码。	RemoteObject
		toString():String 将 RemoteObject 的实例表示为字符串，描述如目标 id 和所分配的通道集等重要属性。	RemoteObject

事件

单击此处了解有关事件的更多信息

隐藏继承的事件

显示继承的事件

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

属性详细信息

concurrency

属性

concurrency:String

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

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

multiple — 不取消现有请求，由开发人员负责通过仔细管理事件流来确保返回数据的一致性。此为默认。
single — 每次只允许在此方法中发出一个请求；在有请求未处理时在客户端上发出的其它请求会立即出错，而不会发送给服务器。
last — 发出请求可导致客户端忽略任何当前未处理请求的结果或错误。仅在客户端上调度最新请求的结果或错误。这样可以简化客户端应用程序中的事件处理过程，但应该特别注意的是，只有在可以安全忽略请求的结果或错误时，才可使用此模式。

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

convertParametersHandler

属性

public var convertParametersHandler:Function

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

一个可选函数，主要供具有以下需要的框架开发人员使用：安装用传递给每个远程对象调用的参数进行调用的函数。该函数接受一个参数数组，并返回可能改变的数组。该函数定义应该如下所示： function myParametersFunction(parameters:Array):Array

convertResultHandler

属性

public var convertResultHandler:Function

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

一个可选函数，主要供具有以下需要的框架开发人员使用：安装一个挂钩，以便在通知结果处理程序之前处理操作的结果。该函数定义应该如下所示： function myConvertResultsFunction(result: operation:AbstractOperation)： 在 makeObjectsBindable 转换完成之后、创建结果事件之前向其传递结果。

endpoint

属性

endpoint:String

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

此属性可使开发人员在编译或以编程方式创建 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

makeObjectsBindable

属性

makeObjectsBindable:Boolean

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

当该置为 true 时，返回的匿名对象将强制成为可绑定的对象。

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

showBusyCursor

属性

showBusyCursor:Boolean

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

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

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

source

属性

source:String

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

用于指定客户端上的源值；不支持使用 JavaAdapter 的目标。这样即可提供可从服务器上的单个目标访问的多个源。

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

构造函数详细信息

()

构造函数

public function RemoteObject(destination:String = null)

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

创建一个新的 RemoteObject。

参数

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

方法详细信息

getOperation

()

方法

override public function getOperation(name:String):AbstractOperation

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

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

参数

name:String — 操作的名称。

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

setRemoteCredentials

()

方法

override public function setRemoteCredentials(remoteUsername:String, remotePassword:String, charset:String = null):void

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

如果远程对象由外部服务（如 ColdFusion 组件 (CFC)）管理，则可以为该远程服务的身份验证机制设置用户名和密码。

参数

	`remoteUsername:String` — 要传递给远程端点的用户名

	`remotePassword:String` — 要传递给远程端点的密码

	`charset:String` (default = `null`) — 对远程凭据进行编码时使用的字符集编码。默认值为 null，表示旧字符集 ISO-Latin-1。其它受支持的字符集仅有“UTF-8”。

toString

()

方法

public function toString():String

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

将 RemoteObject 的实例表示为字符串，描述如目标 id 和所分配的通道集等重要属性。

String — 返回表示 RemoteObject 的实例的 String。

法律声明 | 在线隐私策略

RemoteObject - AS3 Flex

类 x

concurrency

convertParametersHandler

convertResultHandler

endpoint

makeObjectsBindable

showBusyCursor

source

RemoteObject

getOperation

setRemoteCredentials

toString