RPCDataServiceAdapter - Adobe ActionScript® 3 (AS3 ADEP Data Services)

Пакет	mx.data
Класс	public class RPCDataServiceAdapter
Наследование	RPCDataServiceAdapter DataServiceAdapter Object

Язык версии:

ActionScript 3.0

Версия продукта:

Adobe Digital Enterprise Platform Data Services for Java EE 3

Версии среды выполнения:

Flash Player 9, AIR 1.1

Абстрактный базовый класс, который используется для реализации нового типа DataService. Расширить этот класс и отменить методы, например createItem, updateItem и т. д. для настройки реализации этих вызовов. DataManagement при необходимости автоматически вызывает эти методы.

Самое сложное в работе этой службы заключается в том, что необходимо принять вызов существующей службы так, чтобы добавление управления данными оказало минимальное влияние на код пользователя. Вызов службы выполняется таким же способом – запускаются те же самые события и маркеры, однако при этом необходимо выполнить управление результатом. Для выполнения этой задачи RPCDataServiceAdapter связывается с ManagedOperation посредством стандартной операции службы RPC. Устанавливается свойство operationManager операции и в процессе инициализации и вызова пользователя перенаправляется к прокси в этом классе (например, queryProxy). Таким образом, создается вызов соответствующего управления данными и возвращает управляемый маркер конечному пользователю, что позволяет ему получить результат управляемой операции.

 order is:
  user calls service method
     calls service delegates to operationManager - ManagedOpertion.xxProxy methods
        calls managerOperation kicks off DMS op --> DataManager.xx
           calls DMS op calls adapter to do the op --> DataServiceAdapter.invoke
              calls: RPCDataServiceAdapter invokes the service operation and sets the "raw" lastResult
              returns: adapter's result comes back in and is converted to DMS Result Message - RPCDataServiceResult.xxResult
        returns: data manager processes result - updates managed object --> DataListRequestResponder/CommitResponder
     returns: service is updated to lastResult from the operation
  returns: user's result event is called

Общедоступные свойства

Скрыть унаследованные общедоступные свойства

Показать унаследованные общедоступные свойства

	Свойство		Определено
		asyncRequest : AsyncRequest [переопределить] [только для чтения] Абстрактный метод, который возвращает AsyncRequest, используемый для обработки всех операций DataService.	RPCDataServiceAdapter
		connected : Boolean [только для чтения] Возвращает true, если адаптер этой службы подключен к ее источнику.	DataServiceAdapter
		constructor : Object Ссылка на объект класса или функцию конструктора для данного экземпляра объекта.	Object
		dataManagerRegistry : Object [статические] Статическое отображение от имени адреса назначения до менеджера данных для этого адреса назначения.	RPCDataServiceAdapter
		dataStore : DataStore Содержит объект типа mx.data.DataStore.	DataServiceAdapter
		destination : String Имя адреса назначения для этого адаптера службы данных.	RPCDataServiceAdapter
		serializeAssociations : Boolean [переопределить] [только для чтения] Определяется, действительно ли DMS помещает элементы в дескриптор сериализации, исключающий ассоциации.	RPCDataServiceAdapter
		throwUnhandledFaults : Boolean [переопределить] [только для чтения] Возвращает false, так как этот менеджер данных не выводит сообщение об ошибке, если существует ошибка при отсутствии прослушивателей в менеджере данных.	RPCDataServiceAdapter

Общедоступные методы

Скрыть унаследованные общедоступные методы

