用于 Adobe® Flash® Platform 的 ActionScript® 3.0 参考
主页  |  隐藏包列表和类列表 |   |   |  新增内容  |  索引  |  附录  |  为什么显示为英语?
过滤条件: 正在从服务器检索数据...
正在从服务器检索数据...
mx.data 

DataManager  - AS3 ADEP Data Services

mx.data
public class DataManager
继承DataManager Inheritance Object
实现 IEventDispatcher
子类 DataService, RPCDataManager

语言版本: ActionScript 3.0
产品版本: Adobe Digital Enterprise Platform Data Services for Java EE 3
运行时版本: Flash Player 9, AIR 1.1

DataManager 类为特定数据类型的所有实例提供与服务器上的对象保持同步的功能。DataManager 提供同步、复制、冲突检测、更改跟踪和偶尔连接的服务。

DataManager 类是一个抽象类。通常,构造用于扩展 DataManager 的DataService 实例,或构造与 RPC 服务组件(如 HTTPMultiService、WebService 或 RemoteObject 实例)一起使用的一个或多个 RPCDataManager 实例。

要获得单一托管对象,可使用 DataManager.getItem()DataManager.createItem() 方法。

如果不再需要以前填充的 ArrayCollection,或者该集合中的项不再接收或创建更新,则调用 DataManager.releaseCollection() 方法。

当不再需要之前使用 DataManager.getItem()DataManager.createItem() 方法检索到的项,或相应项不应接收或创建更新时,调用 DataManager.releaseItem() 方法。DataManager.createItem()DataManager.getItem() 方法将返回一个 ItemReference 实例,您可以使用该实例来释放单个托管对象的特定实例。与 DataManager.releaseItem() 方法不同,调用 ItemReference.releaseItem() 方法将释放单个托管对象的特定实例。DataManager.releaseItem() 方法释放其根据匹配指定标识找到的第一个单个托管对象。只要调用 DataManager.getItem()DataManager.createItem() 方法的次数与调用 DataManager.releaseItem() 方法的次数匹配,这种方法就可行。

第一次调用任何需要连接的方法时,将自动创建到远程目标的连接。例如,如果存在未提交的更新时调用 DataManager.fill() 方法或 DataManager.commit() 方法,则 DataManager 实例会尝试建立到远程目标的连接。要强制断开 DataManager 实例的连接,请调用 DataManager.disconnect() 方法。可以使用 DataManager.disconnect() 方法来清理不再需要的远程目标资源。其它服务可能也使用同一物理连接,因此调用 DataManager.disconnect() 方法可能会终止此连接。

可绑定属性 connected 指示关联的 DataManager 连接的当前状态。

每个 DataManager 实例都具有 dataStore 属性,该属性可返回类型为 mx.data.DataStore 的对象。此对象存储一个或多个 DataManager 实例的未提交的更改。默认情况下,如果 DataManager 实例和其它 DataManager 实例管理了关联属性并共享同一组通道,则它们将共享同一个 DataStore 实例。共享 DataStore 实例时,针对一个 DataManager 实例调用 commit() 方法会使用共享 DataStore 实例提交对所有 DataManager 实例所做的更改。如果关联的 DataManager 实例中各个更改之间存在相关性,它会保留操作顺序。

DataManager 和 DataStore 为需要远程调用的所有操作调度 result 和 fault 事件。注意:如果您创建两个指向同一目标的 DataManager 实例,这两个实例将共享同一个托管对象集合,并调度同一组事件。例如,如果您为某个目标向一个 DataManager 实例中添加事件侦听器,但使用另一个实例启动操作,则第一个 DataManager 实例仍会收到这些事件。您在 DataManager 上启动的每个操作都会返回 AsyncToken。您可以为该标记添加事件响应器以接收特定于该操作的结果事件。此方法产生的代码通常比为给定目标全局添加一个结果或错误事件处理程序而产生的代码更简洁。

您可以针对 DataManager 实例的任何托管对象的属性使用数据绑定。当对任何托管对象执行远程操作时,DataManager 实例还会调度“message”事件。例如,当远程进程更新本地托管项时,将向仍然管理该项的所有 DataManager 实例推送消息。此消息作为 MessageEvent.MESSAGE 事件进行调度。

当远程目标响应 DataManager 实例提交的更改,或推送的更改与本地未提交的更改冲突时,检测到冲突即会调度冲突事件。可以通过侦听 DataConflictEvent.CONFLICT 来处理冲突事件。使用数据绑定,通过将用户界面控件绑定到 DataManager.conflicts.resolved 属性来更新这些控件。

DataManager 类支持下列数据同步配置模式:

  • autoCommit - 如果为 true,则每当检测到更改时就会立即将其发送到远程目标。如果为 false,则必须显式调用 commit() 方法。使用可绑定的 DataManager.commitRequired 属性来确定是否存在未提交的更改。
  • autoSyncEnabled - 这将影响所有 fill()getItem()createItem() 方法调用,并确定托管实例是否侦听由其它客户端或 DataServiceTransaction 服务器在远程目标上推送 API 对这些对象所做的更改。
  • autoMerge - 控制从远程目标收到的更改是立即应用,还是排队等候直至调用 DataManager.merge() 方法时再应用。

使用 DataManager.revertChanges () 方法来还原对特定项或所有项所做的更改。如果远程目标操作发生错误,则将已提交的更改放回到未提交的队列中,以使数据和远程目标上的数据保持同步。如果更改发生错误,在故障处理程序的处理过程中通常调用 DataManager.revertChanges() 方法来撤消更改。

相关 API 元素



公共属性
 属性由以下参数定义
  adapter : DataServiceAdapter = null
控制与服务器交互的类的实例。
DataManager
  autoCommit : Boolean
指示是否自动提交对本地缓存进行的更改。
DataManager
  autoConnect : Boolean
指示此服务是否应为需要连接的任何操作尝试连接。
DataManager
  autoMerge : Boolean
如果设置为 false,则当将更改从远程目标推送到客户端时不会立即应用。
DataManager
  autoSaveCache : Boolean
可以将数据和更改的本地缓存保存到磁盘中。
DataManager
  autoSyncEnabled : Boolean
如果为 true,fill()、createItem() 和 getItem() 请求将返回负责侦听对远程目标中的项进行的更新的项。
DataManager
  cacheID : String
提供对此服务的缓存标识的访问。
DataManager
  commitRequired : Boolean
[只读] 指示是否存在未提交的更改以及是否应该调用 commit() 方法。
DataManager
  conflictDetector : ConflictDetector
提供对当前实现的访问,此实现正用于检测推送到 DataManager 实例的远程操作的冲突。
DataManager
  conflicts : Conflicts
[只读] 包含 Conflicts 对象,即 Conflict 实例的 ArrayList。
DataManager
  connected : Boolean
[只读] 指示 DataService 是否已连接到远程目标。
DataManager
 Inheritedconstructor : Object
对类对象或给定对象实例的构造函数的引用。
Object
  dataStore : DataStore
包含一个 mx.data.DataStore 类型的对象。
DataManager
  deleteItemOnRemoveFromFill : Boolean
默认情况下,当您对托管填充集合调用 removeItemAt() 方法时,它会向服务器发出一个删除项调用以物理删除该项。
DataManager
  encryptLocalCache : Boolean
指示是否应为使用 SQL 脱机适配器的 AIR 客户端加密脱机存储。
DataManager
  fallBackToLocalFill : Boolean
此标志确定当应用程序断开连接时是否对本地存储进行查询。
DataManager
  hierarchicalEventsDefault : Boolean
关联选择性地列出关联实例属性上的属性更改事件。
DataManager
  ignoreCollectionUpdates : Boolean
指示是否忽略对托管集合所做的更改,而不针对提交与服务器通信。
DataManager
  indexReferences : Boolean
要调整应用程序的速度,如果您对此 DataManager 所管理的、其它项的关联属性中的项进行了少量的填充或引用,请将此属性设置为 false。
DataManager
  isInitialized : Boolean
[只读] 指示是否初始化与此 DataManager 实例相关联的元数据。
DataManager
  manualSync : ManualSyncConfiguration
为每个 DataManager 实例提供对 ManualSyncConfiguration 实例的访问。
DataManager
  maxFrequency : uint
确定 DataManager 实例可以每秒收到的最大消息数。
DataManager
  mergeRequired : Boolean
[只读] 指示是否存在必须合并的挂起更改。
DataManager
  offlineAdapter : DataServiceOfflineAdapter
返回一个 mx.data.DataServiceOfflineAdapter 类型的对象。
DataManager
  pageSize : int
提供对所有集合的当前页面大小设置的访问。
DataManager
  pagingEnabled : Boolean
[只读] 指示是否将远程目标配置为允许分页请求。
DataManager
  priority : int
DataManager 实例发送的消息的默认消息优先级。
DataManager
  requestTimeout : int
提供对操作的请求超时(以秒为单位)的访问。
DataManager
  resetCollectionOnFill : Boolean
如果属性为 true,则在 fill 操作完成后,将发送 RESET 事件。
DataManager
  resubscribeAttempts : int
控制已断开连接的 DataManager 实例尝试重新订阅目标的次数。
DataManager
  resubscribeInterval : int
控制重新订阅尝试之间的延迟(以毫秒为单位)。
DataManager
  saveCacheRequired : Boolean
[只读] 指示是否存在尚未保存至本地缓存的更改,以及是否应该调用 saveCache() 方法。
DataManager
  subscribed : Boolean
[只读] 指示 DataManager 实例是否已订阅到远程目标。
DataManager
  throwItemPendingErrors : Boolean
如果您要在访问松散访存的数据或未分页的数据时禁止项挂起错误,请将此属性设置为 false。
DataManager
公共方法
 方法由以下参数定义
  
