Пакет | mx.data |
Класс | public class DataService |
Наследование | DataService DataManager Object |
Подклассы | DataService |
Язык версии: | ActionScript 3.0 |
Версия продукта: | Adobe Digital Enterprise Platform Data Services for Java EE 3 |
Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Экземпляр DataService создан с указанием требуемого адреса назначения. Адреса назначения обычно настраиваются в services-config.xml, но также могут быть настроены в динамическом режиме с конфигурацией среды выполнения, как в случае разработки на основе модели.
Существуют два разных набора методов, которые извлекают данные из указанного удаленного адреса назначения. Первый набор используется для управляемых объектов коллекции. Второй набор используется для отдельных управляемых объектов.
Метод DataService.fill()
используется для объектов, управляемых коллекцией. Этот метод заполняет ArrayCollection объектами, которыми управляет эта служба.
Чтобы получить объекты с одним управлением, используются методы DataService.getItem()
и DataService.createItem()
.
Если предварительно заполненная коллекция ArrayCollection больше не требуется или элементы в этой коллекции больше не должны получать или создавать обновления, вызовите метод DataService.releaseCollection()
.
Если элемент, для получения которого использовался DataService.getItem()
или DataService.createItem()
, больше не требуется или не должен получать или создавать обновления, вызывается метод DataService.releaseItem()
. Методы DataService.createItem()
и DataService.getItem()
возвращают экземпляр ItemReference, который может использоваться для выпуска определенного экземпляра объекта с одним управлением. В отличие от метода DataService.releaseItem()
, при вызове метода ItemReference.releaseItem()
выпускается определенный экземпляр объекта с одним управлением. Метод DataService.releaseItem()
выпускает первый объект с одним управлением, идентификатор которого соответствует указанному идентификатору. Пока число вызовов методов DataService.getItem()
и DataService.createItem()
совпадает с числом вызовов метода DataService.releaseItem()
, проблем не возникает.
Подключение к удаленному адресу назначения создается автоматически при первом вызове любого метода, для которого требуется подключение. Например, при вызове метода DataService.fill()
или DataService.commit()
с неподтвержденными обновлениями экземпляр DataService пытается установить соединение с удаленным адресом назначения. Для принудительного отключения экземпляра DataService вызывается метод DataService.disconnect()
. Метод DataService.disconnect()
может использоваться для удаления ресурсов, которые больше не требуются, в удаленном адресе назначения. Вызов метода DataService.disconnect
может привести к разрыву соединения, поскольку это физическое соединение могут использовать другие службы.
Привязываемое свойство connected
указывает текущее состояние соответствующего подключения DataService.
Если в удаленном адресе назначения для операции объявлены ограничения системы защиты, необходимо предоставить учетные данные посредством вызова метода DataService.setCredentials()
. Вызов метода DataService.setCredentials()
преобразуется в команду для входа в систему в удаленном адресе назначения. Чтобы изменить учетные данные или объявить недействительным текущий сеанс, вызывается метод DataService.logout()
, который выпускает все локальные управляемые данные. Вызов метода DataService.logout()
эквивалентен вызову метода DataService.release()
.
Каждый экземпляр DataService имеет свойство dataStore
, возвращающее объект типа mx.data.DataStore
. Этот объект сохраняет неподтвержденные изменения для одного или нескольких экземпляров DataService. По умолчанию экземпляр DataService совместно использует один экземпляр DataStore с другими экземплярами DataService, если они контролируют свойства ассоциации и совместно используют один набор каналов. При наличии общего доступа к экземпляру DataStore вызов метода commit()
в одном экземпляре DataService передает изменения во все экземпляры DataService, использующие общедоступный экземпляр DataStore. Это позволяет сохранить порядок операций при наличии зависимостей между изменениями в связанных экземплярах DataService.
Экземпляры DataService и DataStore отправляют события результата и ошибки для всех операций, которые требуют наличия удаленного вызова.
Примечание. При создании двух экземпляров DataService, ссылающихся на тот же самый адрес назначения, оба экземпляра совместно используют одну коллекцию управляемых объектов и передают один набор событий. Например, если добавить прослушиватель событий к одному экземпляру DataService для адреса назначения и использовать другой экземпляр для инициирования операции, то первый экземпляр DataService также будет получать эти события. Каждая операция, инициируемая в экземпляре DataService, возвращает экземпляр AsyncToken. Можно добавить ответчик события к этому экземпляру AsyncToken для получения события результата, определенного для этой операции. При этом подходе часто создается более чистый код, чем при добавлении обработчика событий результата или ошибки для указанного адреса назначения.
Для экземпляра DataService можно использовать привязку данных в свойствах любого управляемого объекта. При совершении удаленной операции для любого управляемого объекта экземпляр DataService также оправляет событие message. Например, когда удаленный процесс обновляет локально управляемый элемент, сообщение передается во все экземпляры DataService, которые управляют этим элементом. Это сообщение передается как событие MessageEvent.MESSAGE
.
Событие конфликта отправляется, если обнаружен конфликт в удаленном адресе назначения после изменения, передаваемого экземпляром DataService, или вследствие изменения, которое конфликтует с локальным неподтвержденным изменением. События конфликта обрабатываются посредством прослушивания DataConflictEvent.CONFLICT
. Привязка данных используется для обновления элементов управления пользовательского интерфейса при связывании свойства DataService.conflicts.resolved
.
Класс DataService поддерживает следующие режимы конфигурирования синхронизации данных:
-
autoCommit
– если true, то каждое изменение при обнаружении немедленно отправляется на удаленный адрес назначения. Еслиfalse
, то необходимо выполнить явный вызов методаcommit()
. Связываемое свойствоDataService.commitRequired
используется при наличии неподтвержденных изменений. -
autoSyncEnabled
– влияет на выполненные вызовыfill()
,getItem()
или вызовы методаcreateItem()
и определяет, прослушивают ли управляемые экземпляры изменения, выполненные в этих объектах другими клиентами, или с помощью сервера DataServiceTransaction помещают API в удаленном адресе назначения. -
autoMerge
– позволяет управлять немедленным применением полученных из удаленного адреса назначения изменений или их постановкой в очередь до выполнения вызова методаDataService.merge()
.
Используйте метод DataService.revertChanges()
, чтобы отменить изменения для определенного элемента или для всех элементов. При возникновении ошибки операции удаленного адреса назначения подтвержденные изменения помещаются в очередь неподтвержденных изменений. Таким образом сохраняется синхронизация этих данных с данными удаленного адреса назначения. Если изменения внесены по ошибке, то для отмены изменений, как правило, выполняется вызов методаDataService.revertChanges()
как элемента обработчика ошибки.
Класс mx.data.mxml.DataService является специфичным для MXML подклассом класса mx.data.DataService, который разрешает привязку к свойствам экземпляра DataService.
Синтаксис MXMLСкрыть синтаксис MXMLThe <mx:DataService> element accepts the following attributes:
<mx:DataService Properties autoCommit="true" autoMerge="true" autoSaveCache="false" autoSyncEnabled="true" conflictDetector="No default." dataStore="No default." destination="No default." pageSize="No default." id="No default." Events conflict="No default." fault="No default." message="No default." propertyChange="No default." result="No default." />
Связанные элементы API
mx.data.Conflicts
mx.data.Conflict
mx.data.ItemReference
mx.data.IManaged
mx.data.utils.Managed
mx.data.IChangeObject
Свойство | Определено | ||
---|---|---|---|
adapter : DataServiceAdapter = null
Экземпляр класса, управляющий взаимодействием с сервером. | DataManager | ||
autoCommit : Boolean
Определяет автоматическое сохранение изменений в локальном кэше. | DataManager | ||
autoConnect : Boolean
Определяет необходимость выполнения службой подключения для требующих этого операций. | DataManager | ||
autoMerge : Boolean
Если установлено значение false передача изменений из удаленного адреса назначения клиенту не влечет немедленного применения изменений. | DataManager | ||
autoSaveCache : Boolean
Локальный кэш данных и изменения можно сохранить на диске. | DataManager | ||
autoSyncEnabled : Boolean
Со значением true запросы fill(), createItem() и getItem() возвращают элементы, прослушивающие обновления для этих элементов из удаленного адреса назначения. | DataManager | ||
cacheID : String
Предоставляет доступ к идентификатору кэша для этой службы. | DataManager | ||
channelSet : ChannelSet
Предоставляет доступ к ChannelSet, используемому данной службой. | DataService | ||
commitRequired : Boolean [только для чтения]
Определяет наличие неподтвержденных изменений и необходимость вызова метода commit(). | DataManager | ||
conflictDetector : ConflictDetector
Предоставляет доступ к текущей реализации, используемой для обнаружения конфликтов в удаленных операциях, передаваемых в этот экземпляр DataManager. | DataManager | ||
conflicts : Conflicts [только для чтения]
Содержит объект Conflicts, представляющий собой ArrayList экземпляров Conflict. | DataManager | ||
connected : Boolean [только для чтения]
Определяет подключение DataService с удаленным адресом назначения. | DataManager | ||
constructor : Object
Ссылка на объект класса или функцию конструктора для данного экземпляра объекта. | Object | ||
dataStore : DataStore
Содержит объект типа mx.data.DataStore. | DataManager | ||
deleteItemOnRemoveFromFill : Boolean
По умолчанию при вызове метода removeItemAt() для управляемой заполненной коллекции на сервер отправляется вызов удаления элемента для физического удаления элемента. | DataManager | ||
destination : String [только для чтения]
Указывает, с каким удаленным адресатом связана эта служба. | DataService | ||
encryptLocalCache : Boolean
Указывает, необходимо ли зашифровать автономное хранилище для клиентов AIR, использующих автономный адаптер SQL. | DataManager | ||
fallBackToLocalFill : Boolean
Этот флаг определяет, будет ли приложение отправлять запрос в локальное хранилище, когда оно не подключено. | DataManager | ||
hierarchicalEventsDefault : Boolean
Ассоциации дополнительно перечисляют события изменений свойств в свойствах связанных экземпляров. | DataManager | ||
ignoreCollectionUpdates : Boolean
Указывает, следует ли игнорировать изменения в управляемых коллекциях вместо того, чтобы отправить их на сервер для подтверждения. | DataManager | ||
indexReferences : Boolean
При наличии небольшого количества заполняемых данных или ссылок на элементы, управляемые этим DataManager из свойств ассоциации других элементов, для настройки скорости приложения установите для этого свойства значение false. | DataManager | ||
isInitialized : Boolean [только для чтения]
Указывает, инициализируются ли метаданные, связанные с этим экземпляром DataManager. | DataManager | ||
manualSync : ManualSyncConfiguration
Обеспечивает доступ к экземпляру ManualSyncConfiguration для каждого экземпляра DataManager. | DataManager | ||
maxFrequency : uint
Определяет максимальное количество сообщений в секунду, которое может получать экземпляр DataManager. | DataManager | ||
mergeRequired : Boolean [только для чтения]
Указывает любые ожидающие изменения, которые должны быть объединены. | DataManager | ||
offlineAdapter : DataServiceOfflineAdapter
Возвращает объект типа mx.data.DataServiceOfflineAdapter. | DataManager | ||
pageSize : int
Предоставляет доступ к текущей настройке размера страницы для всех коллекций. | DataManager | ||
pagingEnabled : Boolean [только для чтения]
Указывает, настроен ли удаленный адрес назначения на возможное выполнение постраничных запросов. | DataManager | ||
priority : int
Приоритет сообщения по умолчанию для сообщений, отправляемых экземпляром DataManager. | DataManager | ||
requestTimeout : int
Предоставляет доступ к тайм-ауту выполнения запроса в секундах для одной операции. | DataManager | ||
resetCollectionOnFill : Boolean
Если свойство имеет значение true, по завершении операции заполнения отправляется событие RESET. | DataManager | ||
resubscribeAttempts : int
Указывает количество попыток, выполняемых отключенным экземпляром DataManager для повторного подписания в адресе назначения. | DataManager | ||
resubscribeInterval : int
Контролирует задержку между попытками повторения подписки в миллисекундах. | DataManager | ||
saveCacheRequired : Boolean [только для чтения]
Определяет наличие несохраненных изменений в локальном кэше и необходимость вызова метода saveCache(). | DataManager | ||
subscribed : Boolean [только для чтения]
Определяет подписку экземпляра DataManager на удаленный адрес назначения. | DataManager | ||
throwItemPendingErrors : Boolean
Значение свойства устанавливается на false для подавления ошибок ожидания элементов при обращении к «ленивым» передаваемым данным или данным без разбиения на страницы. | DataManager |
Метод | Определено | ||
---|---|---|---|
DataService(destination:String)
Создает экземпляр DataService с заданным адресом назначения. | DataService | ||
Удаляет все данные, сохраненные на диске предыдущим вызовом метода saveCache() или если метод autoSaveCache имеет значение true.
| DataManager | ||
Удаляет данные, указанные переданным дескриптором, из локального хранилища. | DataManager | ||
Подтверждает ожидающие изменения для всех коллекций, которыми в настоящее время управляет экземпляр DataStore, связанный с этим экземпляром DataManager. | DataManager | ||
Указывает на наличие ожидающих изменений для определенного объекта. | DataManager | ||
Вызывает попытку установления этой службой соединения с удаленным адресатом. | DataManager | ||
Вызывает метод счета в удаленном адресате. | DataManager | ||
Запрашивает создание указанного элемента в удаленном хранилище. | DataManager | ||
Запрашивает удаление указанного элемента из удаленного хранилища. | DataManager | ||
Отключает сетевое подключение экземпляра DataManager. | DataManager | ||
Выполняет запрос с предоставленным именем и аргументами. | DataManager | ||
Заполняет указанный экземпляр ListCollectionView (коллекции) на основе связанного метода fill для адреса назначения. | DataManager | ||
Заполняет указанный экземпляр ListCollectionView (коллекции) на основе связанного метода fill для адреса назначения. | DataManager | ||
Выполняет запрос, возвращающий отдельный элемент. | DataManager | ||
Возвращает ArrayCollection или отдельный управляемый объект из локального хранилища. | DataManager | ||
getCacheDescriptors(view:ListCollectionView, options:uint = 0, item:Object = null):mx.rpc:AsyncToken
Заполняет указанный экземпляр ListCollectionView (коллекция) экземплярами CacheDataDescriptor. | DataManager | ||
Заполняет указанный экземпляр ListCollectionView (коллекция) всеми идентификаторами кэша, которые использовались в приложении. | DataManager | ||
Выполняет асинхронный запрос для элемента, соответствующего указанному идентификатору. | DataManager | ||
Выполняет поиск предоставленного элемента с указанным идентификатором. | DataManager | ||
Возвращает информацию о странице для указанной коллекции. | DataManager | ||
Возвращает для указанного элемента ожидающую операцию в кэше сообщений. | DataManager | ||
Показывает, определено ли заданное свойство для объекта. | Object | ||
Вызывает инициализацию DataStore. | DataManager | ||
Возвращает true, если передаваемая коллекция подлежит управлению с помощью этой службы. | DataManager | ||
Возвращает true, если передаваемая коллекция используется в функции подкачки страниц. | DataManager | ||
Показывает, есть ли экземпляр класса Object в цепи прототипов объекта, заданного в качестве параметра. | Object | ||
Возвращает значение true, если весь диапазон элементов разбит на страницы. | DataManager | ||
Заполняет указанный ListCollectionView на основе связанных элементов <fill-method> с учетом данных из локального хранилища. | DataManager | ||
Регистрирует пользователя за пределами адреса назначения для DataService. | DataService | ||
Объединяет любые отложенные обновления в управляемый набор объектов. | DataManager | ||
Показывает наличие заданного свойства и его перечисляемость. | Object | ||
Обновляет все данные, контролируемые этим экземпляром DataManager. | DataManager | ||
Обновляет коллекцию, ранее заполненную методом fill или управляемую как зависимая ассоциация. | DataManager | ||
Отменяет управление всеми коллекциями и элементами для экземпляра DataManager. | DataManager | ||
releaseCollection(view:ListCollectionView, clear:Boolean = false, copyStillManagedItems:Boolean = true):void
Отменяет управление любым элементом из указанной коллекции с помощью этого экземпляра DataManager. | DataManager | ||
releaseItem(item:IManaged, copyStillManagedItems:Boolean = true, enableStillManagedCheck:Boolean = true):IManaged
Отменяет управление указанным элементом с помощью этого экземпляра DataManager. | DataManager | ||
Удаляет из коллекции диапазон элементов. | DataManager | ||
Отменяет значение для ассоциации в виде отдельного значения. | DataManager | ||
Отменяет любые не подтвержденные изменения указанного элемента. | DataManager | ||
Отменяет изменения для любого элемента указанной коллекции, управляемой этим экземпляром DataManager. | DataManager | ||
Этот метод сохраняет текущее состояние кэша экземпляра DataManager. | DataManager | ||
Указывает наличие ожидающих изменений для определенного объекта, которые не сохранены в локальном кэше. | DataManager | ||
Настраивает учетные данные для этого адреса назначения DataService. | DataService | ||
Задает доступность динамического свойства для операций цикла. | Object | ||
Настраивает учетные данные для третьей стороны адреса назначения этого DataService. | DataService | ||
Получает измененные элементы для всех предварительно выполненных заливок в этой службе данных (менеджере данных). | DataManager | ||
[статические]
Стандартный метод синхронизации всех локальных данных: synchronizeAllFills() вызывается в каждой указанной службе данных (менеджере данных) и маркер окончательного результата завершается только после завершения вызовов всех отдельных synchronizeAllFills(). | DataManager | ||
Получает измененные элементы, которые изменились на сервере со времени предыдущего вызова fill или synchronizeFill. | DataManager | ||
Возвращает строковое представление этого объекта, отформатированного в соответствии со стандартами, принятыми для данной локали. | Object | ||
Возвращает строковое представление заданного объекта. | Object | ||
Инициирует обновление для указанного элемента. | DataManager | ||
Возвращает элементарное значение заданного объекта. | Object |
Событие | Сводка | Определено | ||
---|---|---|---|---|
Событие DataConflictEvent.CONFLICT передается при обнаружении конфликта между ожидающими изменениями на стороне этого клиента и изменениями, переданными другим клиентом, или если изменения, переданные этим клиентом, конфликтуют с изменениями в удаленном адресе назначения. | DataService | |||
Событие DataServiceFaultEvent.FAULT передается, если вызов службы невозможен из-за ошибки. | DataService | |||
Событие MessageEvent.MESSAGE передается, если удаленный адрес назначения инициирует уведомление об операции данных. | DataService | |||
Событие PropertyChangeEvent.PROPERTY_CHANGE передается при изменении свойства этой службы. | DataService | |||
Событие ResultEvent.RESULT передается при успешном возврате вызова службы. | DataService |
channelSet | свойство |
channelSet:ChannelSet
Язык версии: | ActionScript 3.0 |
Версия продукта: | Adobe Digital Enterprise Platform Data Services for Java EE 3 |
Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Предоставляет доступ к ChannelSet, используемому данной службой. ChannelSet может быть создан и присвоен вручную или динамически – для использования настроенных каналов со значением destination
этой службы.
Реализация
public function get channelSet():ChannelSet
public function set channelSet(value:ChannelSet):void
destination | свойство |
destination:String
[только для чтения] Язык версии: | ActionScript 3.0 |
Версия продукта: | Adobe Digital Enterprise Platform Data Services for Java EE 3 |
Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Указывает, с каким удаленным адресатом связана эта служба.
Реализация
public function get destination():String
DataService | () | Конструктор |
public function DataService(destination:String)
Язык версии: | ActionScript 3.0 |
Версия продукта: | Adobe Digital Enterprise Platform Data Services for Java EE 3 |
Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Создает экземпляр DataService с заданным адресом назначения. Имя адреса назначения должно представлять собой адрес назначения, определенный в файле конфигурации LiveCycle Data Service или в конфигурации среды выполнения.
Параметрыdestination:String — содержащая имя требуемого адреса назначения.
|
logout | () | метод |
public function logout():void
Язык версии: | ActionScript 3.0 |
Версия продукта: | Adobe Digital Enterprise Platform Data Services for Java EE 3 |
Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Регистрирует пользователя за пределами адреса назначения для DataService. Выход из адреса назначения применяется для всех подключений, использующих одинаковый ChannelSet, указанный в конфигурации сервера. Например, при подключении по каналу my-rtmp и выходе из системы с помощью одного из экземпляров DataService выход будет выполнен для всех подключений по этому ChannelSet.
Примечание. Adobe рекомендует вместо этого метода использовать метод mx.messaging.ChannelSet.logout().
Связанные элементы API
setCredentials | () | метод |
public function setCredentials(username:String, password:String):void
Язык версии: | ActionScript 3.0 |
Версия продукта: | Adobe Digital Enterprise Platform Data Services for Java EE 3 |
Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Настраивает учетные данные для этого адреса назначения DataService. Учетные данные применяются ко всем службам, подключенным по одному ChannelSet.
Параметры
username:String — Имя пользователя для адреса назначения.
| |
password:String — Пароль для адреса назначения.
|
setRemoteCredentials | () | метод |
public function setRemoteCredentials(username:String, password:String):void
Язык версии: | ActionScript 3.0 |
Версия продукта: | Adobe Digital Enterprise Platform Data Services for Java EE 3 |
Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Настраивает учетные данные для третьей стороны адреса назначения этого DataService.
Параметры
username:String — Имя пользователя для адреса назначения.
| |
password:String — Пароль для адреса назначения.
|
conflict | Событие |
mx.data.events.DataConflictEvent
свойство DataConflictEvent.type =
mx.data.events.DataConflictEvent.CONFLICT
Язык версии: | ActionScript 3.0 |
Версия продукта: | Adobe Digital Enterprise Platform Data Services for Java EE 3 |
Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Событие DataConflictEvent.CONFLICT
передается при обнаружении конфликта между ожидающими изменениями на стороне этого клиента и изменениями, переданными другим клиентом, или если изменения, переданные этим клиентом, конфликтуют с изменениями в удаленном адресе назначения. Каждый экземпляр DataService передает события конфликта только для элементов этого адреса назначения.
Используйте событие конфликта на DataService, если требуется одновременно обработать конфликты для набора связанных адресов назначения.
КонстантаCONFLICT
определяет значение свойства type
объекта события conflict
.
Свойства объекта события имеют следующие значения:
Свойство | Значение |
---|---|
bubbles | false |
cancelable | false |
currentTarget | Объект, определяющий прослушиватель события, который выполняет обработку события. Например, если используется myButton.addEventListener() для регистрации прослушивателя события, значением currentTarget является myButton. |
conflict | Объект Conflict, содержащий возникший конфликт. |
message | Сообщение, связанное с этим событием. |
target | Объект, отправивший событие. Это не всегда тот объект, который прослушивает событие. Свойство currentTarget всегда используется для получения доступа к объекту, прослушивающему событие. |
fault | Событие |
mx.data.events.DataServiceFaultEvent
свойство DataServiceFaultEvent.type =
mx.data.events.DataServiceFaultEvent.FAULT
Язык версии: | ActionScript 3.0 |
Версия продукта: | Adobe Digital Enterprise Platform Data Services for Java EE 3 |
Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Событие DataServiceFaultEvent.FAULT
передается, если вызов службы невозможен из-за ошибки. Например, при вызове метода fill()
передается это событие, если выполнить вызов не удается. Это событие выполняется для каждого элемента, который создает ошибку как элемент результата подтверждения. В этом случае DataServiceFaultEvent будет содержать маркер, возвращенный подтверждением, однако при возникновении ошибки строки элемента и сообщения об ошибке являются специфичными для элемента, инициировавшего ошибку.
FAULT
определяет значение свойства type
объекта события fault
.
Свойства объекта события имеют следующие значения:
Свойство | Значение |
---|---|
bubbles | false |
cancelable | true, вызов preventDefault()из метода responder.fault связанного маркера приводит к предотвращению передачи этого события службой или операцией |
currentTarget | Объект, определяющий прослушиватель события, который выполняет обработку события. Например, если используется myButton.addEventListener() для регистрации прослушивателя события, значением currentTarget является myButton. |
fault | Объект ошибки, содержащий возникший конфликт. |
item | Элемент, сгенерировавший ошибку. |
identity | Идентификатор элемента, сгенерировавшего ошибку. |
message | Сообщение, связанное с этим событием. |
token | Маркер, представляющий вызов метода. Используется в образце асинхронного маркера выполнения. |
target | Объект, отправивший событие. Это не всегда тот объект, который прослушивает событие. Свойство currentTarget всегда используется для получения доступа к объекту, прослушивающему событие. |
message | Событие |
mx.messaging.events.MessageEvent
свойство MessageEvent.type =
mx.messaging.events.MessageEvent.MESSAGE
Язык версии: | ActionScript 3.0 |
Версия продукта: | Adobe Digital Enterprise Platform Data Services for Java EE 3 |
Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Событие MessageEvent.MESSAGE
передается, если удаленный адрес назначения инициирует уведомление об операции данных. Например, если данные обновляются в удаленном адресе назначения, операция обновления передается для прослушивания всех клиентов и преобразуется в событие сообщения на этом экземпляре DataService.
Значением этой константы является message
.
Свойства объекта события имеют следующие значения:
Свойство | Значение |
---|---|
bubbles | false |
cancelable | false |
currentTarget | Объект, определяющий прослушиватель события, который выполняет обработку события. Например, если используется myButton.addEventListener() для регистрации прослушивателя события, значением currentTarget является myButton. |
message | Сообщение, связанное с этим событием. |
target | Объект, отправивший событие. Это не всегда тот объект, который прослушивает событие. Свойство currentTarget всегда используется для получения доступа к объекту, прослушивающему событие. |
propertyChange | Событие |
mx.events.PropertyChangeEvent
свойство PropertyChangeEvent.type =
mx.events.PropertyChangeEvent.PROPERTY_CHANGE
Язык версии: | ActionScript 3.0 |
Версия продукта: | Adobe Digital Enterprise Platform Data Services for Java EE 3 |
Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Событие PropertyChangeEvent.PROPERTY_CHANGE
передается при изменении свойства этой службы. Этот процесс выполняется для следующих свойств:
commitRequired
mergeRequired
connected
PropertyChangeEvent.PROPERTY_CHANGE
определяет значение свойства type
объекта события PropertyChange
.
Свойства объекта события имеют следующие значения:
Свойство | Значение |
---|---|
bubbles | Определяется конструктором; по умолчанию содержит значение false. |
cancelable | Определяется конструктором; по умолчанию содержит значение false. |
kind | Вид изменения; PropertyChangeEventKind.UPDATE или PropertyChangeEventKind.DELETE. |
oldValue | Исходное значение свойства. |
newValue | Новое значение свойства, если имеется. |
property | Измененное свойство. |
source | Объект, содержащий измененное свойство. |
currentTarget | Объект, определяющий прослушиватель события, который выполняет обработку события. Например, если используется myButton.addEventListener() для регистрации прослушивателя события, значением currentTarget является myButton. |
target | Объект, отправивший событие. Это не всегда тот объект, который прослушивает событие. Свойство currentTarget всегда используется для получения доступа к объекту, прослушивающему событие. |
result | Событие |
mx.rpc.events.ResultEvent
свойство ResultEvent.type =
mx.rpc.events.ResultEvent.RESULT
Язык версии: | ActionScript 3.0 |
Версия продукта: | Adobe Digital Enterprise Platform Data Services for Java EE 3 |
Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Событие ResultEvent.RESULT
передается при успешном возврате вызова службы. Например, при вызове метода fill()
передается это событие, если вызов успешно выполнен.
Свойства объекта события имеют следующие значения:
Свойство | Значение |
---|---|
bubbles | false |
cancelable | true, preventDefault() из метода связанного маркера responder.result предотвращает передачу этого события операцией или службой |
currentTarget | Объект, определяющий прослушиватель события, который выполняет обработку события. Например, если используется myButton.addEventListener() для регистрации прослушивателя события, значением currentTarget является myButton. |
message | Сообщение, связанное с этим событием. |
target | Объект, отправивший событие. Это не всегда тот объект, который прослушивает событие. Свойство currentTarget всегда используется для получения доступа к объекту, прослушивающему событие. |
result | Результат, возвращаемый вызовом RPC. |
token | Маркер, представляющий отдельный вызов метода. Используется в образце асинхронного маркера выполнения. |
Tue Jun 12 2018, 11:34 AM Z