Показать унаследованные общедоступные методы

	Метод		Определено
		createItem(dataManager:RPCDataManager, item:Object):mx.rpc:AsyncToken Этот метод вызывается RPCDataServiceAdapter, если требуется выполнить операцию createItem.	RPCDataServiceAdapter
		deleteItem(dataManager:RPCDataManager, item:Object):mx.rpc:AsyncToken Вызов выполняется RPCDataServiceAdapter, если уровню управления необходимо удалить элемент с сервера.	RPCDataServiceAdapter
		executeQuery(dataManager:RPCDataManager, queryName:String, includeSpecifier:PropertySpecifier, queryArgs:Array):mx.rpc:AsyncToken Вызывается, если адаптеру требуется выполнить именованный запрос.	RPCDataServiceAdapter
		getConflictingProperties(dmgr:RPCDataManager, cause:DataMessage, serverObject:Object):Array Возвращает массив имен свойств, конфликтующих между версией клиента элемента и версией сервера.	RPCDataServiceAdapter
		getDataManager(destination:String):DataManager [переопределить] Выполняет поиск менеджера данных для указанного адреса назначения.	RPCDataServiceAdapter
		getDataServiceAdapter(destination:String):DataServiceAdapter Выполняет поиск связанного адаптера службы данных.	DataServiceAdapter
		getItem(dataManager:RPCDataManager, identity:Object, defaultValue:Object = null, includeSpecifier:PropertySpecifier = null):mx.rpc:AsyncToken Выполняется для извлечения идентификатором отдельного элемента из адаптера.	RPCDataServiceAdapter
		getItems(dataManager:RPCDataManager, ids:Array, includeSpecifier:PropertySpecifier):mx.rpc:AsyncToken Метод адаптера вызывается, если требуется получить список элементов для определенного адреса назначения.	RPCDataServiceAdapter
		handleFault(errMsg:ErrorMessage, cause:DataMessage):void Вызов выполняется после завершения обработки ошибки операции создания, обновления, удаления или обновления коллекции.	RPCDataServiceAdapter
		hasOwnProperty(name:String):Boolean Показывает, определено ли заданное свойство для объекта.	Object
		isPrototypeOf(theClass:Object):Boolean Показывает, есть ли экземпляр класса Object в цепи прототипов объекта, заданного в качестве параметра.	Object
		pageQuery(dataManager:RPCDataManager, queryName:String, queryArgs:Array, startIndex:int, numItems:int):mx.rpc:AsyncToken Выполнить запрос для отдельной страницы запроса на стороне клиента.	RPCDataServiceAdapter
		postItemDeletion(dataManager:RPCDataManager, identity:Object):void Моделирует событие с сервера, которое соответствует удалению элемента.	RPCDataServiceAdapter
		postItemUpdate(dataManager:RPCDataManager, item:Object, origItem:Object = null, changes:Array = null):void Моделирует событие с сервера, которое соответствует обновлению или созданию элемента.	RPCDataServiceAdapter
		processDataMessage(msg:IMessage, responder:IResponder):void Низкоуровневый метод, используемый DataManager для обработки информационного сообщения.	RPCDataServiceAdapter
		propertyIsEnumerable(name:String):Boolean Показывает наличие заданного свойства и его перечисляемость.	Object
		setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void Задает доступность динамического свойства для операций цикла.	Object
		startCheckForConflict(dmgr:RPCDataManager, cause:DataMessage, errMsg:ErrorMessage = null):void Вызывается при возникновении ошибки, которая может являться конфликтом со стороны сервера.	RPCDataServiceAdapter
		toLocaleString():String Возвращает строковое представление этого объекта, отформатированного в соответствии со стандартами, принятыми для данной локали.	Object
		toString():String Возвращает строковое представление заданного объекта.	Object
		updateCollection(dataManager:RPCDataManager, mq:ManagedQuery, ucmsg:UpdateCollectionMessage):mx.rpc:AsyncToken Вызывается, если в коллекцию, управляемую по запросу (не посредством ассоциации) добавлены элементы или если из нее удалены элементы.	RPCDataServiceAdapter
		updateItem(dataManager:RPCDataManager, item:Object, origItem:Object, changes:Array):mx.rpc:AsyncToken Этот метод вызывается RPCDataServiceAdapter для выполнения определенной операции createItem.	RPCDataServiceAdapter
		valueOf():Object Возвращает элементарное значение заданного объекта.	Object

Защищенные методы

	Метод		Определено
		checkForConflict(resultEvent:ResultEvent, token:mx.rpc:AsyncToken):void Этот метод вызывается после того, как происходит ошибка, по которой можно определить конфликт.	RPCDataServiceAdapter
		internalGetItem(dataManager:RPCDataManager, identity:Object, defaultValue:Object = null, includeSpecifier:PropertySpecifier = null):mx.rpc:AsyncToken Этот метод фактически выполняет операцию getItem, однако обработчик результата не будет использован для обновления управляемого результата.	RPCDataServiceAdapter
		rpcAdapterFault(ev:FaultEvent, token:mx.rpc:AsyncToken):void Ответчик ошибки для операций RPCDataService.	RPCDataServiceAdapter
		sendResultEvent(token:mx.rpc:AsyncToken, msg:IMessage):void Ответчик успешного выполнения для операций RPCDataService.	RPCDataServiceAdapter