使用指定目标构造 DataService 的实例。
DataManager
  
清除以前调用 saveCache() 方法或将 autoSaveCache 方法设置为 true 时存储到磁盘中的所有数据
DataManager
  
清除由从本地存储传递的描述符指定的数据。
DataManager
  
commit(itemsOrCollections:Array = null, cascadeCommit:Boolean = false):mx.rpc:AsyncToken
提交当前由与此 DataManager 实例关联的 DataStore 实例管理的所有集合的挂起更改。
DataManager
  
指示是否存在此特定对象的挂起更改。
DataManager
  
强制此服务尝试连接到远程目标。
DataManager
  
调用远程目标上的计数方法。
DataManager
  
请求在远程存储中创建指定项。
DataManager
  
请求从远程存储中删除指定项。
DataManager
  
断开 DataManager 实例的网络连接。
DataManager
  
executeQuery(queryName:String, propertySpecifier:PropertySpecifier, ... args):mx.rpc:AsyncToken
使用提供的名称和自变量执行查询。
DataManager
  
根据目标的关联 fill 方法填充指定的 ListCollectionView(集合)实例。
DataManager
  
根据目标的关联 fill 方法填充指定的 ListCollectionView(集合)实例。
DataManager
  
findItem(queryName:String, propertySpecifier:PropertySpecifier, ... args):mx.rpc:AsyncToken
执行一个返回单个项的查询。
DataManager
  
返回本地存储中的 ArrayCollection 或单个托管对象。
DataManager
  
使用 CacheDataDescriptor 实例填充指定的 ListCollectionView(集合)实例。
DataManager
  
使用之前在应用程序中使用的所有缓存标识符来填充指定的 ListCollectionView(集合)实例。
DataManager
  
getItem(identity:Object, defaultValue:Object = null):ItemReference
对与指定标识匹配的项发出异步请求。
DataManager
  
使用给定的标识查找所提供的项。
DataManager
  
返回指定集合的页面信息。
DataManager
  
返回消息缓存中针对指定项的挂起操作。
DataManager
 Inherited
表示对象是否已经定义了指定的属性。
Object
  
强制初始化 DataStore。
DataManager
  
如果传递的集合由此服务管理,则返回 true。
DataManager
  
如果传递的集合要使用分页功能,则返回 true。
DataManager
 Inherited
表示 Object 类的实例是否在指定为参数的对象的原型链中。
Object
  
isRangeResident(view:ListCollectionView, startIndex:int, numberOfItems:int):Boolean
如果将提供的项范围全部页入,则返回 true。
DataManager
  
根据关联的 <fill-method> 元素基于本地存储上的数据填充指定的 ListCollectionView。
DataManager
  
将所有挂起更新合并到托管对象集中。
DataManager
 Inherited
表示指定的属性是否存在、是否可枚举。
Object
  
刷新由此 DataManager 实例管理的所有数据。
DataManager
  
刷新先前使用 fill 方法填充或作为托管关联进行管理的集合。
DataManager
  
release(clear:Boolean = true, copyStillManagedItems:Boolean = true):void
释放 DataManager 实例的所有托管集合和项。
DataManager
  
releaseCollection(view:ListCollectionView, clear:Boolean = false, copyStillManagedItems:Boolean = true):void
使指定集合中的所有项脱离此 DataManager 实例的管理。
DataManager
  
releaseItem(item:IManaged, copyStillManagedItems:Boolean = true, enableStillManagedCheck:Boolean = true):IManaged
使指定的项脱离此 DataManager 实例的管理。
DataManager
  
releaseItemsFromCollection(collection:ListCollectionView, startIndex:int, numberOfItems:int):int
释放集合中的一系列项。
DataManager
  
释放单值关联的值。
DataManager
  
还原对指定项进行的所有未提交的更改。
DataManager
  
还原指定集合中包含的、应由此 DataManager 实例管理的所有项的更改。
DataManager
  
此方法保存当前状态的 DataManager 实例缓存。
DataManager
  
指示是否存在对此特定对象所做的未保存至本地缓存的暂挂更改。
DataManager
 Inherited
设置循环操作动态属性的可用性。
Object
  
获取之前在此数据服务(数据管理器)上执行的所有填充的已更改项。
DataManager
  
[静态] 允许所有本地数据的同步的简便方法:针对每个数据服务(数据管理器)调用 synchronizeAllFills(),以便仅当所有单个 synchronizeAllFills() 调用完成后,才完成最终结果标记。
DataManager
  
获取上一次调用 fill 或 synchronizeFill 后在服务器上更改的已更改项。
DataManager
 Inherited
返回此对象的字符串表示形式,其格式设置遵守区域设置特定的约定。
Object
 Inherited
返回指定对象的字符串表示形式。
Object
  
updateItem(item:Object, origItem:Object = null, changes:Array = null):mx.rpc:AsyncToken
触发指定项目的更新。
DataManager
 Inherited
返回指定对象的原始值。
Object
受保护的方法
 方法由以下参数定义
  
如果尚未初始化此数据管理器,则使故障排队。
DataManager
事件
 事件 摘要 由以下参数定义
  如果在挂起的本地更改和其它客户端提交的更改之间检测到冲突,或者此客户端提交的更改与远程目标中的更改发生冲突,则调度 DataConflictEvent.CONFLICT 事件。DataManager
  当由于错误而导致服务调用失败时,将调度 DataManagerFaultEvent.FAULT 事件。DataManager
  当远程目标推送数据操作的通知时,将调度 MessageEvent.MESSAGE 事件。DataManager
  此服务的属性发生更改时,将调度 PropertyChangeEvent.PROPERTY_CHANGE 事件。DataManager
  当服务调用成功返回时,将调度 ResultEvent.RESULT 事件。DataManager
属性详细信息

adapter

属性
public var adapter:DataServiceAdapter = null

语言版本: ActionScript 3.0
产品版本: Adobe Digital Enterprise Platform Data Services for Java EE 3
运行时版本: Flash Player 9, AIR 1.1

控制与服务器交互的类的实例。

autoCommit

属性 
autoCommit:Boolean

语言版本: ActionScript 3.0
产品版本: Adobe Digital Enterprise Platform Data Services for Java EE 3
运行时版本: Flash Player 9, AIR 1.1

指示是否自动提交对本地缓存进行的更改。已提交的更改将立即发送到远程服务。

对于 DataService 实例,即用于服务器端 Data Management Service 的数据管理器,默认值为 true。

对于 RPCDataManager 实例,即向 RPC 服务组件(如 RemoteObject、HTTPMultiService 和 WebService)提供客户端数据管理功能的数据管理器,默认值为 false。



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

autoConnect

属性 
autoConnect:Boolean

语言版本: ActionScript 3.0
产品版本: Adobe Digital Enterprise Platform Data Services for Java EE 3
运行时版本: Flash Player 9, AIR 1.1

指示此服务是否应为需要连接的任何操作尝试连接。如果该服务断开连接并且 autoConnect 设置为 true,则 fill()getItem()count() 等操作将尝试连接。使用此属性可以控制偶尔连接的应用程序行为。

默认值为 true。



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

autoMerge

属性 
autoMerge:Boolean

语言版本: ActionScript 3.0
产品版本: Adobe Digital Enterprise Platform Data Services for Java EE 3
运行时版本: Flash Player 9, AIR 1.1

如果设置为 false,则当将更改从远程目标推送到客户端时不会立即应用。相反,mergeRequired 属性设置为 true。

可以注册事件处理程序来侦听此属性的更改事件,以在需要应用合并时获得通知。

若要合并更改,可调用 merge() 方法,会应用所有更改。

如果存在任何需要合并的更改,则不能提交未提交的更改。

如果启用分页,在调用 merge() 之前将缓存非本地项的所有请求。调用 merge() 后将处理缓存的请求。

默认值为 true。



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

autoSaveCache

属性 
autoSaveCache:Boolean

语言版本: ActionScript 3.0
产品版本: Adobe Digital Enterprise Platform Data Services for Java EE 3
运行时版本: Flash Player 9, AIR 1.1

可以将数据和更改的本地缓存保存到磁盘中。如果 autoSaveCache 属性为 true,每次进行更改或返回远程请求时,数据都会保存到磁盘中。如果由于磁盘已满或写入权限被拒绝而在保存数据时遇到问题,则调度 FaultEvent 或引发 Fault

将此值设置为 false(默认值),则不会将任何数据或更改保存到磁盘。要强制将当前数据和更改保存到磁盘中,可使用 saveCache() 方法。

默认值为 false。



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

相关 API 元素

autoSyncEnabled

属性 
autoSyncEnabled:Boolean

语言版本: ActionScript 3.0
产品版本: Adobe Digital Enterprise Platform Data Services for Java EE 3
运行时版本: Flash Player 9, AIR 1.1

如果为 truefill()createItem()getItem() 请求将返回负责侦听对远程目标中的项进行的更新的项。如果更改此属性值,则只影响将来对这些方法的调用,而不会影响现有集合或项。

另请注意,如果将使用 autoSyncEnabled 检索到的集合和未使用 autoSyncEnabled 填充的组合放在一起,则同时出现在这两种集合中的项仍会接收更新事件。

默认值为 true。



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

cacheID

属性 
cacheID:String

语言版本: ActionScript 3.0
产品版本: Adobe Digital Enterprise Platform Data Services for Java EE 3
运行时版本: Flash Player 9, AIR 1.1

提供对此服务的缓存标识的访问。在执行任何要求与本地磁盘中存储的数据进行交互的操作之前,必须先设置缓存标识。如果未设置缓存标识,则认为并非所有缓存方法和属性都一致,而且在执行任何需要本地磁盘数据的操作期间会引发 DataServiceError。此属性为本地存储的数据提供唯一“会话”标识。开发人员必须将此属性设置为应用程序的唯一值。

