| Пакет | 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 |
Самое сложное в работе этой службы заключается в том, что необходимо принять вызов существующей службы так, чтобы добавление управления данными оказало минимальное влияние на код пользователя. Вызов службы выполняется таким же способом – запускаются те же самые события и маркеры, однако при этом необходимо выполнить управление результатом. Для выполнения этой задачи 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 | ||
| Метод | Определено | ||
|---|---|---|---|
Этот метод вызывается RPCDataServiceAdapter, если требуется выполнить операцию createItem. | RPCDataServiceAdapter | ||
Вызов выполняется RPCDataServiceAdapter, если уровню управления необходимо удалить элемент с сервера. | RPCDataServiceAdapter | ||
executeQuery(dataManager:RPCDataManager, queryName:String, includeSpecifier:PropertySpecifier, queryArgs:Array):mx.rpc:AsyncToken
Вызывается, если адаптеру требуется выполнить именованный запрос. | RPCDataServiceAdapter | ||
Возвращает массив имен свойств, конфликтующих между версией клиента элемента и версией сервера. | RPCDataServiceAdapter | ||
[переопределить]
Выполняет поиск менеджера данных для указанного адреса назначения. | RPCDataServiceAdapter | ||
|
Выполняет поиск связанного адаптера службы данных. | 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 | ||
Вызов выполняется после завершения обработки ошибки операции создания, обновления, удаления или обновления коллекции. | RPCDataServiceAdapter | ||
|
Показывает, определено ли заданное свойство для объекта. | Object | |
|
Показывает, есть ли экземпляр класса Object в цепи прототипов объекта, заданного в качестве параметра. | Object | |
pageQuery(dataManager:RPCDataManager, queryName:String, queryArgs:Array, startIndex:int, numItems:int):mx.rpc:AsyncToken
Выполнить запрос для отдельной страницы запроса на стороне клиента. | RPCDataServiceAdapter | ||
Моделирует событие с сервера, которое соответствует удалению элемента. | RPCDataServiceAdapter | ||
postItemUpdate(dataManager:RPCDataManager, item:Object, origItem:Object = null, changes:Array = null):void
Моделирует событие с сервера, которое соответствует обновлению или созданию элемента. | RPCDataServiceAdapter | ||
Низкоуровневый метод, используемый DataManager для обработки информационного сообщения. | RPCDataServiceAdapter | ||
|
Показывает наличие заданного свойства и его перечисляемость. | Object | |
|
Задает доступность динамического свойства для операций цикла. | Object | |
Вызывается при возникновении ошибки, которая может являться конфликтом со стороны сервера. | RPCDataServiceAdapter | ||
|
Возвращает строковое представление этого объекта, отформатированного в соответствии со стандартами, принятыми для данной локали. | Object | |
|
Возвращает строковое представление заданного объекта. | 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 | ||
|
Возвращает элементарное значение заданного объекта. | Object | |
| Метод | Определено | ||
|---|---|---|---|
Этот метод вызывается после того, как происходит ошибка, по которой можно определить конфликт. | RPCDataServiceAdapter | ||
internalGetItem(dataManager:RPCDataManager, identity:Object, defaultValue:Object = null, includeSpecifier:PropertySpecifier = null):mx.rpc:AsyncToken
Этот метод фактически выполняет операцию getItem, однако обработчик результата не будет использован для обновления управляемого результата. | RPCDataServiceAdapter | ||
Ответчик ошибки для операций RPCDataService. | RPCDataServiceAdapter | ||
Ответчик успешного выполнения для операций 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():AsyncRequestdataManagerRegistry | свойство |
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():BooleanthrowUnhandledFaults | свойство |
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():BooleancheckForConflict | () | метод |
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 — [Дополнительно] набор свойств, который необходимо получить.
|
mx.rpc:AsyncToken — Привязка AsyncToken к свойству результата AsyncToken для получения результата. В противном случае для отслеживания результатов операции можно организовать прослушивание событий изменения свойства результата, добавить один или несколько ответчиков к маркеру и добавить дополнительную информацию в виде динамических свойств маркера.
|
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) |
mx.rpc:AsyncToken — Привязка AsyncToken к свойству результата AsyncToken для получения результата. В противном случае для отслеживания результатов операции можно организовать прослушивание событий изменения свойства результата, добавить один или несколько ответчиков к маркеру и добавить дополнительную информацию в виде динамических свойств маркера.
|
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 — размер страницы.
|
mx.rpc:AsyncToken — Этот маркер можно использовать для регистрации одной или более функций обратного вызова с целью получения событий результата или ошибки операции запроса. Этот маркер также возвращается в свойстве call в ResultEvent.RESULT или в FaultEvent.FAULT. Пользовательские данные могут быть присоединены к этому объекту и проанализированы позже во время фазы обработки события.
|
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 — список свойств, которые необходимо изменить.
|
mx.rpc:AsyncToken — Ссылка AsyncToken на маркер, который будет идентифицировать эту операцию в событии результата или ошибки, передаваемом этой службой.
|
Tue Jun 12 2018, 11:34 AM Z