Сведения о свойстве

asyncRequest

свойство

asyncRequest:AsyncRequest [только для чтения] [переопределить]

Язык версии:

ActionScript 3.0

Версия продукта:

Adobe Digital Enterprise Platform Data Services for Java EE 3

Версии среды выполнения:

Flash Player 9, AIR 1.1

Абстрактный метод, который возвращает AsyncRequest, используемый для обработки всех операций DataService. Посредством отмены метода AsyncRequest.invoke можно перехватить управляемые запросы. Класс AsyncRequest также представляет различные методы для определения, подключена или отключена служба.

Реализация
override public function get asyncRequest():AsyncRequest

dataManagerRegistry

свойство

public static var dataManagerRegistry:Object

Язык версии:

ActionScript 3.0

Версия продукта:

Adobe Digital Enterprise Platform Data Services for Java EE 3

Версии среды выполнения:

Flash Player 9, AIR 1.1

Статическое отображение от имени адреса назначения до менеджера данных для этого адреса назначения.

destination

свойство

public var destination:String

Язык версии:

ActionScript 3.0

Версия продукта:

Adobe Digital Enterprise Platform Data Services for Java EE 3

Версии среды выполнения:

Flash Player 9, AIR 1.1

Имя адреса назначения для этого адаптера службы данных.

serializeAssociations

свойство

serializeAssociations:Boolean [только для чтения] [переопределить]

Язык версии:

ActionScript 3.0

Версия продукта:

Adobe Digital Enterprise Platform Data Services for Java EE 3

Версии среды выполнения:

Flash Player 9, AIR 1.1

Определяется, действительно ли DMS помещает элементы в дескриптор сериализации, исключающий ассоциации. MessagingDataServiceAdapter использует этот подход для передачи ассоциаций; он не используется в RPCDataServiceAdapter.

Реализация
override public function get serializeAssociations():Boolean

throwUnhandledFaults

свойство

throwUnhandledFaults:Boolean [только для чтения] [переопределить]

Язык версии:

ActionScript 3.0

Версия продукта:

Adobe Digital Enterprise Platform Data Services for Java EE 3

Версии среды выполнения:

Flash Player 9, AIR 1.1

Возвращает false, так как этот менеджер данных не выводит сообщение об ошибке, если существует ошибка при отсутствии прослушивателей в менеджере данных. Для служб RPC эти ошибки проксируются на прослушивателях в службе, и сообщение об ошибке не выводится.

Реализация
override public function get throwUnhandledFaults():Boolean

Сведения о методе

checkForConflict

()

метод

protected function checkForConflict(resultEvent:ResultEvent, token:mx.rpc:AsyncToken):void

Язык версии:

ActionScript 3.0

Версия продукта:

Adobe Digital Enterprise Platform Data Services for Java EE 3

Версии среды выполнения:

Flash Player 9, AIR 1.1

Этот метод вызывается после того, как происходит ошибка, по которой можно определить конфликт. В обработчике ошибок для этой ошибки используется вызов getItem() с целью извлечения текущей версии сервера элемента.

Этот метод можно отменить, только если требуется выполнить какие-либо действия после того, как установлено отсутствие конфликта.

Параметры

	`resultEvent:ResultEvent` — Объект события из вызова `getItem()`.

	`token:mx.rpc:AsyncToken` — Содержит свойство `cause`, которое является исходным DataMessage для изменения. Этот метод может вызвать `Conflicts.raiseConflict()`, если определено наличие конфликта, или не выполнять никаких действий, если установлено отсутствие конфликта.

createItem

()

метод

public function createItem(dataManager:RPCDataManager, item:Object):mx.rpc:AsyncToken

Язык версии:

ActionScript 3.0

Версия продукта:

Adobe Digital Enterprise Platform Data Services for Java EE 3

Версии среды выполнения:

Flash Player 9, AIR 1.1

Этот метод вызывается RPCDataServiceAdapter, если требуется выполнить операцию createItem. Реализация по умолчанию должна вызвать управляемую операцию для операции createItem с помощью элемента в качестве первого параметра. Если требуется вызвать несколько служб или изменить подпись параметра для этой операции, можно расширить RPCDataServiceAdapter и отменить этот метод createItem.