null 值或空字符串表示未进行设置。如果已设置 cacheIDfill()getItem() 等方法提出的数据请求将尝试首先访问磁盘上的本地数据。如果设置 cacheID,将不会尝试访问任何本地数据。



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

commitRequired

属性 
commitRequired:Boolean  [只读]

语言版本: ActionScript 3.0
产品版本: Adobe Digital Enterprise Platform Data Services for Java EE 3
运行时版本: Flash Player 9, AIR 1.1

指示是否存在未提交的更改以及是否应该调用 commit() 方法。如果此属性发生更改,则会调度事件。可以在应用程序中使用此属性来提供可视反馈。

此属性可用作数据绑定的源。修改此属性后,将调度 propertyChange 事件。



实现
    public function get commitRequired():Boolean

conflictDetector

属性 
conflictDetector:ConflictDetector

语言版本: ActionScript 3.0
产品版本: Adobe Digital Enterprise Platform Data Services for Java EE 3
运行时版本: Flash Player 9, AIR 1.1

提供对当前实现的访问,此实现正用于检测推送到 DataManager 实例的远程操作的冲突。



实现
    public function get conflictDetector():ConflictDetector
    public function set conflictDetector(value:ConflictDetector):void

conflicts

属性 
conflicts:Conflicts  [只读]

语言版本: ActionScript 3.0
产品版本: Adobe Digital Enterprise Platform Data Services for Java EE 3
运行时版本: Flash Player 9, AIR 1.1

包含 Conflicts 对象,即 Conflict 实例的 ArrayList。

必须解决冲突才能调用 commit() 方法。要解决冲突,可以遍历冲突并单独解决每个冲突,或对此属性调用 acceptAllClient() 方法或 acceptAllServer() 方法。

此属性可用作数据绑定的源。修改此属性后,将调度 propertyChange 事件。



实现
    public function get conflicts():Conflicts

connected

属性 
connected:Boolean  [只读]

语言版本: ActionScript 3.0
产品版本: Adobe Digital Enterprise Platform Data Services for Java EE 3
运行时版本: Flash Player 9, AIR 1.1

指示 DataService 是否已连接到远程目标。

此属性可用作数据绑定的源。修改此属性后,将调度 propertyChange 事件。



实现
    public function get connected():Boolean

dataStore

属性 
dataStore:DataStore

语言版本: ActionScript 3.0
产品版本: Adobe Digital Enterprise Platform Data Services for Java EE 3
运行时版本: Flash Player 9, AIR 1.1

包含一个 mx.data.DataStore 类型的对象。DataStore 实例为一个或多个 DataManager 实例(相互之间可以进行引用)管理一组传入和传出更改。提交 DataStore 时,会提交每个使用该 DataStore 的 DataManager 的所有挂起更改。

默认情况下,如果 DataManager 实例和其它 DataManager 实例管理了关联属性并共享同一组通道,则它们将共享同一个 DataStore。如果您正在共享 DataStore,则对一个 DataManager 的 commit 调用将提交对使用该数据存储的所有 DataManager 的更改。如果未提交的批次中的更改之间存在相关性,这会保留操作顺序。

此属性可用作数据绑定的源。修改此属性后,将调度 propertyChange 事件。



实现
    public function get dataStore():DataStore
    public function set dataStore(value:DataStore):void

deleteItemOnRemoveFromFill

属性 
deleteItemOnRemoveFromFill:Boolean

语言版本: ActionScript 3.0
产品版本: Adobe Digital Enterprise Platform Data Services for Java EE 3
运行时版本: Flash Player 9, AIR 1.1

默认情况下,当您对托管填充集合调用 removeItemAt() 方法时,它会向服务器发出一个删除项调用以物理删除该项。这允许您使用以同样的方式使用托管集合和非托管集合的代码。但在其它情况下,您可能希望将项从客户端的集合中移除,而不是将其从服务器中删除。在这种情况下,请在调用 removeItemAt() 方法前将此标志设置为 false

请注意,这不会影响关联的集合。只会影响用于 fill() 方法的集合。

默认值为 true。



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

encryptLocalCache

属性 
encryptLocalCache:Boolean

语言版本: ActionScript 3.0
产品版本: Adobe Digital Enterprise Platform Data Services for Java EE 3.1
运行时版本: Flash Player 9, AIR 1.5

指示是否应为使用 SQL 脱机适配器的 AIR 客户端加密脱机存储。

对于基于浏览器的 Flex 客户端,无法加密脱机数据。



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

fallBackToLocalFill

属性 
fallBackToLocalFill:Boolean

语言版本: ActionScript 3.0
产品版本: Adobe Digital Enterprise Platform Data Services for Java EE 3.1
运行时版本: Flash Player 9, AIR 1.1

此标志确定当应用程序断开连接时是否对本地存储进行查询。默认情况下,当将脱机适配器配置为支持动态查询执行时,调用 fill() 方法不会在应用程序断开连接时查询本地存储。如果 fallBackToLocalFill 设置为 true,则即使应用程序断开连接也查询本地存储。

此属性可用作数据绑定的源。修改此属性后,将调度 propertyChange 事件。



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

hierarchicalEventsDefault

属性 
hierarchicalEventsDefault:Boolean

语言版本: ActionScript 3.0
产品版本: Adobe Digital Enterprise Platform Data Services for Java EE 3
运行时版本: Flash Player 9, AIR 1.1

关联选择性地列出关联实例属性上的属性更改事件。您可以在与 hierarchical-events 配置属性关联时对此进行设置。如果不设置 hierarchical-events 属性,特定目标的关联将使用此属性确定默认值。

默认值为 false。对于树(而不是循环图形)中的对象,为简便起见,您可能希望为目标将此项设置为 true。例如,如果使用项呈示器中属性的属性,则为该关联属性将此项设置为 true 会导致网格在属性的这些属性发生更改时刷新。系统有能力避免发送递归事件或创建大型事件链,例如 parent.child[0].child[1].child[3]。

默认值为 false。



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

ignoreCollectionUpdates

属性 
ignoreCollectionUpdates:Boolean

语言版本: ActionScript 3.0
产品版本: Adobe Digital Enterprise Platform Data Services for Java EE 3.1
运行时版本: Flash Player 9, AIR 1.5

指示是否忽略对托管集合所做的更改,而不针对提交与服务器通信。

默认值为 false。



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

indexReferences

属性 
indexReferences:Boolean

语言版本: ActionScript 3.0
产品版本: Adobe Digital Enterprise Platform Data Services for Java EE 3
运行时版本: Flash Player 9, AIR 1.1

要调整应用程序的速度,如果您对此 DataManager 所管理的、其它项的关联属性中的项进行了少量的填充或引用,请将此属性设置为 false



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

isInitialized

属性 
isInitialized:Boolean  [只读]

语言版本: ActionScript 3.0
产品版本: Adobe Digital Enterprise Platform Data Services for Java EE 3
运行时版本: Flash Player 9, AIR 1.1

指示是否初始化与此 DataManager 实例相关联的元数据。

此属性可用作数据绑定的源。修改此属性后,将调度 propertyChange 事件。



实现
    public function get isInitialized():Boolean

manualSync

属性 
manualSync:ManualSyncConfiguration

语言版本: ActionScript 3.0
产品版本: Adobe Digital Enterprise Platform Data Services for Java EE 3
运行时版本: Flash Player 9, AIR 1.1

为每个 DataManager 实例提供对 ManualSyncConfiguration 实例的访问。使用 ManualSyncConfiguration 类,可以订阅由其它客户端进行的更改或服务器上的更改,还可以控制如何将更改发布到使用此接口订阅的其它客户端。



实现
    public function get manualSync():ManualSyncConfiguration
    public function set manualSync(value:ManualSyncConfiguration):void

maxFrequency

属性 
maxFrequency:uint

语言版本: ActionScript 3.0
产品版本: Adobe Digital Enterprise Platform Data Services for Java EE 3
运行时版本: Flash Player 9, AIR 1.1

确定 DataManager 实例可以每秒收到的最大消息数。理解此值的服务器将使用此值确定向 DataManager 发送消息的速度。

默认值为 0,表示 DataManager 没有消息速度首选项。请注意,应在 DataManager 订阅之前设置此属性,在订阅后所做的任何更改直到 DatManager 取消订阅并重新订阅后才会生效。

默认值为 0。



实现
    public function get maxFrequency():uint
    public function set maxFrequency(value:uint):void

mergeRequired

属性 
mergeRequired:Boolean  [只读]

语言版本: ActionScript 3.0
产品版本: Adobe Digital Enterprise Platform Data Services for Java EE 3
运行时版本: Flash Player 9, AIR 1.1

指示是否存在必须合并的挂起更改。

此属性可用作数据绑定的源。修改此属性后,将调度 propertyChange 事件。



实现
    public function get mergeRequired():Boolean

offlineAdapter

属性 
offlineAdapter:DataServiceOfflineAdapter

语言版本: ActionScript 3.0
产品版本: Adobe Digital Enterprise Platform Data Services for Java EE 3.1
运行时版本: Flash Player 9, AIR 1.1

返回一个 mx.data.DataServiceOfflineAdapter 类型的对象。脱机适配器控制针对如何在本地存储 (SQLLite/LSO) 上持久保存对象的实现。



实现
    public function get offlineAdapter():DataServiceOfflineAdapter
    public function set offlineAdapter(value:DataServiceOfflineAdapter):void

pageSize

属性 
pageSize:int

语言版本: ActionScript 3.0
产品版本: Adobe Digital Enterprise Platform Data Services for Java EE 3
运行时版本: Flash Player 9, AIR 1.1

