| Пакет | mx.data |
| Класс | public class MessageBatch |
| Наследование | MessageBatch  EventDispatcher Object |
| Реализует | IExternalizable |
| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Adobe Digital Enterprise Platform Data Services for Java EE 3 |
| Версии среды выполнения: | Flash Player 9, AIR 1.1 |
DataStore.currentBatch. Вносимые изменения, например изменения свойств, обнаруженные автоматически через операции привязки данных, createItem(), updateItem() или deleteItem() сохраняются в этом пакете. Текущий список неподтвержденных пакетов хранится в свойстве uncommittedBatches. С помощью вызова createBatch создается новый пакет, который добавляется в конец списка. Этот пакет автоматически становится currentBatch. Подтвердить набор изменений или восстановить предыдущее состояние можно только для одного пакета в конкретный момент времени – в обоих случаях пакет автоматически удаляется из списка uncommittedBatches.
При наличии зависимостей между изменениями подтверждать изменения и восстанавливать предыдущие состояния следует по порядку, т. е. подтверждать изменения для самого старого пакета в списке (uncommittedBatches [0]) и восстанавливать предыдущее состояние для самого последнего пакета (uncommittedBatches [uncommittedBatches.length – 1]).
Свойству commitRequired присваивается значение true при наличии в пакете любых изменений (т. е. при items.length > 0). В этом пакете свойство items сохраняет набор DataMessages.
Пользовательскую информацию можно сохранить в MessageBatch с помощью свойства properties. Пакеты сохраняются или восстанавливаются каждый раз при использовании метода saveCache или автоматически, когда autoSaveCache присвоено значение true при использовании функции автономного режима.
С каждым пакетом через свойство batchMessage связано DataMessage. Если требуется обменяться информацией с сервером (и передается пакетное сообщение серверу), можно сохранить необходимую информацию в заголовках этого сообщения.
Скрыть унаследованные общедоступные свойства
Показать унаследованные общедоступные свойства| Свойство | Определено | ||
|---|---|---|---|
| batchMessage : DataMessage
Это сообщение данных, представляющее пакет, отправляемый серверу. | MessageBatch | ||
| commitRequired : Boolean [только для чтения]
True, если в этом пакете находятся какие-либо изменения. | MessageBatch | ||
 | constructor : Object