Параметры

	`dataManager:RPCDataManager` — менеджер в элементе управления вызываемой операции создания.

	`item:Object` — создаваемый элемент.

Возвращает

mx.rpc:AsyncToken — Этот маркер можно использовать для регистрации одной или более функций обратного вызова с целью получения событий результата или ошибки операции создания. Этот маркер также возвращается в свойстве call в ResultEvent.RESULT или в FaultEvent.FAULT. Пользовательские данные могут быть присоединены к этому объекту и проанализированы позже во время фазы обработки события.

deleteItem

()

метод

public function deleteItem(dataManager:RPCDataManager, item:Object):mx.rpc:AsyncToken

Язык версии:

ActionScript 3.0

Версия продукта:

Adobe Digital Enterprise Platform Data Services for Java EE 3

Версии среды выполнения:

Flash Player 9, AIR 1.1

Вызов выполняется RPCDataServiceAdapter, если уровню управления необходимо удалить элемент с сервера. Управляемый элемент предоставляется как аргумент. Реализация по умолчанию этого метода выполняет поиск ManagedOperation, где тип=delete. Этот метод вызывается с удаляемым элементом или с идентификатором удаляемого элемента, если параметры ManagedOperation устанавливаются на id.

Параметры

	`dataManager:RPCDataManager` — менеджер в элементе управления вызываемой операции удаления.

	`item:Object` — удаляемый элемент.

Возвращает

mx.rpc:AsyncToken — Этот маркер можно использовать для регистрации одной или более функций обратного вызова с целью получения событий результата или ошибки операции удаления. Этот маркер также возвращается в свойстве call в ResultEvent.RESULT или в FaultEvent.FAULT. Пользовательские данные могут быть присоединены к этому объекту и проанализированы позже во время фазы обработки события.

executeQuery

()

метод

 public function executeQuery(dataManager:RPCDataManager, queryName:String, includeSpecifier:PropertySpecifier, queryArgs:Array):mx.rpc:AsyncToken

Язык версии:

ActionScript 3.0

Версия продукта:

Adobe Digital Enterprise Platform Data Services for Java EE 3

Версии среды выполнения:

Flash Player 9, AIR 1.1

Вызывается, если адаптеру требуется выполнить именованный запрос. Если подкачка страниц включена, выполняется получение первой страницы в коллекции.

Параметры

	`dataManager:RPCDataManager` — менеджер в элементе управления вызываемой операции запроса.

	`queryName:String` — имя запроса

	`includeSpecifier:PropertySpecifier` — набор свойств, который необходимо получить.

	`queryArgs:Array` — аргументы для вызова операции запроса.

Возвращает

mx.rpc:AsyncToken — Этот маркер можно использовать для регистрации одной или более функций обратного вызова с целью получения событий результата или ошибки операции запроса. Этот маркер также возвращается в свойстве call в ResultEvent.RESULT или в FaultEvent.FAULT. Пользовательские данные могут быть присоединены к этому объекту и проанализированы позже во время фазы обработки события.

getConflictingProperties

()

метод

public function getConflictingProperties(dmgr:RPCDataManager, cause:DataMessage, serverObject:Object):Array

Язык версии:

ActionScript 3.0

Версия продукта:

Adobe Digital Enterprise Platform Data Services for Java EE 3

Версии среды выполнения:

Flash Player 9, AIR 1.1

Возвращает массив имен свойств, конфликтующих между версией клиента элемента и версией сервера. Возвращает значение null при отсутствии конфликтов.

Параметры

	`dmgr:RPCDataManager` — связанный менеджер данных.

	`cause:DataMessage` — сообщение данных, обработка которого, возможно, инициировала конфликт.

	`serverObject:Object` — версия сервера элемента.

Возвращает

Array — массив имен свойств, конфликтующих между версией клиента элемента и версией сервера. Возвращает значение null при отсутствии конфликтов.

getDataManager

()

метод

override public function getDataManager(destination:String):DataManager

Язык версии:

ActionScript 3.0

Версия продукта:

Adobe Digital Enterprise Platform Data Services for Java EE 3

Версии среды выполнения:

Flash Player 9, AIR 1.1

Выполняет поиск менеджера данных для указанного адреса назначения.

Параметры

destination:String — Адрес назначения.

Возвращает

DataManager — Объект DataManager для адреса назначения.

getItem

()