提供对所有集合的当前页面大小设置的访问。



实现
    public function get pageSize():int
    public function set pageSize(value:int):void

pagingEnabled

属性 
pagingEnabled:Boolean  [只读]

语言版本: ActionScript 3.0
产品版本: Adobe Digital Enterprise Platform Data Services for Java EE 3
运行时版本: Flash Player 9, AIR 1.1

指示是否将远程目标配置为允许分页请求。



实现
    public function get pagingEnabled():Boolean

priority

属性 
priority:int

语言版本: ActionScript 3.0
产品版本: Adobe Digital Enterprise Platform Data Services for Java EE 3
运行时版本: Flash Player 9, AIR 1.1

DataManager 实例发送的消息的默认消息优先级。有效值为 0 到 9(0 表示最低优先级),值 -1 表示 DataManager 实例未设置优先级。请注意,如果已为消息定义了优先级,则所定义的优先级优先于此优先级。



实现
    public function get priority():int
    public function set priority(value:int):void

requestTimeout

属性 
requestTimeout:int

语言版本: ActionScript 3.0
产品版本: Adobe Digital Enterprise Platform Data Services for Java EE 3
运行时版本: Flash Player 9, AIR 1.1

提供对操作的请求超时(以秒为单位)的访问。如果值小于 0 或等于 0,则可阻止请求超时的发生。如果当前操作由于达到了 requestTimeout 限制而超时,则会为该操作调度 fault 事件,表明请求已超时。请注意,有时虽然操作发生超时,服务器实际上仍收到了该操作。这就使得客户端状态与服务器不同步。



实现
    public function get requestTimeout():int
    public function set requestTimeout(value:int):void

resetCollectionOnFill

属性 
resetCollectionOnFill:Boolean

语言版本: ActionScript 3.0
产品版本: Adobe Digital Enterprise Platform Data Services for Java EE 3
运行时版本: Flash Player 9, AIR 1.1

如果属性为 true,则在 fill 操作完成后,会发送 RESET 事件。如果此属性为 false,对 fill 结果返回的每个项仅发送增量 ADD/REMOVE 事件。设置此属性会影响您发起的所有填充操作。在开始填充后进行更改不会影响未完成的填充行为。

默认值为 true。



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

resubscribeAttempts

属性 
resubscribeAttempts:int

语言版本: ActionScript 3.0
产品版本: Adobe Digital Enterprise Platform Data Services for Java EE 3
运行时版本: Flash Player 9, AIR 1.1

控制已断开连接的 DataManager 实例尝试重新订阅目标的次数。默认值 -1 表示在客户端能够重新连接前不断进行重新订阅。

默认值为 -1。



实现
    public function get resubscribeAttempts():int
    public function set resubscribeAttempts(value:int):void

resubscribeInterval

属性 
resubscribeInterval:int

语言版本: ActionScript 3.0
产品版本: Adobe Digital Enterprise Platform Data Services for Java EE 3
运行时版本: Flash Player 9, AIR 1.1

控制重新订阅尝试之间的延迟(以毫秒为单位)。默认值为 5000,意味着每 5 秒尝试重新订阅一次。

默认值为 5000。



实现
    public function get resubscribeInterval():int
    public function set resubscribeInterval(value:int):void

saveCacheRequired

属性 
saveCacheRequired:Boolean  [只读]

语言版本: ActionScript 3.0
产品版本: Adobe Digital Enterprise Platform Data Services for Java EE 4.5
运行时版本: Flash Player 9, AIR 1.1

指示是否存在尚未保存至本地缓存的更改,以及是否应该调用 saveCache() 方法。commitRequired 应该返回 true 时,此方法可能返回 false,指示更改已保存至本地缓存,但未提交到服务器。

此属性可用作数据绑定的源。修改此属性后,将调度 propertyChange 事件。



实现
    public function get saveCacheRequired():Boolean

subscribed

属性 
subscribed:Boolean  [只读]

语言版本: ActionScript 3.0
产品版本: Adobe Digital Enterprise Platform Data Services for Java EE 3
运行时版本: Flash Player 9, AIR 1.1

指示 DataManager 实例是否已订阅到远程目标。

此属性可用作数据绑定的源。修改此属性后,将调度 propertyChange 事件。



实现
    public function get subscribed():Boolean

throwItemPendingErrors

属性 
throwItemPendingErrors:Boolean

语言版本: ActionScript 3.0
产品版本: Adobe Digital Enterprise Platform Data Services for Java EE 3
运行时版本: Flash Player 9, AIR 1.1

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

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



实现
    public function get throwItemPendingErrors():Boolean
    public function set throwItemPendingErrors(value:Boolean):void
构造函数详细信息

DataManager

()构造函数
public function DataManager()

语言版本: ActionScript 3.0
产品版本: Adobe Digital Enterprise Platform Data Services for Java EE 3
运行时版本: Flash Player 9, AIR 1.1

使用指定目标构造 DataService 的实例。目标必须是对在 services-config.xml 文件中配置的目标的引用。

方法详细信息

checkImplementation

()方法
protected function checkImplementation():void

语言版本: ActionScript 3.0
产品版本: Adobe Digital Enterprise Platform Data Services for Java EE 3
运行时版本: Flash Player 9, AIR 1.1

如果尚未初始化此数据管理器,则使故障排队。

clearCache

()方法 
public function clearCache(value:Object = null):mx.rpc:AsyncToken

语言版本: ActionScript 3.0
产品版本: Adobe Digital Enterprise Platform Data Services for Java EE 3
运行时版本: Flash Player 9, AIR 1.1

清除以前调用 saveCache() 方法或将 autoSaveCache 方法设置为 true 时存储到磁盘中的所有数据

参数

value:Object (default = null) — 对托管的单一对象或 ArrayCollection 的对象引用。

返回
mx.rpc:AsyncToken — 可用于响应操作成功或失败的 AsyncToken。

clearCacheData

()方法 
public function clearCacheData(descriptor:CacheDataDescriptor):mx.rpc:AsyncToken

语言版本: ActionScript 3.0
产品版本: Adobe Digital Enterprise Platform Data Services for Java EE 3
运行时版本: Flash Player 9, AIR 1.1

清除由从本地存储传递的描述符指定的数据。

参数

descriptor:CacheDataDescriptor — 对要从本地缓存中删除的数据描述符的引用。

返回
mx.rpc:AsyncToken — 对标记的引用,该标记可用于确定此操作何时产生结果或发生错误。

commit

()方法 
public function commit(itemsOrCollections:Array = null, cascadeCommit:Boolean = false):mx.rpc:AsyncToken

语言版本: ActionScript 3.0
产品版本: Adobe Digital Enterprise Platform Data Services for Java EE 3
运行时版本: Flash Player 9, AIR 1.1

提交当前由与此 DataManager 实例关联的 DataStore 实例管理的所有集合的挂起更改。调用此方法等同于调用 dataStore.commit() 方法。

如果 autoCommit 属性为 true,则不会使用事务,并且不需要调用此方法。要使用事务,请将 autoCommit 属性设置为 false,然后直接调用此方法以提交一批更改。

通常,只需调用不包含参数的 commit(),即可提交所有挂起的更改。可以提供可选的自变量来提交挂起更改的子集。必须首先解决所有未解决的冲突,然后才能提交对 DataStore 中的任何项所做的更改。

如果组装器配置为将 use-transactions 设置为 true,则会自动提交所有更改。如果任一操作失败,则不会应用该批次中的任何操作。如果将 use-transactions 设置为 false,则单独提交各个操作,直到发生失败(此时处理将停止)为止。将应用出错之前发生的任何更改,但不会应用出错之后发生的任何更改。如果在处理某个批次时出现错误,则将更改放回到未提交的队列中。如果要删除导致错误的更改,则需要调用 revertChanges。

默认情况下,commit 方法将提交已为此 DataStore 创建、修改和删除的所有项的所有挂起更改。如果要提交这些更改的子集,则可以指定托管 ArrayCollection 实例和/或托管项的组合,以定义要在该批次中包含的更改子集。对于指定的各个数组集合,无论是更改其中项的成员身份或顺序,还是更改其中的项,都会提交相应的更改。您还可以指定各个托管项的列表,以便只提交对这些项进行的更改。如果在 itemsOrCollections 参数中指定了任何不是托管集合或托管项的对象,则会引发 DataServiceError。

如果使用 itemsOrCollections 参数,并且您的项具有引用其它项的关联属性,则可以使用 cascadeCommit 参数控制是否也在该批次中包含对关联项进行的更改。例如,如果在项参数中指定了一个 Group 项,并且 Group 实例具有一个在 cascadeCommit 为 true 时引用 Person 实例列表的成员属性,则对任何 Person 实例的更改也将包含在提交的更改集中。如果 cascadeCommit 为 false,则只包含对 Group 进行的更改。使用 cascadeCommit=true 可确保该批次中包含所有相关更改。

参数

itemsOrCollections:Array (default = null) — 这是一个可选参数,该参数在您希望提交所有挂起更改时默认为 null。如果要提交挂起更改的子集,可使用此自变量指定托管 ListCollectionView 实例和/或托管项的列表。ListCollectionView 对象通常是您提供给 fill-method 的 ArrayCollection。适用于此方法的项是该项的任何托管版本。这些项是从 getItem、createItem 中或使用 getItemAt 方法从托管集合中检索到的任何项。将仅提交由此数组中的任意值定义的项的更改。
 
cascadeCommit:Boolean (default = false) — 如果为 true,则还会提交对此列表中提供的所有关联项所做的更改。

