ManagedRemoteService  - AS3 ADEP Data Services

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

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

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

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

提供对 MessageAgent 的目标的访问。更改目标将断开 MessageAgent 的连接（如果当前已连接）。

不受 Managed Remoting 支持。

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

如果您要在访问延迟访存的数据或未分页的数据时禁止项挂起错误，请将此属性设置为 false。将为 ArrayCollection 中的属性值或 getItemAt() 调用返回 null，而不是引发错误。

对于尚未从服务器中访存其大小的列表，size() 返回 0 个元素。当从服务器返回该元素时，将调度相应的 PropertyChangeEvent 和 CollectionEvent 事件。

如果为 true，则请确认所有受管理实体是否存在。当服务初始化时，将验证由该服务指定的每个受管理实体以确保客户端中存在带有相应别名的类。如果客户端不使用该服务的所有受管理实体，且不希望在代码中链接未使用的类，可以将此值设置为 false。默认值为 true。

创建一个新的 ManagedRemoteService。

向服务中添加事件侦听器。

参数

指示是否存在此特定对象的挂起更改。如果 ManagedRemoteService 未初始化（不管是通过调用操作还是显式调用 initialize()），此方法将始终返回 false。

参数

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

参数

强制初始化受管理远程服务。成功时生成 ResultEvent，失败时生成 DataServiceFaultEvent。注意：请勿使用 initialize() 函数，因为此函数不会启动 ManagedRemoteService。

从服务目标中注销用户，并释放所有受管理集合和项目。与受管理远程服务相关联的所有 Data Services 也都调用 logout()。

从基础 DataService 的管理中释放指定集合。（请参阅 DataService.releaseCollection() 以获得更多注释）

参数

从基础 DataService 的管理中释放指定项。（请参阅 DataService.releaseItem() 以获得更多注释）

参数

从服务中删除指定侦听器。

参数

这会撤消对指定项的任何更改，并从缓存中删除这些更改。如果指定的项没有任何更改，则该方法会返回 false。如果指定的项发生更改，则它会将更改还原，并返回 true。如果 ManagedRemoteService 未初始化（不管是通过调用操作还是显式调用 initialize()），此方法将始终返回 false。

参数

在服务器端使用 Managed Remoting 时，为服务访问的目标设置凭据。凭据适用于通过相同 ChannelSet 连接的所有服务。

参数

为指定的命名操作设置 pageSize。也可以通过直接访问操作来设置。操作是服务的动态属性，因此无法在 IDE 中访问

service.operationname.pageSize

参数

为此 Managed Remoting 目标的第三方设置凭据。

参数

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

如果在挂起的本地更改和其它客户端提交的更改之间检测到冲突，或者此客户端提交的更改与远程目标中的更改发生冲突，则调度 DataConflictEvent.CONFLICT 事件。每个 ManagedRemoteService 实例仅为此特定目标的项发送冲突事件。

事件对象的属性有下列值：

当由于错误而导致服务调用失败时，将调度 DataServiceFaultEvent.FAULT 事件。

事件对象的属性有下列值：

当远程目标推送数据操作的通知时，将调度 MessageEvent.MESSAGE 事件。例如，在远程目标上更新数据时，会将更新操作发送给所有正在侦听的客户端，然后在此 DataService 实例上将此操作转换为 message 事件。

此常量的值为 "message"。

事件对象的属性有下列值：

当服务调用成功返回时，将调度 ResultEvent.RESULT 事件。例如，如果 fill() 方法调用成功，则该调用会调度此事件。

事件对象的属性有下列值：