метод

 public function getItem(dataManager:RPCDataManager, identity:Object, defaultValue:Object = null, includeSpecifier:PropertySpecifier = null):mx.rpc:AsyncToken

Язык версии:

ActionScript 3.0

Версия продукта:

Adobe Digital Enterprise Platform Data Services for Java EE 3

Версии среды выполнения:

Flash Player 9, AIR 1.1

Выполняется для извлечения идентификатором отдельного элемента из адаптера. Параметр includeSpecifier указывает требуемый набор свойств.

Параметры

	`dataManager:RPCDataManager` — связанный менеджер данных.

	`identity:Object` — идентификатор элемента, который необходимо получить.

	`defaultValue:Object` (default = `null`) — [Дополнительно] Экземпляр типа со значениями по умолчанию, который должен быть создан (если он еще не существует).

	`includeSpecifier:PropertySpecifier` (default = `null`) — [Дополнительно] набор свойств, который необходимо получить.

Возвращает

mx.rpc:AsyncToken — Привязка AsyncToken к свойству результата AsyncToken для получения результата. В противном случае для отслеживания результатов операции можно организовать прослушивание событий изменения свойства результата, добавить один или несколько ответчиков к маркеру и добавить дополнительную информацию в виде динамических свойств маркера.

getItems

()

метод

public function getItems(dataManager:RPCDataManager, ids:Array, includeSpecifier:PropertySpecifier):mx.rpc:AsyncToken

Язык версии:

ActionScript 3.0

Версия продукта:

Adobe Digital Enterprise Platform Data Services for Java EE 3

Версии среды выполнения:

Flash Player 9, AIR 1.1

Метод адаптера вызывается, если требуется получить список элементов для определенного адреса назначения. PropertySpecifier указывает минимальный набор необходимых свойств. Реализация по умолчанию этого метода должна неоднократно выполнить вызов метода getItem. Если сервер может выполнить эту операцию более эффективно, это может усовершенствовать некоторые операции для реализации этого метода.

Параметры

	`dataManager:RPCDataManager` — связанный менеджер данных.

	`ids:Array` — массив идентификаторов получаемых элементов.

	`includeSpecifier:PropertySpecifier` — [Дополнительно] набор свойств, который необходимо получить.

Возвращает

handleFault

()

метод

public function handleFault(errMsg:ErrorMessage, cause:DataMessage):void

Язык версии:

ActionScript 3.0

Версия продукта:

Adobe Digital Enterprise Platform Data Services for Java EE 3

Версии среды выполнения:

Flash Player 9, AIR 1.1

Вызов выполняется после завершения обработки ошибки операции создания, обновления, удаления или обновления коллекции. Возможность для адаптера настроить логику, связанную с обработкой ошибок, и выполнить проверку на наличие конфликтов. Реализация по умолчанию реализует функцию RPCDataManager conflictMode. При получении ошибки для операций обновления или удаления текущая версия на сервере сравнивается с исходной версией обновляемого/удаляемого объекта. Если версия сервера отличается, следует объявить наличие конфликта. Предполагается, что изменение, вызвавшее ошибку, уже возвращено и отложено в пакет неподтвержденных изменений.

Параметры

	`errMsg:ErrorMessage` — Описание ошибки.

	`cause:DataMessage` — Операция, вызвавшая ошибку.

internalGetItem

()

метод

 protected function internalGetItem(dataManager:RPCDataManager, identity:Object, defaultValue:Object = null, includeSpecifier:PropertySpecifier = null):mx.rpc:AsyncToken

Язык версии:

ActionScript 3.0

Версия продукта:

Adobe Digital Enterprise Platform Data Services for Java EE 3

Версии среды выполнения:

Flash Player 9, AIR 1.1

Этот метод фактически выполняет операцию getItem, однако обработчик результата не будет использован для обновления управляемого результата. Этот метод используется реализацией getItem по умолчанию для вызова операции. Если обнаружение конфликтов включено, после получения ошибки для операции обновления или удаления вызывается этот метод для извлечения текущей версии сервера объекта. Таким образом можно определить, свидетельствует ли ошибка о наличии конфликта, и получить текущую версию сервера для разрешения этого конфликта.