返回
mx.rpc:AsyncTokenResultEvent.RESULTFaultEvent.FAULTcall 属性中返回的 AsyncToken。可将定制数据附着到此对象,稍后在事件处理阶段再对其进行检查。如果没有对相关项进行任何更改,则返回 null 而不是 AsyncToken。

引发
Error — 如果正在进行初始化。如果在初始化此服务之前引用运行时目标并调用 commit,或设置了 cacheID 但尚未加载本地缓存,则可能会发生这种情况。在上述每种情况下,等待从要初始化的调用或以前的操作返回的标记获得结果或发生错误后再调用 commit,可避免这种错误的发生。

commitRequiredOn

()方法 
public function commitRequiredOn(object:Object):Boolean

语言版本: ActionScript 3.0
产品版本: Adobe Digital Enterprise Platform Data Services for Java EE 3.1
运行时版本: Flash Player 9, AIR 1.1

指示是否存在此特定对象的挂起更改。允许在 UI 上启用粒度。(请参阅针对通知的可绑定属性的 commitRequired。)

参数

object:Object — 可能具有更改的对象。

返回
Boolean — 如果对象具有挂起更改,则为 true

connect

()方法 
public function connect():mx.rpc:AsyncToken

语言版本: ActionScript 3.0
产品版本: Adobe Digital Enterprise Platform Data Services for Java EE 3
运行时版本: Flash Player 9, AIR 1.1

强制此服务尝试连接到远程目标。此方法可与 autoConnect 属性和 disconnect() 方法一起使用来控制连接状态。

返回
mx.rpc:AsyncToken — 对标记的 AsyncToken 引用,该标记将在从此服务调度的结果或错误事件中标识此操作。调用 connect() 时,将始终调用标记的结果处理程序,并且结果将是此服务的 connected 属性的当前值。

count

()方法 
public function count(... args):mx.rpc:AsyncToken

语言版本: ActionScript 3.0
产品版本: Adobe Digital Enterprise Platform Data Services for Java EE 3
运行时版本: Flash Player 9, AIR 1.1

调用远程目标上的计数方法。调用的计数方法基于关联的 <count-method> 标记和传递的参数。例如,如果执行以下 count("firstName", "Bob" ) 调用,并且存在 <count-method> 标记或在关联目标下的 services-config.xml 中引用这些标记:

            <count-method>
                <name>getCount</name>
                <params>java.lang.String,java.lang.String</params>
                <security-run-as name="freddie" password="nightmare" />
            </count-method>
     
            <count-method>
                <name>getCount</name>
                <security-constraint ref="sample-users" />
            </count-method>
      
调用第一个安全设置为“run-as”的 <count-method>,因为它包含两个与 <params> 标记类型和计数匹配的参数。

参数

... args — 应传递给远程目标的自变量列表。

返回
mx.rpc:AsyncTokenResultEvent.RESULTFaultEvent.FAULT 中的 call 属性返回的对象。可将定制数据附着到此对象,稍后在事件处理阶段再对其进行检查。

相关 API 元素

createItem

()方法 
public function createItem(item:Object):ItemReference

语言版本: ActionScript 3.0
产品版本: Adobe Digital Enterprise Platform Data Services for Java EE 3
运行时版本: Flash Player 9, AIR 1.1

请求在远程存储中创建指定项。如果出现错误,则调度 DataConflictEvent 事件。

参数

item:Object — 应在远程存储中创建的对象。

返回
ItemReference — ItemReference(用于扩展 AsyncToken)。在 ResultEvent.RESULTFaultEvent.FAULT 中的 token 属性中会返回此引用。可将定制数据附着到此对象,稍后在事件处理阶段再对其进行检查。此对象的 result 属性可绑定,并可用于绑定返回的项。如果已从另一客户端中删除了该项,则此 result 对象将设置为 null。如果在应用程序中保留 ItemReference 对象,则应在结束此次对项的引用时调用 ItemReference 实例中的 releaseItem() 方法。如果不保留 ItemReference 实例,则可以针对 DataManager 实例使用 releaseItem() 方法,该方法将自行释放项实例。如果 createItem() 失败,则返回一个错误。但是,该项仍处于挂起状态。必须调用 release() 才能将其删除。

deleteItem

()方法 
public function deleteItem(item:Object):mx.rpc:AsyncToken

语言版本: ActionScript 3.0
产品版本: Adobe Digital Enterprise Platform Data Services for Java EE 3
运行时版本: Flash Player 9, AIR 1.1

请求从远程存储中删除指定项。如果出现错误,则调度 DataConflictEvent 事件。

参数

item:Object — 应在远程存储中删除的对象。

返回
mx.rpc:AsyncToken — 将在 ResultEvent.RESULTFaultEvent.FAULT 中的 token 属性中返回的 AsyncToken。可将定制数据附着到此对象,稍后在事件处理阶段再对其进行检查。

disconnect

()方法 
public function disconnect():void

语言版本: ActionScript 3.0
产品版本: Adobe Digital Enterprise Platform Data Services for Java EE 3
运行时版本: Flash Player 9, AIR 1.1

断开 DataManager 实例的网络连接。此方法不会等待未完成的网络操作完成。

executeQuery

()方法 
public function executeQuery(queryName:String, propertySpecifier:PropertySpecifier, ... args):mx.rpc:AsyncToken

语言版本: ActionScript 3.0
产品版本: Adobe Digital Enterprise Platform Data Services for Java EE 3
运行时版本: Flash Player 9, AIR 1.1

使用提供的名称和自变量执行查询。通常将此方法与 RPCDataManager 实例一起使用,其中查询具有特定名称。只要 fill-method 的第一个参数是字符串值,还可以将此方法与使用更常用的 fill-method 方法定义的查询一起使用。queryName 用作第一个 fill 参数。

请注意,在结束此方法返回的对象时,应为集合结果调用 releaseCollection() 方法或为单一值项结果调用 releaseItem。或者,您可以通过调用 release() 方法释放从该 DataManager 实例中检索到的所有托管引用。

调用 refreshCollection() 方法刷新此方法返回的所有集合的内容。

参数

queryName:String — 要调用的操作的名称。
 
propertySpecifier:PropertySpecifier — 要检索的属性集。
 
... args — 查询的参数列表。

返回
mx.rpc:AsyncToken — AsyncToken 绑定到 AsyncToken 的 result 属性以检索结果。否则,您可以侦听 result 属性更改事件,向标记添加一个或多个响应器,以及添加其它信息作为标记的动态属性,以跟踪操作结果。

fill

()方法 
public function fill(value:ListCollectionView, ... args):mx.rpc:AsyncToken

语言版本: ActionScript 3.0
产品版本: Adobe Digital Enterprise Platform Data Services for Java EE 3
运行时版本: Flash Player 9, AIR 1.1

根据目标的关联 fill 方法填充指定的 ListCollectionView(集合)实例。例如,对于使用 Hibernate 组装器的 LiveCycle Data Services 目标,fill() 方法的第一个参数为要填充的集合,第二个参数为要执行的 Hibernate 查询,其它所有参数都是 Hibernate 查询参数。对于模型驱动的开发,此相同格式应用于在服务包装器类中使用的 fill()

下例显示了使用 Hibernate 组装器的目标的 fill() 方法。组装器具有名为 getByDescription 的查询及其名为 description 的查询参数。

     ProductService.fill(ac, "getByDescription", description);
     

对于使用 fill-method 方法(在其中声明目标配置中 XML 元素中的 fill 方法)的 LiveCycle Data Services 目标,如果在目标配置中有以下 <fill-method> 元素:

            <fill-method>
                <name>loadPersons</name>
                <params>java.lang.String,java.lang.String</params>
            </fill-method>
     
            <fill-method>
                <name>loadPersons</name>
                <security-constraint ref="sample-users" />
            </fill-method>
      
则调用 fill(myCollection, "firstName", "Bob") 将调用第一个 <fill-method>,因为它包含两个与 <params> 标记类型和计数匹配的参数。同样,调用 fill(myCollection) 将调用第二个 <fill-method> 标记,因为它不包含 <params> 标记。

将删除对此集合中项的所有挂起更改。请注意,当您调用 fill 时,将清除此集合中的所有数据。您也可以使用先前填充的集合调用 fill。在这种情况下,如果 fill 参数相同,将清除此集合并再次调用服务器上的 fill 方法。如果 fill 参数不同,则释放旧集合并填充新集合。

参数

value:ListCollectionView — 对应使用指定的自变量填充的集合的引用。
 
... args — 应传递给远程目标的自变量的变量列表。

返回
mx.rpc:AsyncToken — AsyncToken 您可以使用此标记注册一个或多个回调函数来从此 fill 操作中检索 result 或 fault 事件。ResultEvent.RESULTcall 属性中或 FaultEvent.FAULT 中也会返回此标记。可将定制数据附着到此对象,稍后在事件处理阶段再对其进行检查。

fillSubset

()方法 
public function fillSubset(value:ListCollectionView, ps:PropertySpecifier, ... args):mx.rpc:AsyncToken

语言版本: ActionScript 3.0
产品版本: Adobe Digital Enterprise Platform Data Services for Java EE 3
运行时版本: Flash Player 9, AIR 1.1

根据目标的关联 fill 方法填充指定的 ListCollectionView(集合)实例。仅会在每个对象上填充属性的一个子集,由 propertySpecifier 参数指定。

参数

value:ListCollectionView — 对应使用指定的自变量填充的集合的引用。
 
ps:PropertySpecifier — 要传递给服务器的填充实现的 PropertySpecifier 对象,用于指定应该在每个项目上填充属性的哪个子集。
 
... args — 应传递给远程目标的自变量的变量列表。

