DataService

包	mx.data.mxml
类	public class DataService
继承	DataService DataService DataManager Object
实现	IMXMLObject

语言版本:

ActionScript 3.0

产品版本:

Adobe Digital Enterprise Platform Data Services for Java EE 3

运行时版本:

Flash Player 9, AIR 1.1

DataService 类为 LiveCycle Data Services 数据管理服务提供顶级客户端功能这是 mx.data.DataService 的特定于 MXML 的子类，使用该子类可以绑定到 DataService 实例的属性。

注意：在使用 DataService 对象前必须设置 destination 属性。

MXML 语法

隐藏 MXML 语法

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

  <mx:DataService
   Properties
   autoCommit="true"
   autoMerge="true"
   autoSaveCache="false"
   autoSyncEnabled="true"
   conflictDetector="No default."
   dataStore="No default."
   destination="No default."
   pageSize="No default."
   id="No default."
 
   Events
   conflict="No default."
   fault="No default."
   message="No default."
   propertyChange="No default."
   result="No default."
 />

公共属性

隐藏继承的公共属性

显示继承的公共属性

	属性		由以下参数定义
		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
		channelSet : ChannelSet 提供对服务使用的 ChannelSet 的访问。	DataService
		commitRequired : Boolean [只读] 指示是否存在未提交的更改以及是否应该调用 commit() 方法。	DataManager
		conflictDetector : ConflictDetector 提供对当前实现的访问，此实现正用于检测推送到 DataManager 实例的远程操作的冲突。	DataManager
		conflicts : Conflicts [只读] 包含 Conflicts 对象，即 Conflict 实例的 ArrayList。	DataManager
		connected : Boolean [只读] 指示 DataService 是否已连接到远程目标。	DataManager
		constructor : Object 对类对象或给定对象实例的构造函数的引用。	Object
		dataStore : DataStore 包含一个 mx.data.DataStore 类型的对象。	DataManager
		deleteItemOnRemoveFromFill : Boolean 默认情况下，当您对托管填充集合调用 removeItemAt() 方法时，它会向服务器发出一个删除项调用以物理删除该项。	DataManager
		destination : String [覆盖] 指示此服务与哪个远程目标关联。	DataService
		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(dest:String = null) 使用指定目标构造 DataService 的实例。	DataService
		clearCache(value:Object = null):mx.rpc:AsyncToken 清除以前调用 saveCache() 方法或将 autoSaveCache 方法设置为 true 时存储到磁盘中的所有数据	DataManager
		clearCacheData(descriptor:CacheDataDescriptor):mx.rpc:AsyncToken 清除由从本地存储传递的描述符指定的数据。	DataManager
		commit(itemsOrCollections:Array = null, cascadeCommit:Boolean = false):mx.rpc:AsyncToken 提交当前由与此 DataManager 实例关联的 DataStore 实例管理的所有集合的挂起更改。	DataManager
		commitRequiredOn(object:Object):Boolean 指示是否存在此特定对象的挂起更改。	DataManager
		connect():mx.rpc:AsyncToken 强制此服务尝试连接到远程目标。	DataManager
		count(... args):mx.rpc:AsyncToken 调用远程目标上的计数方法。	DataManager
		createItem(item:Object):ItemReference 请求在远程存储中创建指定项。	DataManager
		deleteItem(item:Object):mx.rpc:AsyncToken 请求从远程存储中删除指定项。	DataManager
		disconnect():void 断开 DataManager 实例的网络连接。	DataManager
		executeQuery(queryName:String, propertySpecifier:PropertySpecifier, ... args):mx.rpc:AsyncToken 使用提供的名称和自变量执行查询。	DataManager
		fill(value:ListCollectionView, ... args):mx.rpc:AsyncToken 根据目标的关联 fill 方法填充指定的 ListCollectionView（集合）实例。	DataManager
		fillSubset(value:ListCollectionView, ps:PropertySpecifier, ... args):mx.rpc:AsyncToken 根据目标的关联 fill 方法填充指定的 ListCollectionView（集合）实例。	DataManager
		findItem(queryName:String, propertySpecifier:PropertySpecifier, ... args):mx.rpc:AsyncToken 执行一个返回单个项的查询。	DataManager
		getCacheData(descriptor:CacheDataDescriptor):mx.rpc:AsyncToken 返回本地存储中的 ArrayCollection 或单个托管对象。	DataManager
		getCacheDescriptors(view:ListCollectionView, options:uint = 0, item:Object = null):mx.rpc:AsyncToken 使用 CacheDataDescriptor 实例填充指定的 ListCollectionView（集合）实例。	DataManager
		getCacheIDs(view:ListCollectionView):mx.rpc:AsyncToken 使用之前在应用程序中使用的所有缓存标识符来填充指定的 ListCollectionView（集合）实例。	DataManager
		getItem(identity:Object, defaultValue:Object = null):ItemReference 对与指定标识匹配的项发出异步请求。	DataManager
		getLocalItem(identity:Object):Object 使用给定的标识查找所提供的项。	DataManager
		getPageInformation(view:ListCollectionView):PageInformation 返回指定集合的页面信息。	DataManager
		getPendingOperation(item:Object):uint 返回消息缓存中针对指定项的挂起操作。	DataManager
		hasOwnProperty(name:String):Boolean 表示对象是否已经定义了指定的属性。	Object
		initialize():mx.rpc:AsyncToken 强制初始化 DataStore。	DataManager
		isCollectionManaged(view:ListCollectionView):Boolean 如果传递的集合由此服务管理，则返回 true。	DataManager
		isCollectionPaged(view:ListCollectionView):Boolean 如果传递的集合要使用分页功能，则返回 true。	DataManager
		isPrototypeOf(theClass:Object):Boolean 表示 Object 类的实例是否在指定为参数的对象的原型链中。	Object
		isRangeResident(view:ListCollectionView, startIndex:int, numberOfItems:int):Boolean 如果将提供的项范围全部页入，则返回 true。	DataManager
		localFill(value:ListCollectionView, ps:PropertySpecifier, ... args):mx.rpc:AsyncToken 根据关联的 <fill-method> 元素基于本地存储上的数据填充指定的 ListCollectionView。	DataManager
		logout():void 将用户从 DataService 的目标中注销。	DataService
		merge():void 将所有挂起更新合并到托管对象集中。	DataManager
		propertyIsEnumerable(name:String):Boolean 表示指定的属性是否存在、是否可枚举。	Object
		refresh():mx.rpc:AsyncToken 刷新由此 DataManager 实例管理的所有数据。	DataManager
		refreshCollection(value:ListCollectionView):mx.rpc:AsyncToken 刷新先前使用 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
		releaseReference(item:Object, propName:String):Boolean 释放单值关联的值。	DataManager
		revertChanges(item:IManaged = null):Boolean 还原对指定项进行的所有未提交的更改。	DataManager
		revertChangesForCollection(collection:ListCollectionView = null):Boolean 还原指定集合中包含的、应由此 DataManager 实例管理的所有项的更改。	DataManager
		saveCache(value:Object = null):mx.rpc:AsyncToken 此方法保存当前状态的 DataManager 实例缓存。	DataManager
		saveCacheRequiredOn(object:Object):Boolean 指示是否存在对此特定对象所做的未保存至本地缓存的暂挂更改。	DataManager
		setCredentials(username:String, password:String):void 为此 DataService 目标设置凭据。	DataService
		setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void 设置循环操作动态属性的可用性。	Object
		setRemoteCredentials(username:String, password:String):void 为此 DataService 目标的第三方设置凭据。	DataService
		synchronizeAllFills():mx.rpc:AsyncToken 获取之前在此数据服务（数据管理器）上执行的所有填充的已更改项。	DataManager
		synchronizeDataServices(services:Array):mx.rpc:AsyncToken [静态] 允许所有本地数据的同步的简便方法：针对每个数据服务（数据管理器）调用 synchronizeAllFills()，以便仅当所有单个 synchronizeAllFills() 调用完成后，才完成最终结果标记。	DataManager
		synchronizeFill(... fillArgs):mx.rpc:AsyncToken 获取上一次调用 fill 或 synchronizeFill 后在服务器上更改的已更改项。	DataManager
		toLocaleString():String 返回此对象的字符串表示形式，其格式设置遵守区域设置特定的约定。	Object
		toString():String 返回指定对象的字符串表示形式。	Object
		updateItem(item:Object, origItem:Object = null, changes:Array = null):mx.rpc:AsyncToken 触发指定项目的更新。	DataManager
		valueOf():Object 返回指定对象的原始值。	Object

受保护的方法

隐藏继承的受保护方法

显示继承的受保护方法

	方法		由以下参数定义
		checkImplementation():void 如果尚未初始化此数据管理器，则使故障排队。	DataManager

事件

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

隐藏继承的事件

显示继承的事件

	摘要	由以下参数定义
conflict	如果在挂起的本地更改和其它客户端提交的更改之间检测到冲突，或者此客户端提交的更改与远程目标中的更改发生冲突，则调度 DataConflictEvent.CONFLICT 事件。	DataService
fault	当由于错误而导致服务调用失败时，将调度 DataServiceFaultEvent.FAULT 事件。	DataService
message	当远程目标推送数据操作的通知时，将调度 MessageEvent.MESSAGE 事件。	DataService
propertyChange	此服务的属性发生更改时，将调度 PropertyChangeEvent.PROPERTY_CHANGE 事件。	DataService
result	当服务调用成功返回时，将调度 ResultEvent.RESULT 事件。	DataService

属性详细信息

构造函数详细信息

法律声明 | 在线隐私策略

DataService - AS3 ADEP Data Services

包x

语言元素

附录

包 mx.data.mxml

destination