Параметры

	`dataManager:RPCDataManager` — связанный менеджер данных.

	`identity:Object` — идентификатор элемента, который необходимо получить.

	`defaultValue:Object` (default = `null`) — [Дополнительно] Экземпляр типа со значениями по умолчанию, который должен быть создан (если он еще не существует).

	`includeSpecifier:PropertySpecifier` (default = `null`) — [Дополнительно] набор свойств, который необходимо получить.

Возвращает

pageQuery

()

метод

 public function pageQuery(dataManager:RPCDataManager, queryName:String, queryArgs:Array, startIndex:int, numItems:int):mx.rpc:AsyncToken

Язык версии:

ActionScript 3.0

Версия продукта:

Adobe Digital Enterprise Platform Data Services for Java EE 3

Версии среды выполнения:

Flash Player 9, AIR 1.1

Выполнить запрос для отдельной страницы запроса на стороне клиента. Этот метод вызывается, если pagingEnabled установлен на ManagedQuery. Код клиента вызывает запрос как стандартный, имеющий только обычные параметры. Уровень управления вставляет параметры startIndex и numItems перед выполнением.

Параметры

	`dataManager:RPCDataManager` — менеджер в элементе управления вызываемой операции запроса.

	`queryName:String` — имя запроса.

	`queryArgs:Array` — аргументы для вызова операции запроса.

	`startIndex:int` — начальный индекс страницы, который необходимо получить.

	`numItems:int` — размер страницы.

Возвращает

postItemDeletion

()

метод

public function postItemDeletion(dataManager:RPCDataManager, identity:Object):void

Язык версии:

ActionScript 3.0

Версия продукта:

Adobe Digital Enterprise Platform Data Services for Java EE 3.1

Версии среды выполнения:

Flash Player 9, AIR 1.5

Моделирует событие с сервера, которое соответствует удалению элемента. Эта операция полезна, когда необходимо сообщить LCDS об удалении элементов на сервере.

Параметры

	`dataManager:RPCDataManager` — связанный менеджер данных.

	`identity:Object` — идентификатор удаленного элемента.

postItemUpdate

()

метод

 public function postItemUpdate(dataManager:RPCDataManager, item:Object, origItem:Object = null, changes:Array = null):void

Язык версии:

ActionScript 3.0

Версия продукта:

Adobe Digital Enterprise Platform Data Services for Java EE 3.1

Версии среды выполнения:

Flash Player 9, AIR 1.5

Моделирует событие с сервера, которое соответствует обновлению или созданию элемента. Эта операция полезна, когда необходимо сообщить LCDS об изменении элементов на сервере.

Параметры

	`dataManager:RPCDataManager` — связанный менеджер данных.

	`item:Object` — обновленный элемент.

	`origItem:Object` (default = `null`) — исходный элемент.

	`changes:Array` (default = `null`) — имена измененных свойств.

processDataMessage

()

метод

public function processDataMessage(msg:IMessage, responder:IResponder):void

Язык версии:

ActionScript 3.0

Версия продукта:

Adobe Digital Enterprise Platform Data Services for Java EE 3

Версии среды выполнения:

Flash Player 9, AIR 1.1

Низкоуровневый метод, используемый DataManager для обработки информационного сообщения. Он преобразует информационное сообщение в вызовы для интерфейса адаптера, так что в стандартном случае можно отменить одну из этих операций.

Параметры

	`msg:IMessage` — обрабатываемое сообщение.

	`responder:IResponder` — обратно вызываемый ответчик при завершении обработки сообщения.

rpcAdapterFault

()

метод

protected function rpcAdapterFault(ev:FaultEvent, token:mx.rpc:AsyncToken):void

Язык версии:

ActionScript 3.0

Версия продукта:

Adobe Digital Enterprise Platform Data Services for Java EE 3

Версии среды выполнения:

Flash Player 9, AIR 1.1

Ответчик ошибки для операций RPCDataService. Обрабатывает ошибки путем создания соответствующего сообщения об ошибках и передачи его по цепочке ответчиков маркера.

Параметры

	`ev:FaultEvent` — событие ошибки, полученное с сервера.

	`token:mx.rpc:AsyncToken` — маркер, связанный с вызовом.

sendResultEvent

()

метод

protected function sendResultEvent(token:mx.rpc:AsyncToken, msg:IMessage):void

Язык версии:

ActionScript 3.0

Версия продукта:

Adobe Digital Enterprise Platform Data Services for Java EE 3

Версии среды выполнения:

Flash Player 9, AIR 1.1