返回
mx.rpc:AsyncToken — AsyncToken 您可以使用此标记注册一个或多个回调函数来从此 fill 操作中检索 result 或 fault 事件。ResultEvent.RESULTcall 属性中或 FaultEvent.FAULT 中也会返回此标记。可将定制数据附着到此对象,稍后在事件处理阶段再对其进行检查。

findItem

()方法 
public function findItem(queryName:String, propertySpecifier:PropertySpecifier, ... args):mx.rpc:AsyncToken

语言版本: ActionScript 3.0
产品版本: Adobe Digital Enterprise Platform Data Services for Java EE 3
运行时版本: Flash Player 9, AIR 1.1

执行一个返回单个项的查询。

参数

queryName:String — 要调用的操作的名称。
 
propertySpecifier:PropertySpecifier — 要检索的属性集。
 
... args — 查询的参数列表。

返回
mx.rpc:AsyncToken — AsyncToken 绑定到 AsyncToken 的 result 属性以检索结果。否则,您可以侦听 result 属性更改事件,向标记添加一个或多个响应器,以及添加其它信息作为标记的动态属性,以跟踪操作结果。

getCacheData

()方法 
public function getCacheData(descriptor:CacheDataDescriptor):mx.rpc:AsyncToken

语言版本: ActionScript 3.0
产品版本: Adobe Digital Enterprise Platform Data Services for Java EE 3
运行时版本: Flash Player 9, AIR 1.1

返回本地存储中的 ArrayCollection 或单个托管对象。调用此方法不会更新上次访问时间。

参数

descriptor:CacheDataDescriptor — 所需缓存数据的 CacheDataDescriptor。

返回
mx.rpc:AsyncToken — 对标记的 AsyncToken 引用,可用于确定此操作何时产生结果或发生错误。AsyncToken 或关联事件上的 result 属性将包含每个调用中未托管的 ArrayCollection 或 ItemReference 的新实例。

getCacheDescriptors

()方法 
public function getCacheDescriptors(view:ListCollectionView, options:uint = 0, item:Object = null):mx.rpc:AsyncToken

语言版本: ActionScript 3.0
产品版本: Adobe Digital Enterprise Platform Data Services for Java EE 3
运行时版本: Flash Player 9, AIR 1.1

使用 CacheDataDescriptor 实例填充指定的 ListCollectionView(集合)实例。如果未指定任何参数,则返回此服务下缓存的数据的所有关联的 CacheDataDescriptor 实例。

参数

view:ListCollectionView — 对可使用所需描述符填充的集合的 ListCollectionView 引用。
 
options:uint (default = 0) — 必须是下列常量之一:
  • CacheDataDescriptor.FILL — 指示应在集合中仅返回填充集合的描述符。
  • CacheDataDescriptor.ITEM — 指示应在集合中仅返回托管项的描述符。
  • CacheDataDescriptor.ALL — [默认] 指示应返回所有描述符。
 
item:Object (default = null) — 当指定此参数覆盖选项自变量时,对特定 ItemReference、托管项或 ListCollectionView 的对象引用。

返回
mx.rpc:AsyncToken — 对标记的 AsyncToken 引用,该标记将在从此服务调度的结果或错误事件中标识此操作。

getCacheIDs

()方法 
public function getCacheIDs(view:ListCollectionView):mx.rpc:AsyncToken

语言版本: ActionScript 3.0
产品版本: Adobe Digital Enterprise Platform Data Services for Java EE 3
运行时版本: Flash Player 9, AIR 1.1

使用之前在应用程序中使用的所有缓存标识符来填充指定的 ListCollectionView(集合)实例。

参数

view:ListCollectionView — 对特定集合的 ListcollectionView 引用,该集合应使用先前在应用程序中使用的所有缓存标识进行填充。

返回
mx.rpc:AsyncToken — 对标记的 AsyncToken 引用,该标记将在从此服务调度的结果或错误事件中标识此操作。

getItem

()方法 
public function getItem(identity:Object, defaultValue:Object = null):ItemReference

语言版本: ActionScript 3.0
产品版本: Adobe Digital Enterprise Platform Data Services for Java EE 3
运行时版本: Flash Player 9, AIR 1.1

对与指定标识匹配的项发出异步请求。如果您提供了一个 defaultValue,但该项不存在,则将创建该项,而不是使用 defaultValue 中的信息。此方法返回 ItemReference 实例。如果从 getItem() 方法调用收到有效实例,则必须调用 releaseItem() 方法来释放该项的实例。如果保留 ItemReference 实例,则应针对该引用调用 releaseItem() 方法以确保释放的是正确的引用,以防您的客户端已对相同项执行了多次 getItem () 方法调用。如果不保留 ItemReference 实例,您可以使项自身来针对 DataManager 调用 releaseItem() 方法。

参数

identity:Object — 包含所需对象的标识属性的对象。
 
defaultValue:Object (default = null) — 具有默认值的类型实例,如果不存在实例,则应进行创建。

返回
ItemReference — 要获取的项的 ItemReference 实例。ItemReference 实例扩展 AsyncToken,因此您可以用它来接收何时检索此项或此调用何时产生故障的通知。如果您正在侦听 DataManager 实例上的事件,则 ItemReference 实例将作为 ResultEvent.RESULTFaultEvent.FAULT 中的 token 属性返回。可将定制数据附着到此对象,稍后在事件处理阶段再对其进行检查。您也可以使用数据绑定来绑定到 ItemReference 实例的 result 属性。当从远程目标填充项且项可绑定时,此属性将设置为有效值,因此您可以直接将您的用户界面控件绑定到 ItemReference 的 result 属性中的属性。如果从服务器或另一客户端中删除此项,则此引用将设置为 null。ItemReference 同样具有 invalid 属性,如果返回项时出错或服务器为某项返回 null,则该属性将设置为 true

getLocalItem

()方法 
public function getLocalItem(identity:Object):Object

语言版本: ActionScript 3.0
产品版本: Adobe Digital Enterprise Platform Data Services for Java EE 3
运行时版本: Flash Player 9, AIR 1.1

使用给定的标识查找所提供的项。如果此客户端上已托管该项,则返回托管实例。否则,返回 null。与调用 getItem 方法不同,此调用不会向服务器提出请求,也不向此项中添加其它引用。

参数

identity:Object — 包含所需对象的标识属性的对象。

返回
Object — 对象,返回托管对象,如果此客户端上尚未托管使用此标识的项,则返回 null。

getPageInformation

()方法 
public function getPageInformation(view:ListCollectionView):PageInformation

语言版本: ActionScript 3.0
产品版本: Adobe Digital Enterprise Platform Data Services for Java EE 3
运行时版本: Flash Player 9, AIR 1.1

返回指定集合的页面信息。

参数

view:ListCollectionView — 针对的集合。

返回
PageInformation — 指定集合的页面信息。

getPendingOperation

()方法 
public function getPendingOperation(item:Object):uint

语言版本: ActionScript 3.0
产品版本: Adobe Digital Enterprise Platform Data Services for Java EE 3
运行时版本: Flash Player 9, AIR 1.1

返回消息缓存中针对指定项的挂起操作。使用此方法为用户提供有关已对项进行了哪些类型的更改(如果有)的可视反馈。

参数

item:Object — 应该根据其进行测试的 IManaged 对象。

返回
uint — 指示已执行了哪些挂起操作的 uint。以下是对项执行的有效操作:
  • DataMessage.CREATE_OPERATION — 指示为指定项挂起创建操作。
  • DataMessage.DELETE_OPERATION — 指示为指定项挂起删除操作。
  • DataMessage.UPDATE_OPERATION — 指示为指定项挂起更新操作。
  • DataMessage.UNKNOWN_OPERATION — 指示不为指定项挂起任何操作。

initialize

()方法 
public function initialize():mx.rpc:AsyncToken

语言版本: ActionScript 3.0
产品版本: Adobe Digital Enterprise Platform Data Services for Java EE 3
运行时版本: Flash Player 9, AIR 1.1

强制初始化 DataStore。

返回
mx.rpc:AsyncToken — 对标记的 AsyncToken 引用,该标记将在从此服务调度的结果或错误事件中标识此操作。

isCollectionManaged

()方法 
public function isCollectionManaged(view:ListCollectionView):Boolean

语言版本: ActionScript 3.0
产品版本: Adobe Digital Enterprise Platform Data Services for Java EE 3
运行时版本: Flash Player 9, AIR 1.1

如果传递的集合由此服务管理,则返回 true。如果集合由此服务托管,则将该集合传递给 releaseCollection() 以将其从管理中释放会非常安全。

参数

view:ListCollectionView — 用于测试它是否由此服务管理的 ListCollectionView 引用。

返回
Boolean — 如果集合由此服务托管,则返回 ture;否则,返回 false。

isCollectionPaged

()方法 
public function isCollectionPaged(view:ListCollectionView):Boolean

语言版本: ActionScript 3.0
产品版本: Adobe Digital Enterprise Platform Data Services for Java EE 3
运行时版本: Flash Player 9, AIR 1.1

如果传递的集合要使用分页功能,则返回 true。如果该集合由此服务分页,则将集合传递给 releaseItemsFromCollection() 以从管理中释放集合中的各个项会非常安全。

参数

view:ListCollectionView — 用于测试它是否由此服务管理的 ListCollectionView 引用。

返回
Boolean — 如果集合使用分页功能,则返回 true;否则,返回 false。

isRangeResident

()方法 
public function isRangeResident(view:ListCollectionView, startIndex:int, numberOfItems:int):Boolean

语言版本: ActionScript 3.0
产品版本: Adobe Digital Enterprise Platform Data Services for Java EE 3
运行时版本: Flash Player 9, AIR 1.1

如果将提供的项范围全部页入,则返回 true。否则,返回 false。

参数

view:ListCollectionView — 由此数据服务管理的 ListCollectionView。
 