Ссылка на объект класса или функцию конструктора для данного экземпляра объекта. | Object | |
| properties : Object = null
Для этого пакета можно установить дополнительный набор определяемых пользователем свойств. | MessageBatch | ||
| Метод | Определено | ||
|---|---|---|---|
Конструктор. | MessageBatch | ||
| addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
Регистрирует объект прослушивателя события на объекте EventDispatcher для получения прослушивателем уведомления о событии. | EventDispatcher | |
Подтверждает изменения в пакете. | MessageBatch | ||
Указывает наличие ожидающих изменений для определенного объекта. | MessageBatch | ||
|
Посылает событие в поток событий. | EventDispatcher | |
Возвращает сообщение с заданным идентификатором. | MessageBatch | ||
|
Проверяет, имеет ли объект EventDispatcher прослушиватели, зарегистрированные для определенного типа события. | EventDispatcher | |
|
Показывает, определено ли заданное свойство для объекта. | Object | |
|
Показывает, есть ли экземпляр класса Object в цепи прототипов объекта, заданного в качестве параметра. | Object | |
|
Показывает наличие заданного свойства и его перечисляемость. | Object | |
Этот метод выполняет десериализацию пакета сообщений. | MessageBatch | ||
|
Удаляет прослушиватель из объекта EventDispatcher. | EventDispatcher | |
Удаляет указанное сообщение из этого пакета. | MessageBatch | ||
Отменяет изменения для этого пакета: все изменения, если элемент не указан, или только изменения для указанного элемента. | MessageBatch | ||
Отменяет изменения для всех элементов в указанной управляемой коллекции. | MessageBatch | ||
|
Задает доступность динамического свойства для операций цикла. | Object | |
|
Возвращает строковое представление этого объекта, отформатированного в соответствии со стандартами, принятыми для данной локали. | Object | |
[переопределить]
Возвращает представление в виде строки для этого объекта | MessageBatch | ||
|
Возвращает элементарное значение заданного объекта. | Object | |
|
Проверяет, зарегистрирован ли прослушиватель события для указанного типа события с данным объектом EventDispatcher или любым его предшественником. | EventDispatcher | |
Этот метод выполняет сериализацию пакета со следующей структурой: numberOfElements:int – общее количество элементов, для которых выполнена сериализация [элемент повторения (один раз для каждого сообщения в пакете)] destination:String – адрес назначения связанного DataService uid:String – UID связанного элемента message:DataMessage – сообщение для связанного изменения. Поскольку в настоящее время сообщение содержит копию элемента, выполнять сериализацию сообщения особым способом не требуется. | MessageBatch | ||
| Константа | Определено | ||
|---|---|---|---|
| items : ArrayCollection
Сохраняет список экземпляров MessageCacheItem, представляющих изменения в пакете. | MessageBatch | ||
batchMessage | свойство |
public var batchMessage:DataMessage| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Adobe Digital Enterprise Platform Data Services for Java EE 3 |
| Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Это информационное сообщение, используемое для представления пакета, отправляемого серверу. В случае необходимости отправки дополнительной информации по отдельным транзакциям для взаимодействия с кодом сервера (предполагается, что он действительно отправляет сообщение, а не преобразует его в клиенте) можно использовать заголовки сообщения.
commitRequired | свойство |
commitRequired:Boolean [только для чтения] | Язык версии: | ActionScript 3.0 |
| Версия продукта: | Adobe Digital Enterprise Platform Data Services for Java EE 3 |
| Версии среды выполнения: | Flash Player 9, AIR 1.1 |
True, если в этом пакете находятся какие-либо изменения. Это привязываемое свойство.
Это свойство можно использовать в качестве источника для связывания данных. При изменении этого свойства отправляется событие propertyChange .
Реализация
public function get commitRequired():Booleanproperties | свойство |
public var properties:Object = null| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Adobe Digital Enterprise Platform Data Services for Java EE 3 |
| Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Для этого пакета можно установить дополнительный набор определяемых пользователем свойств.
MessageBatch | () | Конструктор |
public function MessageBatch()| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Adobe Digital Enterprise Platform Data Services for Java EE 3 |
| Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Конструктор.
commit | () | метод |
public function commit(itemsOrCollections:Array = null, cascadeCommit:Boolean = false):mx.rpc:AsyncToken| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Adobe Digital Enterprise Platform Data Services for Java EE 3 |
| Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Подтверждает изменения в пакете. Как правило, вызывается без аргументов.
Параметры
itemsOrCollections:Array (default = null)itemsOrCollections.
| |
cascadeCommit:Boolean (default = false)true изменения связанных элементов также включены в подтверждение.
|
mx.rpc:AsyncToken — Ссылка AsyncToken на маркер, который будет идентифицировать эту операцию в событии результата или ошибки, передаваемом этой службой.
|
commitRequiredOn | () | метод |
public function commitRequiredOn(item:Object):Boolean| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Adobe Digital Enterprise Platform Data Services for Java EE 3.1 |
| Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Указывает наличие ожидающих изменений для определенного объекта.
Параметры
item:Object — Объект, который может содержать изменения.
|
Boolean — true, если для объекта существуют ожидающие изменения.
|
getMessage | () | метод |
public function getMessage(messageId:String):DataMessage| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Adobe Digital Enterprise Platform Data Services for Java EE 3 |
| Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Возвращает сообщение с заданным идентификатором. Возвращает null, если в этом пакете отсутствует сообщение с заданным идентификатором.
Параметры
messageId:String — идентификатор требуемого сообщения.
|
DataMessage — сообщение с заданным идентификатором. Возвращает null, если в этом пакете отсутствует сообщение с заданным идентификатором.
|
readExternal | () | метод |
public function readExternal(input:IDataInput):void| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Adobe Digital Enterprise Platform Data Services for Java EE 3 |
| Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Этот метод выполняет десериализацию пакета сообщений. Предполагается, что входной поток байтов имеет следующую структуру:
- numberOfElements:int - общее количество сериализованных элементов [повторяемый элемент (однократно для каждого сообщения в пакете)] t]
- destination:String - адрес назначения связанного DataService
- uid:String - UID связанного элемента
- message:DataMessage - сообщение для связанного изменения
Параметры
input:IDataInput — входной поток
|
removeMessage | () | метод |
public function removeMessage(msg:DataMessage):void| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Adobe Digital Enterprise Platform Data Services for Java EE 3 |
| Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Удаляет указанное сообщение из этого пакета.
Параметры
msg:DataMessage — удаляемое сообщение.
|
revertChanges | () | метод |
public function revertChanges(item:IManaged = null):Boolean| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Adobe Digital Enterprise Platform Data Services for Java EE 3 |
| Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Отменяет изменения для этого пакета: все изменения, если элемент не указан, или только изменения для указанного элемента. Как правило, следует отменять изменения в самом последнем пакете, поскольку система не сможет разрешить конфликты или зафиксировать зависимости при отмене более старого изменения, зависящего от последующего изменения.
Параметры
item:IManaged (default = null) |
Boolean — true, если восстановление успешно выполнено.
|
revertChangesForCollection | () | метод |
public function revertChangesForCollection(collection:ListCollectionView):Boolean| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Adobe Digital Enterprise Platform Data Services for Java EE 3 |
| Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Отменяет изменения для всех элементов в указанной управляемой коллекции.
Параметры
collection:ListCollectionView — Восстанавливаемая коллекция.
|
Boolean — true, если восстановление успешно выполнено.
|
toString | () | метод |
override public function toString():String| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Adobe Digital Enterprise Platform Data Services for Java EE 3 |
| Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Возвращает представление в виде строки для этого объекта
ВозвращаетString — Строковое представление этого объекта.
|
writeExternal | () | метод |
public function writeExternal(output:IDataOutput):void| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Adobe Digital Enterprise Platform Data Services for Java EE 3 |
| Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Этот метод сериализует пакет со следующей структурой:
- numberOfElements:int - общее количество сериализованных элементов [повторяемый элемент (однократно для каждого сообщения в пакете)]
- destination:String - адрес назначения связанного DataService
- uid:String - UID связанного элемента
- message:DataMessage - сообщение для связанного изменения
Поскольку сообщение в настоящее время содержит копию элемента, не требуется сериализовать это сообщение специальным способом.
Параметры
output:IDataOutput — объект для записи сериализованных байтов.
|
items | Константа |
public const items:ArrayCollection| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Adobe Digital Enterprise Platform Data Services for Java EE 3 |
| Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Сохраняет список экземпляров MessageCacheItem, представляющих изменения в пакете. Это привязываемое свойство, т. е. можно прослушивать события изменений в этой коллекции с уведомлением о новых изменениях.
Tue Jun 12 2018, 11:34 AM Z