Ответчик успешного выполнения для операций RPCDataService. Переносит полученное сообщение в событие сообщения и передает его по цепочке ответчиков маркера.

Параметры

	`token:mx.rpc:AsyncToken` — маркер, связанный с вызовом.

	`msg:IMessage` — сообщение-результат, полученное с сервера

startCheckForConflict

()

метод

public function startCheckForConflict(dmgr:RPCDataManager, cause:DataMessage, errMsg:ErrorMessage = null):void

Язык версии:

ActionScript 3.0

Версия продукта:

Adobe Digital Enterprise Platform Data Services for Java EE 3

Версии среды выполнения:

Flash Player 9, AIR 1.1

Вызывается при возникновении ошибки, которая может являться конфликтом со стороны сервера. Необходимо получить текущие значения для конфликтующего элемента и сравнить их с исходным элементом с выполненными изменениями. Если существуют различия, то следует объявить о наличии конфликта.

Параметры

	`dmgr:RPCDataManager` — Менеджер данных, связанный с адресом назначения адаптера.

	`cause:DataMessage` — сообщение с исходными данными, которое, возможно, вызвало конфликт.

	`errMsg:ErrorMessage` (default = `null`) — сообщение об ошибках, описывающее сбой, связанный с конфликтом.

updateCollection

()

метод

 public function updateCollection(dataManager:RPCDataManager, mq:ManagedQuery, ucmsg:UpdateCollectionMessage):mx.rpc:AsyncToken

Язык версии:

ActionScript 3.0

Версия продукта:

Adobe Digital Enterprise Platform Data Services for Java EE 3

Версии среды выполнения:

Flash Player 9, AIR 1.1

Вызывается, если в коллекцию, управляемую по запросу (не посредством ассоциации) добавлены элементы или если из нее удалены элементы. Существует отдельное сообщение со списком отдельных изменений. Во многих случаях не требуется отменять этот метод, так как не требуется сохранять изменения, выполненные на клиенте.

При реализации ассоциаций, например, отношения «многое ко многому» посредством запросов целесообразно использовать добавление/удаление строки.

Реализация RPCDataServiceAdapter отображает их для отдельных вызовов добавления и удаления.

Параметры

	`dataManager:RPCDataManager` — Менеджер данных, связанный с адресом назначения адаптера.

	`mq:ManagedQuery` — управляемый запрос, для которого были добавлены или удалены элементы.

	`ucmsg:UpdateCollectionMessage` — сообщение об обновлении коллекции, подробно описывающее элементы, которые были добавлены или удалены

Возвращает

mx.rpc:AsyncToken — Ссылка AsyncToken на маркер, который будет идентифицировать эту операцию в событии результата или ошибки, передаваемом этой службой.

updateItem

()

метод

public function updateItem(dataManager:RPCDataManager, item:Object, origItem:Object, changes:Array):mx.rpc:AsyncToken

Язык версии:

ActionScript 3.0

Версия продукта:

Adobe Digital Enterprise Platform Data Services for Java EE 3

Версии среды выполнения:

Flash Player 9, AIR 1.1

Этот метод вызывается RPCDataServiceAdapter для выполнения определенной операции createItem. Для него указана новая версия элемента, исходная версия элемента, существовавшая до его изменения на этом клиенте, а также список измененных свойств. Реализация по умолчанию этого метода выполняет поиск ManagedOperation, имеющего тип="update", и вызывает его. Управляющая операция должна принять новую версию элемента в качестве параметра. Если дополнительно объявляются параметры со специальными именами origItem и changes, эти параметры также предоставляются для удаленной службы.

Параметры

	`dataManager:RPCDataManager` — Менеджер данных.

	`item:Object` — Новая версия элемента.

	`origItem:Object` — Исходный элемент.

	`changes:Array` — список свойств, которые необходимо изменить.

Возвращает

Юридическая информация | Политика конфиденциальности онлайн

RPCDataServiceAdapter - AS3 ADEP Data Services

Классы x

asyncRequest

dataManagerRegistry

destination

serializeAssociations

throwUnhandledFaults

checkForConflict

createItem

deleteItem

executeQuery

getConflictingProperties

getDataManager

getItem

getItems

handleFault

internalGetItem

pageQuery

postItemDeletion

postItemUpdate

processDataMessage

rpcAdapterFault

sendResultEvent

startCheckForConflict

updateCollection

updateItem