startIndex:int — ListCollectionView 中的起始索引。
 
numberOfItems:int — ListCollectionView 中的项目数。

返回
Boolean — 如果此集合中的所有项都常驻,则返回 true;如果提供的范围内有任何项不常驻,则返回 false

localFill

()方法 
public function localFill(value:ListCollectionView, ps:PropertySpecifier, ... args):mx.rpc:AsyncToken

语言版本: ActionScript 3.0
产品版本: Adobe Digital Enterprise Platform Data Services for Java EE 3
运行时版本: Flash Player 9, AIR 1.1

根据关联的 <fill-method> 元素基于本地存储上的数据填充指定的 ListCollectionView。将调用 offlineAdapter.executeOfflineQuery() API 来查询数据,并且即使连接了应用程序也不会查询远程目标。理想的使用方法是在客户端上同步数据并对客户端进行本地查询。

参数

value:ListCollectionView — 对应使用指定的自变量填充的集合的引用。
 
ps:PropertySpecifier — 要传递给脱机适配器的 PropertySpecifier 对象,用于指定应该在每个项目上填充的属性子集。
 
... args — 应传递给脱机适配器的参数的 args:Array 变量列表。

返回
mx.rpc:AsyncToken — AsyncToken 您可以使用此标记注册一个或多个回调函数来从此本地 fill 操作中检索 result 或 fault 事件。ResultEvent.RESULTcall 属性中或 FaultEvent.FAULT 中也会返回此标记。

merge

()方法 
public function merge():void

语言版本: ActionScript 3.0
产品版本: Adobe Digital Enterprise Platform Data Services for Java EE 3
运行时版本: Flash Player 9, AIR 1.1

将所有挂起更新合并到托管对象集中。合并更改过程将检测冲突并处理所有挂起的项请求。这将合并共享此 DataStore 实例的任何其它 DataManager 实例的所有消息。

refresh

()方法 
public function refresh():mx.rpc:AsyncToken

语言版本: ActionScript 3.0
产品版本: Adobe Digital Enterprise Platform Data Services for Java EE 3
运行时版本: Flash Player 9, AIR 1.1

刷新由此 DataManager 实例管理的所有数据。对服务器进行填充、获取项请求和页面请求,以重新访存所有托管项。调用 DataStore.refresh() 方法也可刷新惰性为 true 关联的所有关联项。

返回
mx.rpc:AsyncToken — AsyncToken 您可以使用此标记为刷新操作的 result 或 fault 事件注册一个或多个回调函数。

refreshCollection

()方法 
public function refreshCollection(value:ListCollectionView):mx.rpc:AsyncToken

语言版本: ActionScript 3.0
产品版本: Adobe Digital Enterprise Platform Data Services for Java EE 3
运行时版本: Flash Player 9, AIR 1.1

刷新先前使用 fill 方法填充或作为托管关联进行管理的集合。此方法向服务器提出请求,使用先前与此集合一起使用的 fill 参数或通过访存父代中的属性来访存集合中任何常驻项的新版本。如果发现任何更改,会将它们以增量方式合并到集合中。

参数

value:ListCollectionView — 受此 DataManager 实例管理的 ListCollectionView。

返回
mx.rpc:AsyncToken — AsyncToken 您可以使用此标记注册一个或多个回调函数来检索此刷新操作中的 result 或 fault 事件。如果分页集合中没有需要刷新的对象,则返回 null。ResultEvent.RESULTcall 属性中或 FaultEvent.FAULT 中也会返回此标记。可将定制数据附着到此对象,稍后在事件处理阶段再对其进行检查。

release

()方法 
public function release(clear:Boolean = true, copyStillManagedItems:Boolean = true):void

语言版本: ActionScript 3.0
产品版本: Adobe Digital Enterprise Platform Data Services for Java EE 3
运行时版本: Flash Player 9, AIR 1.1

释放 DataManager 实例的所有托管集合和项。

参数

clear:Boolean (default = true) — 指示是否应删除列表中所有项的布尔值。此外,不会创建任何项的副本。
 
copyStillManagedItems:Boolean (default = true) — 如果释放此数据服务后,来自其它数据服务的托管关联的引用可能会保留对其中某些托管对象的引用。在这种情况下,仍可以主动管理此数据服务中的某些托管集合。如果为此标志传递 true,将删除 (clear=true) 或克隆 (clear=flase) 这些引用。如果为此标志传入 false,则保留那些活动引用。使用 false 是清除系统状态的最快捷的方法。使用 true 可确保对从此数据服务检索到的集合或项的引用中不存在任何托管状态。

相关 API 元素

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 3
运行时版本: Flash Player 9, AIR 1.1

使指定集合中的所有项脱离此 DataManager 实例的管理。如果项存在于多个集合中,则创建该项的副本。会释放对仅存在于此集合中的项所做的任何未提交更改,包括删除、创建和更新。

参数

view:ListCollectionView — 不再接收远程更新的 ListCollectionView 引用。
 
clear:Boolean (default = false) — 指示是否应删除列表中的所有项。此外,不会创建任何项的副本。
 
copyStillManagedItems:Boolean (default = true) — 指示如果此集合中存在对项的其它托管引用,则此参数将控制是否创建这些项的副本,以便执行此调用后,可以向您保证该集合中不再包含任何托管项。如果将清除选项和此选项都指定为 false,则将以最快的方式释放托管引用。

releaseItem

()方法 
public function releaseItem(item:IManaged, copyStillManagedItems:Boolean = true, enableStillManagedCheck:Boolean = true):IManaged

语言版本: ActionScript 3.0
产品版本: Adobe Digital Enterprise Platform Data Services for Java EE 3
运行时版本: Flash Player 9, AIR 1.1

使指定的项脱离此 DataManager 实例的管理。如果保留到 ItemReference 实例,那么当您可能已执行多个 getItem() 调用,而这些调用从客户 应用程序的不同部分检索相同的项时,应针对 ItemReference 实例调用 releaseItem() 方法,以确保释放正确的引用。

此调用释放所有关联的资源,包括嵌套属性。指定项不再从远程目标接收更新。此外,如果存在对此项进行的任何未提交的更改,且该项没有出现在任何其它集合中,这些更改也会被释放。如果指定项存在于多个集合中,除非将 allowCopy 参数设置为 false,否则返回的值将是原始项的副本。

参数

item:IManaged — 对要释放的项的 IManaged 引用。
 
copyStillManagedItems:Boolean (default = true) — 布尔值,指示是否要为仍在对象图中管理的项创建副本。传递 false 值将清除对这些项的引用。
 
enableStillManagedCheck:Boolean (default = true) — 为此参数传递一个 false 值,以禁用仍处于托管中的项的复制或清除。这种情况下您的返回值将始终是您释放的原始托管值,并且如果另一个引用仍在使用该项,则即使在该释放之后,它仍将继续被托管。

返回
IManaged — 释放的项,如果 copyStillManagedItemsfalse 且此项由其它引用管理,则释放的项是一个副本。

releaseItemsFromCollection

()方法 
public function releaseItemsFromCollection(collection:ListCollectionView, startIndex:int, numberOfItems:int):int

语言版本: ActionScript 3.0
产品版本: Adobe Digital Enterprise Platform Data Services for Java EE 3
运行时版本: Flash Player 9, AIR 1.1

释放集合中的一系列项。在大型集合中分页时,您可能希望释放被集合中的项占用的资源并停止订阅这些项的更新。指定希望释放的第一个项的 startIndex 和要释放的项数。如果尚未对该位置上的项进行分页,则跳过该索引。

参数

collection:ListCollectionView — 托管的 ListCollectionView。
 
startIndex:int — 要释放的第一个项的索引。
 
numberOfItems:int — 从指定的第一个项处开始的要释放的项数。numberOfItems 应大于 0,startIndex + numberOfItems 应小于 collection.length。

返回
int — 释放的引用数。

releaseReference

()方法 
public function releaseReference(item:Object, propName:String):Boolean

语言版本: ActionScript 3.0
产品版本: Adobe Digital Enterprise Platform Data Services for Java EE 3
运行时版本: Flash Player 9, AIR 1.1

释放单值关联的值。如果该值未页入,则返回 false。如果该值页入,则释放该引用并返回 true。如果这是对特定项目的最后一个引用,则下次尝试访问该项目时将导致出现 ItemPendingError,并再次访存该值。

参数

item:Object — 包含单值关联属性的父项。
 
propName:String — 引用单值关联的属性的名称。

返回
Boolean — 如果已释放该值,则为 true。

revertChanges

()方法 
public function revertChanges(item:IManaged = null):Boolean

语言版本: ActionScript 3.0
产品版本: Adobe Digital Enterprise Platform Data Services for Java EE 3
运行时版本: Flash Player 9, AIR 1.1

还原对指定项进行的所有未提交的更改。或者,如果没有提供任何项,则还原所有未提交的更改。如果还原创建操作,则会删除此项。如果还原删除操作,则会重新添加已删除的项。还原更新将复原开始更改项之前设置的项原始属性。调用此方法等同于调用 dataStore.revertChanges() 方法。

使用此方法的一种情况是在出现错误后。在这种情况下,任何失败的更改都将回置到未提交的更改列表中。此时,您可以修改这些更改以解决问题,或使用此方法进行还原以阻止重新提交这些更改。

如果提供了一个项,但该项不包含任何更改,则此方法返回 false。如果没有提供任何项且没有进行任何更改,则此方法将返回 false。否则,将返回 true。

参数

item:IManaged (default = null) — 用于还原更改的引用,或者为 null(还原所有更改)。

返回
Boolean — 指示是否已还原所有更改的布尔值。

revertChangesForCollection

