Справочник по ActionScript® 3.0 для платформы Adobe® Flash®
Домашняя страница  |  Скрыть список пакетов и классов |  Пакеты  |  Классы  |  Что нового  |  Указатель  |  Приложения  |  Почему по-английски?
Фильтры: Получение данных с сервера...
Получение данных с сервера...
mx.data 

RPCDataServiceAdapter  - AS3 ADEP Data Services

Пакетmx.data
Классpublic class RPCDataServiceAdapter
НаследованиеRPCDataServiceAdapter Inheritance DataServiceAdapter Inheritance 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
 Inheritedconnected : Boolean
[только для чтения] Возвращает true, если адаптер этой службы подключен к ее источнику.
DataServiceAdapter
 Inheritedconstructor : Object
Ссылка на объект класса или функцию конструктора для данного экземпляра объекта.
Object
  dataManagerRegistry : Object
[статические] Статическое отображение от имени адреса назначения до менеджера данных для этого адреса назначения.
RPCDataServiceAdapter
 InheriteddataStore : 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
 Inherited
Выполняет поиск связанного адаптера службы данных.
DataServiceAdapter
  
getItem(dataManager:RPCDataManager, identity:Object, defaultValue:Object = null, includeSpecifier:PropertySpecifier = null):mx.rpc:AsyncToken
Выполняется для извлечения идентификатором отдельного элемента из адаптера.
RPCDataServiceAdapter
  
Метод адаптера вызывается, если требуется получить список элементов для определенного адреса назначения.
RPCDataServiceAdapter
  
Вызов выполняется после завершения обработки ошибки операции создания, обновления, удаления или обновления коллекции.
RPCDataServiceAdapter
 Inherited
Показывает, определено ли заданное свойство для объекта.
Object
 Inherited
Показывает, есть ли экземпляр класса 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
 Inherited
Показывает наличие заданного свойства и его перечисляемость.
Object
 Inherited
Задает доступность динамического свойства для операций цикла.
Object
  
Вызывается при возникновении ошибки, которая может являться конфликтом со стороны сервера.
RPCDataServiceAdapter
 Inherited
Возвращает строковое представление этого объекта, отформатированного в соответствии со стандартами, принятыми для данной локали.
Object
 Inherited
Возвращает строковое представление заданного объекта.
Object
  
Вызывается, если в коллекцию, управляемую по запросу (не посредством ассоциации) добавлены элементы или если из нее удалены элементы.
RPCDataServiceAdapter
  
updateItem(dataManager:RPCDataManager, item:Object, origItem:Object, changes:Array):mx.rpc:AsyncToken
Этот метод вызывается RPCDataServiceAdapter для выполнения определенной операции createItem.
RPCDataServiceAdapter
 Inherited
Возвращает элементарное значение заданного объекта.
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():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 — [Дополнительно] набор свойств, который необходимо получить.

Возвращает
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 на маркер, который будет идентифицировать эту операцию в событии результата или ошибки, передаваемом этой службой.




[ X ]Почему по-английски?
Содержимое Справочника ActionScript 3.0 отображается на английском языке

Не все части Справочника ActionScript 3.0 переводятся на все языки. Если какой-то текстовый элемент не переведен, он отображается на английском языке. Например, компонент ga.controls.HelpBox не переведен ни на один из языков. Это значит, что в русской версии справки компонент ga.controls.HelpBox будет отображаться на английском языке.