包 | mx.data |
类 | public dynamic class ManagedRemoteService |
继承 | ManagedRemoteService AbstractService Proxy |
实现 | IEventDispatcher |
子类 | ManagedRemoteService |
语言版本: | ActionScript 3.0 |
产品版本: | Adobe Digital Enterprise Platform Data Services for Java EE 4.6 |
运行时版本: | Flash Player 10.2, AIR 2.6 |
属性 | 由以下参数定义 | ||
---|---|---|---|
channelSet : ChannelSet
提供对服务使用的 ChannelSet 的访问。 | AbstractService | ||
concurrency : String
指示如何处理对同一服务的多个调用的值。 | ManagedRemoteService | ||
convertParametersHandler : Function
一个可选函数,主要供具有以下需要的框架开发人员使用:安装用传递给每个远程对象调用的参数进行调用的函数。 | ManagedRemoteService | ||
convertResultHandler : Function
一个可选函数,主要供具有以下需要的框架开发人员使用:安装一个挂钩,以便在通知结果处理程序之前处理操作的结果。 | ManagedRemoteService | ||
destination : String [覆盖]
提供对 MessageAgent 的目标的访问。 | ManagedRemoteService | ||
managers : Array [覆盖]
不受 Managed Remoting 支持。 | ManagedRemoteService | ||
operations : Object
如果使用 MXML 标签创建服务,则操作数组通常仅由 MXML 编译器设置。 | AbstractService | ||
requestTimeout : int
提供对已发送消息的请求超时(以秒为单位)的访问。 | AbstractService | ||
showBusyCursor : Boolean
如果为 true,在执行服务时会显示忙状态光标。 | ManagedRemoteService | ||
throwItemPendingErrors : Boolean
如果您要在访问松散访存的数据或未分页的数据时禁止项挂起错误,请将此属性设置为 false。 | ManagedRemoteService | ||
verifyEntityClasses : Boolean
如果为 true,则请验证所有受管理实体是否存在。 | ManagedRemoteService |
方法 | 由以下参数定义 | ||
---|---|---|---|
ManagedRemoteService(destinationId:String = null)
创建一个新的 ManagedRemoteService。 | ManagedRemoteService | ||
addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void [覆盖]
向服务中添加事件侦听器。 | ManagedRemoteService | ||
指示是否存在此特定对象的挂起更改。 | ManagedRemoteService | ||
断开此服务的网络连接并删除任何未处理的请求 responder。 | AbstractService | ||
[覆盖]
返回给定名称的操作。 | ManagedRemoteService | ||
调用以初始化服务。 | AbstractService | ||
强制初始化受管理远程服务。 | ManagedRemoteService | ||
[覆盖]
从服务目标中注销用户,并释放所有受管理集合和项目。 | ManagedRemoteService | ||
releaseCollection(view:ListCollectionView, clear:Boolean = false, copyStillManagedItems:Boolean = true):void
从基础 DataService 的管理中释放指定集合。 | ManagedRemoteService | ||
releaseItem(item:IManaged, dontClearStillManagedItems:Boolean = true, copyStillManagedItems:Boolean = true):IManaged
从基础 DataService 的管理中释放指定项。 | ManagedRemoteService | ||
[覆盖]
从服务中删除指定侦听器。 | ManagedRemoteService | ||
这会撤消对指定项的任何更改,并从缓存中删除这些更改。 | ManagedRemoteService | ||
[覆盖]
在服务器端使用 Managed Remoting 时,为服务访问的目标设置凭据。 | ManagedRemoteService | ||
为指定的命名操作设置 pageSize。 | ManagedRemoteService | ||
[覆盖]
为此 Managed Remoting 目标的第三方设置凭据。 | ManagedRemoteService | ||
将 MangedRemoteService 的实例表示为字符串,描述如目标 id 和所分配的通道集等重要属性。 | ManagedRemoteService |
事件 | 摘要 | 由以下参数定义 | ||
---|---|---|---|---|
如果在挂起的本地更改和其它客户端提交的更改之间检测到冲突,或者此客户端提交的更改与远程目标中的更改发生冲突,则调度 DataConflictEvent.CONFLICT 事件。 | ManagedRemoteService | |||
当由于错误而导致服务调用失败时,将调度 DataServiceFaultEvent.FAULT 事件。 | ManagedRemoteService | |||
当调用服务操作时,只要在通道尝试发送消息前没有引发错误,将调度 invoke 事件。 | AbstractService | |||
当远程目标推送数据操作的通知时,将调度 MessageEvent.MESSAGE 事件。 | ManagedRemoteService | |||
当服务调用成功返回时,将调度 ResultEvent.RESULT 事件。 | ManagedRemoteService |
concurrency | 属性 |
concurrency:String
语言版本: | ActionScript 3.0 |
产品版本: | Adobe Digital Enterprise Platform Data Services for Java EE 4.6 |
运行时版本: | Flash Player 10.2, AIR 2.6 |
指示如何处理对同一服务的多个调用的值。默认值为 multiple。允许使用的值包括:
- multiple — 不取消现有请求,由开发人员负责通过仔细管理事件流来确保返回数据的一致性。此为默认。
- single — 每次只允许在此方法中发出一个请求;在有请求未处理时在客户端上发出的其它请求会立即出错,而不会发送给服务器。
- last — 发出请求可导致客户端忽略任何当前未处理请求的结果或错误。仅在客户端上调度最新请求的结果或错误。这样可以简化客户端应用程序中的事件处理过程,但应该特别注意的是,只有在可以安全忽略请求的结果或错误时,才可使用此模式。
实现
public function get concurrency():String
public function set concurrency(value:String):void
convertParametersHandler | 属性 |
public var convertParametersHandler:Function
语言版本: | ActionScript 3.0 |
产品版本: | Adobe Digital Enterprise Platform Data Services for Java EE 4.6 |
运行时版本: | Flash Player 10.2, AIR 2.6 |
一个可选函数,主要供具有以下需要的框架开发人员使用:安装用传递给每个远程对象调用的参数进行调用的函数。该函数接受一个参数数组,并返回可能改变的数组。该函数定义应该如下所示: function myParametersFunction(parameters:Array):Array
convertResultHandler | 属性 |
public var convertResultHandler:Function
语言版本: | ActionScript 3.0 |
产品版本: | Adobe Digital Enterprise Platform Data Services for Java EE 4.6 |
运行时版本: | Flash Player 10.2, AIR 2.6 |
一个可选函数,主要供具有以下需要的框架开发人员使用:安装一个挂钩,以便在通知结果处理程序之前处理操作的结果。该函数定义应该如下所示: function myConvertResultsFunction(result: operation:AbstractOperation):
在 makeObjectsBindable 转换完成之后、创建结果事件之前向其传递结果。
destination | 属性 |
destination:String
[覆盖] 语言版本: | ActionScript 3.0 |
产品版本: | Adobe Digital Enterprise Platform Data Services for Java EE 4.6 |
运行时版本: | Flash Player 10.2, AIR 2.6 |
提供对 MessageAgent 的目标的访问。更改目标将断开 MessageAgent 的连接(如果当前已连接)。
实现
override public function get destination():String
override public function set destination(value:String):void
managers | 属性 |
showBusyCursor | 属性 |
throwItemPendingErrors | 属性 |
throwItemPendingErrors:Boolean
语言版本: | ActionScript 3.0 |
产品版本: | Adobe Digital Enterprise Platform Data Services for Java EE 4.6 |
运行时版本: | Flash Player 10.2, AIR 2.6 |
如果您要在访问延迟访存的数据或未分页的数据时禁止项挂起错误,请将此属性设置为 false
。将为 ArrayCollection 中的属性值或 getItemAt()
调用返回 null,而不是引发错误。
对于尚未从服务器中访存其大小的列表,size()
返回 0 个元素。当从服务器返回该元素时,将调度相应的 PropertyChangeEvent 和 CollectionEvent 事件。
实现
public function get throwItemPendingErrors():Boolean
public function set throwItemPendingErrors(value:Boolean):void
verifyEntityClasses | 属性 |
verifyEntityClasses:Boolean
语言版本: | ActionScript 3.0 |
产品版本: | Adobe Digital Enterprise Platform Data Services for Java EE 4.6 |
运行时版本: | Flash Player 10.2, AIR 2.6 |
如果为 true
,则请确认所有受管理实体是否存在。当服务初始化时,将验证由该服务指定的每个受管理实体以确保客户端中存在带有相应别名的类。如果客户端不使用该服务的所有受管理实体,且不希望在代码中链接未使用的类,可以将此值设置为 false
。默认值为 true
。
实现
public function get verifyEntityClasses():Boolean
public function set verifyEntityClasses(value:Boolean):void
ManagedRemoteService | () | 构造函数 |
addEventListener | () | 方法 |
override public function addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
语言版本: | ActionScript 3.0 |
产品版本: | Adobe Digital Enterprise Platform Data Services for Java EE 4.6 |
运行时版本: | Flash Player 10.2, AIR 2.6 |
向服务中添加事件侦听器。
参数
type:String — 事件的类型。
| |
listener:Function — 处理事件的侦听器函数。此函数必须接受 Event 对象作为其唯一的参数并且不能返回任何结果。
| |
useCapture:Boolean (default = false ) — 确定侦听器是运行于捕获阶段还是运行于目标和冒泡阶段。如果将 useCapture 设置为 true,则侦听器只在捕获阶段处理事件,而不在目标或冒泡阶段处理事件。如果 useCapture 为 false,则侦听器只在目标或冒泡阶段处理事件。要在所有三个阶段都侦听事件,请调用 addEventListener 两次:一次将 useCapture 设置为 true,一次将 useCapture 设置为 false。
| |
priority:int (default = 0 ) — 事件侦听器的优先级。优先级由一个带符号的 32 位整数指定。数字越大,优先级越高。优先级为 n 的所有侦听器会在优先级为 n-1 的侦听器之前得到处理。如果两个或更多个侦听器共享相同的优先级,则按照它们的添加顺序进行处理。默认优先级为 0。
| |
useWeakReference:Boolean (default = false ) — 确定对侦听器的引用是强引用,还是弱引用。强引用(默认值)可防止您的侦听器被当作垃圾回收。弱引用则没有此作用。
|
commitRequiredOn | () | 方法 |
public function commitRequiredOn(item:Object):Boolean
语言版本: | ActionScript 3.0 |
产品版本: | Adobe Digital Enterprise Platform Data Services for Java EE 4.6 |
运行时版本: | Flash Player 10.2, AIR 2.6 |
指示是否存在此特定对象的挂起更改。如果 ManagedRemoteService 未初始化(不管是通过调用操作还是显式调用 initialize()),此方法将始终返回 false。
参数
item:Object — 可能具有更改的对象。
|
Boolean — 如果对象具有挂起更改,则为 true 。
|
getOperation | () | 方法 |
override public function getOperation(name:String):AbstractOperation
语言版本: | ActionScript 3.0 |
产品版本: | Adobe Digital Enterprise Platform Data Services for Java EE 4.6 |
运行时版本: | Flash Player 10.2, AIR 2.6 |
返回给定名称的操作。如果之前没有创建该操作,则将在此调用过程中创建一个新的 mx.rpc.remoting.Operation
。通常只需在服务变量之后命名操作即可访问操作 (myService.someOperation
),但如果 Operation 的名称恰好与服务上所定义的方法(如 setCredentials
)相匹配,则可以改用此方法来获取 Operation。
参数
name:String — 操作的名称。
|
AbstractOperation — 为此名称执行的操作。
|
initializeService | () | 方法 |
public function initializeService():mx.rpc:AsyncToken
语言版本: | ActionScript 3.0 |
产品版本: | Adobe Digital Enterprise Platform Data Services for Java EE 4.6 |
运行时版本: | Flash Player 10.2, AIR 2.6 |
强制初始化受管理远程服务。成功时生成 ResultEvent,失败时生成 DataServiceFaultEvent。注意:请勿使用 initialize() 函数,因为此函数不会启动 ManagedRemoteService。
返回mx.rpc:AsyncToken |
logout | () | 方法 |
override public function logout():void
语言版本: | ActionScript 3.0 |
产品版本: | Adobe Digital Enterprise Platform Data Services for Java EE 4.6 |
运行时版本: | Flash Player 10.2, AIR 2.6 |
从服务目标中注销用户,并释放所有受管理集合和项目。与受管理远程服务相关联的所有 Data Services 也都调用 logout()。
releaseCollection | () | 方法 |
public function releaseCollection(view:ListCollectionView, clear:Boolean = false, copyStillManagedItems:Boolean = true):void
语言版本: | ActionScript 3.0 |
产品版本: | Adobe Digital Enterprise Platform Data Services for Java EE 4.6 |
运行时版本: | Flash Player 10.2, AIR 2.6 |
从基础 DataService 的管理中释放指定集合。(请参阅 DataService.releaseCollection() 以获得更多注释)
参数
view:ListCollectionView — 不再接收远程更新的 ListCollectionView 引用。
| |
clear:Boolean (default = false ) — 指示是否应删除列表中所有项的布尔值。此外,不会创建任何项的副本。
| |
copyStillManagedItems:Boolean (default = true ) — 布尔值,如果有对此集合中的项的其它受管理引用,则此参数控制是否创建这些项的副本,以便在此调用后,保证此集合中不再包含任何受管理项。如果将清除选项和此选项都指定为 false,则将以最快的方式释放托管引用。
|
releaseItem | () | 方法 |
public function releaseItem(item:IManaged, dontClearStillManagedItems:Boolean = true, copyStillManagedItems:Boolean = true):IManaged
语言版本: | ActionScript 3.0 |
产品版本: | Adobe Digital Enterprise Platform Data Services for Java EE 4.6 |
运行时版本: | Flash Player 10.2, AIR 2.6 |
从基础 DataService 的管理中释放指定项。(请参阅 DataService.releaseItem() 以获得更多注释)
参数
item:IManaged — 对要释放的项的 IManaged 引用。
| |
dontClearStillManagedItems:Boolean (default = true ) — 布尔值,指示如果在此释放后项仍由另一个集合或引用管理,是复制 (true) 还是清除 (false) 项。
| |
copyStillManagedItems:Boolean (default = true ) — 布尔值,指示是否应该为仍在对象图中管理的项创建副本。传递 false 值会保留对象图不作更改,即使图中的某些对象仍通过其它引用管理。
|
IManaged — 对已释放项的引用。如果 copyStillManagedItems 和 dontClearStillManagedItems 为 true 但仍引用项,则该引用可能是指定项的副本。如果对同一项多次调用 ManagedRemoteService.yourGetItemHere() ,或者调用 ManagedRemoteService.yourFillMethodHere() 后返回的集合引用此项,可能会出现这种情况。
|
removeEventListener | () | 方法 |
override public function removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void
语言版本: | ActionScript 3.0 |
产品版本: | Adobe Digital Enterprise Platform Data Services for Java EE 4.6 |
运行时版本: | Flash Player 10.2, AIR 2.6 |
从服务中删除指定侦听器。
参数
type:String — 事件的类型。
| |
listener:Function — 要删除的侦听器对象。
| |
useCapture:Boolean (default = false ) — 指出是为捕获阶段还是为目标和冒泡阶段注册了侦听器。如果为捕获阶段以及目标和冒泡阶段注册了侦听器,则需要对 removeEventListener() 进行两次调用才能将这两个侦听器删除,一次调用将 useCapture() 设置为 true,另一次调用将 useCapture() 设置为 false。
|
revertChanges | () | 方法 |
public function revertChanges(item:IManaged = null):Boolean
语言版本: | ActionScript 3.0 |
产品版本: | Adobe Digital Enterprise Platform Data Services for Java EE 4.6 |
运行时版本: | Flash Player 10.2, AIR 2.6 |
这会撤消对指定项的任何更改,并从缓存中删除这些更改。如果指定的项没有任何更改,则该方法会返回 false。如果指定的项发生更改,则它会将更改还原,并返回 true。如果 ManagedRemoteService 未初始化(不管是通过调用操作还是显式调用 initialize()),此方法将始终返回 false。
参数
item:IManaged (default = null ) — 还原更改的 IManaged 引用
|
Boolean — 布尔值,指示是否还原了对指定项所做的更改。
|
setCredentials | () | 方法 |
override public function setCredentials(username:String, password:String, charset:String = null):void
语言版本: | ActionScript 3.0 |
产品版本: | Adobe Digital Enterprise Platform Data Services for Java EE 4.6 |
运行时版本: | Flash Player 10.2, AIR 2.6 |
在服务器端使用 Managed Remoting 时,为服务访问的目标设置凭据。凭据适用于通过相同 ChannelSet 连接的所有服务。
参数
username:String — 目标的用户名。
| |
password:String — 目标的密码。
| |
charset:String (default = null ) — 对凭据进行编码时使用的字符集编码。默认值为 null,表示旧字符集 ISO-Latin-1。其它受支持的字符集仅有“UTF-8”。
|
setPageSizeForOperation | () | 方法 |
public function setPageSizeForOperation(operationName:String, pageSize:int):void
语言版本: | ActionScript 3.0 |
产品版本: | Adobe Digital Enterprise Platform Data Services for Java EE 4.6 |
运行时版本: | Flash Player 10.2, AIR 2.6 |
为指定的命名操作设置 pageSize。也可以通过直接访问操作来设置。操作是服务的动态属性,因此无法在 IDE 中访问
service.operationname.pageSize
参数
operationName:String — 操作的名称。
| |
pageSize:int — 要设置的页大小。
|
setRemoteCredentials | () | 方法 |
override public function setRemoteCredentials(remoteUsername:String, remotePassword:String, charset:String = null):void
语言版本: | ActionScript 3.0 |
产品版本: | Adobe Digital Enterprise Platform Data Services for Java EE 4.6 |
运行时版本: | Flash Player 10.2, AIR 2.6 |
为此 Managed Remoting 目标的第三方设置凭据。
参数
remoteUsername:String — 要传递给远程端点的用户名
| |
remotePassword:String — 要传递给远程端点的密码
| |
charset:String (default = null ) — 对远程凭据进行编码时使用的字符集编码。默认值为 null,表示旧字符集 ISO-Latin-1。其它受支持的字符集仅有“UTF-8”。
|
toString | () | 方法 |
conflict | 事件 |
mx.data.events.DataConflictEvent
属性 DataConflictEvent.type =
mx.data.events.DataConflictEvent.CONFLICT
语言版本: | ActionScript 3.0 |
产品版本: | Adobe Digital Enterprise Platform Data Services for Java EE 4.6 |
运行时版本: | Flash Player 10.2, AIR 2.6 |
如果在挂起的本地更改和其它客户端提交的更改之间检测到冲突,或者此客户端提交的更改与远程目标中的更改发生冲突,则调度 DataConflictEvent.CONFLICT
事件。每个 ManagedRemoteService 实例仅为此特定目标的项发送冲突事件。
CONFLICT
常量定义 conflict
事件的事件对象的 type
属性值。
事件对象的属性有下列值:
属性 | 值 |
---|---|
bubbles | false |
cancelable | false |
currentTarget | 用于定义处理该事件的事件侦听器的对象。例如,如果您使用 myButton.addEventListener() 注册某个事件侦听器,则 myButton 为 currentTarget 的值。 |
conflict | 保存发生的冲突的 Conflict 对象。 |
message | 与此事件相关联的 Message。 |
target | 调度该事件的 Object;它不一定是侦听该事件的 Object。使用 currentTarget 属性始终可以访问侦听事件的 Object。 |
fault | 事件 |
mx.data.events.DataServiceFaultEvent
属性 DataServiceFaultEvent.type =
mx.data.events.DataServiceFaultEvent.FAULT
语言版本: | ActionScript 3.0 |
产品版本: | Adobe Digital Enterprise Platform Data Services for Java EE 4.6 |
运行时版本: | Flash Player 10.2, AIR 2.6 |
当由于错误而导致服务调用失败时,将调度 DataServiceFaultEvent.FAULT
事件。
FAULT
常量定义 fault
事件的事件对象的 type
属性值。
事件对象的属性有下列值:
属性 | 值 |
---|---|
bubbles | false |
cancelable | true,通过关联标记的 responder.fault 方法调用 preventDefault() 将防止服务或操作调度此事件。 |
currentTarget | 用于定义处理该事件的事件侦听器的对象。例如,如果您使用 myButton.addEventListener() 注册某个事件侦听器,则 myButton 为 currentTarget 的值。 |
fault | 保存发生的冲突的 Fault 对象。 |
item | 生成错误的项。 |
identity | 生成错误的项的标识。 |
message | 与此事件相关联的 Message。 |
token | 表示方法调用的标记。用于异步完成标记模式。 |
target | 调度该事件的 Object;它不一定是侦听该事件的 Object。使用 currentTarget 属性始终可以访问侦听事件的 Object。 |
message | 事件 |
mx.messaging.events.MessageEvent
属性 MessageEvent.type =
mx.messaging.events.MessageEvent.MESSAGE
语言版本: | ActionScript 3.0 |
产品版本: | Adobe Digital Enterprise Platform Data Services for Java EE 4.6 |
运行时版本: | Flash Player 10.2, AIR 2.6 |
当远程目标推送数据操作的通知时,将调度 MessageEvent.MESSAGE
事件。例如,在远程目标上更新数据时,会将更新操作发送给所有正在侦听的客户端,然后在此 DataService 实例上将此操作转换为 message 事件。
此常量的值为 "message"
。
事件对象的属性有下列值:
属性 | 值 |
---|---|
bubbles | false |
cancelable | false |
currentTarget | 用于定义处理该事件的事件侦听器的对象。例如,如果您使用 myButton.addEventListener() 注册某个事件侦听器,则 myButton 为 currentTarget 的值。 |
message | 与此事件相关联的消息。 |
target | 调度该事件的 Object;它不一定是侦听该事件的 Object。使用 currentTarget 属性始终可以访问侦听事件的 Object。 |
result | 事件 |
mx.rpc.events.ResultEvent
属性 ResultEvent.type =
mx.rpc.events.ResultEvent.RESULT
语言版本: | ActionScript 3.0 |
产品版本: | Adobe Digital Enterprise Platform Data Services for Java EE 4.6 |
运行时版本: | Flash Player 10.2, AIR 2.6 |
当服务调用成功返回时,将调度 ResultEvent.RESULT
事件。例如,如果 fill()
方法调用成功,则该调用会调度此事件。
事件对象的属性有下列值:
属性 | 值 |
---|---|
bubbles | false |
cancelable | true,通过关联标记的 responder.result 方法调用 preventDefault() 将防止服务或操作调度此事件。 |
currentTarget | 用于定义处理该事件的事件侦听器的对象。例如,如果您使用 myButton.addEventListener() 注册某个事件侦听器,则 myButton 为 currentTarget 的值。 |
message | 与此事件相关联的 Message。 |
target | 调度该事件的 Object;它不一定是侦听该事件的 Object。使用 currentTarget 属性始终可以访问侦听事件的 Object。 |
result | RPC 调用返回的结果。 |
token | 表示对方法单独调用的标记。用于异步完成标记模式。 |
Tue Jun 12 2018, 11:04 AM Z