()方法 
public function revertChangesForCollection(collection:ListCollectionView = null):Boolean

语言版本: ActionScript 3.0
产品版本: Adobe Digital Enterprise Platform Data Services for Java EE 3
运行时版本: Flash Player 9, AIR 1.1

还原指定集合中包含的、应由此 DataManager 实例管理的所有项的更改。

参数

collection:ListCollectionView (default = null) — 要还原的集合。

返回
Boolean — 如果还原了所有更改,则返回布尔值 true。

saveCache

()方法 
public function saveCache(value:Object = null):mx.rpc:AsyncToken

语言版本: ActionScript 3.0
产品版本: Adobe Digital Enterprise Platform Data Services for Java EE 3
运行时版本: Flash Player 9, AIR 1.1

此方法保存当前状态的 DataManager 实例缓存。缓存包括内存项和对项所做的尚未发送到远程目标的更改。

参数

value:Object (default = null) — 对托管 ListCollectionView 实例或对象的对象引用。

返回
mx.rpc:AsyncToken — AsyncToken,用于通知操作成功完成或失败的时间。

相关 API 元素

autoSaveCache

示例  ( 如何使用本示例 )
         var customerService:DataService = new DataService("customers");
         var customers:ArrayCollection = new ArrayCollection();
         customerService.fill(customers);
         // ...
         var customer:Customer = Customer(customers[0]);
         customer.priority = "top";
         customerService.saveCache();
         // now all of the changes and items in the customers collection
         // will be persisted locally
      

saveCacheRequiredOn

()方法 
public function saveCacheRequiredOn(object:Object):Boolean

语言版本: ActionScript 3.0
产品版本: Adobe Digital Enterprise Platform Data Services for Java EE 4.5
运行时版本: Flash Player 9, AIR 1.1

指示是否存在对此特定对象所做的未保存至本地缓存的暂挂更改。comitRequiredOn 应该返回 true 时,此方法可能返回 false,指示更改已保存至本地缓存,但未提交到服务器。

参数

object:Object — 可能具有更改的对象。

返回
Boolean — 如果对象具有挂起更改,则为 true

synchronizeAllFills

()方法 
public function synchronizeAllFills():mx.rpc:AsyncToken

语言版本: ActionScript 3.0
产品版本: Adobe Digital Enterprise Platform Data Services for Java EE 4.5
运行时版本: Flash Player 10.1, AIR 2.0

获取之前在此数据服务(数据管理器)上执行的所有填充的已更改项。

返回
mx.rpc:AsyncToken — AsyncToken 您可以使用此标记注册一个或多个回调函数来从此操作中检索 result 或 fault 事件。

synchronizeDataServices

()方法 
public static function synchronizeDataServices(services:Array):mx.rpc:AsyncToken

语言版本: ActionScript 3.0
产品版本: Adobe Digital Enterprise Platform Data Services for Java EE 4.5
运行时版本: Flash Player 10.1, AIR 2.0

允许所有本地数据的同步的简便方法:针对每个数据服务(数据管理器)调用 synchronizeAllFills(),以便仅当所有单个 synchronizeAllFills() 调用完成后,才完成最终结果标记。

参数

services:Array — 要同步的数据服务的数组。

返回
mx.rpc:AsyncToken — AsyncToken 您可以使用此标记注册一个或多个回调函数来从此操作中检索 result 或 fault 事件。

synchronizeFill

()方法 
public function synchronizeFill(... fillArgs):mx.rpc:AsyncToken

语言版本: ActionScript 3.0
产品版本: Adobe Digital Enterprise Platform Data Services for Java EE 4.5
运行时版本: Flash Player 10.1, AIR 2.0

获取上一次调用 fill 或 synchronizeFill 后在服务器上更改的已更改项。这包含已创建的项、已更新的项和已删除的项。如果之前没有执行过填充,这等效于第一次执行填充。

参数

... fillArgs — fillArgs fill 的参数。

返回
mx.rpc:AsyncToken — AsyncToken 您可以使用此标记注册一个或多个回调函数来从此 fill 操作中检索 result 或 fault 事件。ChangedItems 实例用作传递至结果处理函数的 ResultEvent 中的结果对象,用于描述返回的已更改项。

updateItem

()方法 
public function updateItem(item:Object, origItem:Object = null, changes:Array = null):mx.rpc:AsyncToken

语言版本: ActionScript 3.0
产品版本: Adobe Digital Enterprise Platform Data Services for Java EE 3
运行时版本: Flash Player 9, AIR 1.1

触发指定项目的更新。如果使用托管实例调用此方法,则它将提交已对该项所做的任何更改,并返回一个可以用于跟踪这些更改的标记。如果不存在对该项目的挂起更改,则返回一个 null 标记。如果您使用该实例的另一个副本调用此方法,则它会将更改数组中的所有已更改属性复制到记录任何更改的托管实例,然后提交这些更改。如果 autoCommit 设置为 true,则会立即提交对此项的更改。如果设置为 false,则排队等候,直到调用 commit() 方法后再提交所做的更改。

参数

item:Object — 要更新的项。
 
origItem:Object (default = null) — 在进行更改之前项的版本。此版本用于冲突检测。可能为 null。
 
changes:Array (default = null) — 已进行更新的属性名称数组。用于性能改进。可能为 null。

返回
mx.rpc:AsyncToken — 可用于跟踪更改的某个 AsyncToken(例如,当提交对此项的更改时,会交付一个 fault 或 result 事件)。如果不存在对项目的任何更改,则返回 null AsyncToken,且不对任何内容排队。
事件详细信息

conflict

事件
事件对象类型: mx.data.events.DataConflictEvent
属性 DataConflictEvent.type = mx.data.events.DataConflictEvent.CONFLICT

语言版本: ActionScript 3.0
产品版本: Adobe Digital Enterprise Platform Data Services for Java EE 3
运行时版本: Flash Player 9, AIR 1.1

如果在挂起的本地更改和其它客户端提交的更改之间检测到冲突,或者此客户端提交的更改与远程目标中的更改发生冲突,则调度 DataConflictEvent.CONFLICT 事件。每个 DataService 仅为此特定目标的项发送冲突事件。如果您需要同时为一组相关目标处理冲突,请使用 DataService 上的冲突事件。

CONFLICT 常量定义 conflict 事件的事件对象的 type 属性值。

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

属性
bubblesfalse
cancelablefalse
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 3
运行时版本: Flash Player 9, AIR 1.1

当由于错误而导致服务调用失败时,将调度 DataManagerFaultEvent.FAULT 事件。例如,如果 fill() 方法调用失败,则该调用会调度此事件。对于在提交结果中生成错误的各个项,也会获得此事件。在这种情况下,DataServiceFaultEvent 将包含 commit 返回的标记,但是错误中的项和错误消息字符串特定于导致该错误的项。

FAULT 常量定义 fault 事件的事件对象的 type 属性值。

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

属性
bubblesfalse
cancelabletrue,通过关联标记的 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 3
运行时版本: Flash Player 9, AIR 1.1

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

MESSAGE 事件类型;当收到消息时调度。

此常量的值为 "message"

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

属性
bubblesfalse
cancelablefalse
currentTarget用于定义处理该事件的事件侦听器的对象。例如,如果您使用 myButton.addEventListener() 注册某个事件侦听器,则 myButton 为 currentTarget 的值。
message与此事件相关联的消息。
target调度该事件的 Object;它不一定是侦听该事件的 Object。使用 currentTarget 属性始终可以访问侦听事件的 Object。

propertyChange

事件  
事件对象类型: mx.events.PropertyChangeEvent
属性 PropertyChangeEvent.type = mx.events.PropertyChangeEvent.PROPERTY_CHANGE

语言版本: ActionScript 3.0
产品版本: Adobe Digital Enterprise Platform Data Services for Java EE 3
运行时版本: Flash Player 9, AIR 1.1

此服务的属性发生更改时,将调度 PropertyChangeEvent.PROPERTY_CHANGE 事件。下列属性会出现这种情况:

  • commitRequired
  • mergeRequired
  • connected

PropertyChangeEvent.PROPERTY_CHANGE 常量可为 PropertyChange 事件定义事件对象的 type 属性的值。

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

属性
bubbles由构造函数确定;默认值为 false。
cancelable由构造函数确定;默认值为 false。
kind更改类型;PropertyChangeEventKind.UPDATE 或 PropertyChangeEventKind.DELETE。
oldValue原始属性值。
newValue新属性值(如果有)。
property更改的属性。
source包含更改属性的对象。
currentTarget用于定义处理该事件的事件侦听器的对象。例如,如果您使用 myButton.addEventListener() 注册某个事件侦听器,则 myButton 为 currentTarget 的值。
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 3
运行时版本: Flash Player 9, AIR 1.1

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

RESULT 事件类型。

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

属性
bubblesfalse
cancelabletrue,通过关联标记的 responder.result 方法调用 preventDefault() 将防止服务或操作调度此事件。
currentTarget用于定义处理该事件的事件侦听器的对象。例如,如果您使用 myButton.addEventListener() 注册某个事件侦听器,则 myButton 为 currentTarget 的值。
message 与此事件相关联的 Message。
target调度该事件的 Object;它不一定是侦听该事件的 Object。使用 currentTarget 属性始终可以访问侦听事件的 Object。
resultRPC 调用返回的结果。
token表示对方法单独调用的标记。用于异步完成标记模式。




[ X ]为什么显示为英语?
《ActionScript 3.0 参考》中的内容以英语显示

《ActionScript 3.0 参考》中的部分内容未翻译成所有语言。当某个语言元素未翻译时,将显示为英语。例如,ga.controls.HelpBox 类未翻译成任何语言。因此在简体中文版的参考中,ga.controls.HelpBox 类显示为英语。