DataManager  - AS3 ADEP Data Services

Экземпляр класса, управляющий взаимодействием с сервером.

Определяет автоматическое сохранение изменений в локальном кэше. Подтвержденные изменения сразу же передаются в удаленную службу.

Для экземпляров DataService, которые представляют собой менеджеры данных, используемые для службы управления данными на стороне сервера, в качестве значения по умолчанию используется true.

False является значением по умолчанию для экземпляров RPCDataManager, которые представляют собой менеджеры данных, обеспечивающие функциональность управления данными на стороне клиента для компонентов службы RPC, например RemoteObject, HTTPMultiService и WebService.

Определяет необходимость выполнения службой подключения для требующих этого операций. Такие операции, как fill(), getItem() и count() будут пытаться установить соединение, если служба отключена, и параметр autoConnect имеет значение true. Это свойство используется для контролирования поведения непостоянно подключающихся приложений.

Значением по умолчанию является true.

Если установлено значение false передача изменений из удаленного адреса назначения клиенту не влечет немедленного применения изменений. Вместо этого свойство mergeRequired устанавливается на значение true.

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

Для объединения изменений следует вызвать метод merge() и применить его ко всем изменениям.

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

Если активирована подкачка страниц, все запросы нелокальных элементов кэшируются до вызова merge(). После вызова merge() все кэшированные запросы обрабатываются.

Значением по умолчанию является true.

Локальный кэш данных и изменения можно сохранить на диске. Если при каждом изменении или возврате удаленного запроса свойство autoSaveCache имеет значение true, эти данные сохраняются на диск. Если при сохранении возникнет проблема из-за переполненного диска или отказа в разрешении на запись, будет передано событие FaultEvent или возвращено Fault.

Определение этого значения как false (по умолчанию) не сохраняет данные или изменения на диске. Для инициации сохранения текущих данных и изменений на диск используется метод saveCache().

Значением по умолчанию является false.

Связанные элементы API

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

Также следует отметить, что при смешении коллекций, полученных с помощью autoSyncEnabled и заполненных без autoSyncEnabled, любые повторяющиеся в коллекциях элементы по-прежнему будут получать события обновления.

Значением по умолчанию является true.

Предоставляет доступ к идентификатору кэша для этой службы. Идентификатор кэша должен быть настроен до выполнения любой операции, требующей взаимодействия с данными, сохраненными на локальном диске. Если идентификатор кэша не настроен, все методы кэша и свойства считаются противоречивыми, и в течение выполнения операции выдается ошибка DataServiceError, требующая данные с локального диска. Это свойство предоставляет уникальный идентификатор «сеанса» для сохраненных на локальном диске данных. Это свойство должно быть определено разработчиком как уникальное значение для приложения.

Значение null или пустая строка считаются неустановленным значением. При запросе данных такими методами, как fill() и getItem(), первоначальное обращение будет к данным на локальном диске, если установлен cacheID. Если cacheID не установлен, попытки обращения к данным на локальном диске не выполняются.

Определяет наличие неподтвержденных изменений и необходимость вызова метода commit(). При изменении этого свойства передается событие. В приложении это свойство может использоваться для обеспечения визуальной обратной связи.

Это свойство можно использовать в качестве источника для связывания данных. При изменении этого свойства отправляется событие propertyChange .

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

Содержит объект Conflicts, представляющий собой ArrayList экземпляров Conflict.

Конфликты должны быть устранены до вызова метода commit(). Конфликты могут быть разрешены путем просмотра конфликтов и решения каждого конфликта по отдельности или вызовом метода acceptAllClient() или acceptAllServer() для этого свойства.

Это свойство можно использовать в качестве источника для связывания данных. При изменении этого свойства отправляется событие propertyChange .

Определяет подключение DataService с удаленным адресом назначения.

Это свойство можно использовать в качестве источника для связывания данных. При изменении этого свойства отправляется событие propertyChange .

Содержит объект типа mx.data.DataStore. Экземпляр DataStore контролирует набор входящих и исходящих изменений для одного или нескольких экземпляров DataManager, которые могут иметь ссылки. При сохранении в хранилище DataStore подтверждаются все ожидающие изменения каждого DataManager, использующего этот DataStore.

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

Это свойство можно использовать в качестве источника для связывания данных. При изменении этого свойства отправляется событие propertyChange .

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

Обратите внимание, что это не влияет на коллекции, которые являются ассоциациями. Задействуются только те коллекции, которые использовались с методом fill().

Значением по умолчанию является true.

Указывает, необходимо ли зашифровать автономное хранилище для клиентов AIR, использующих автономный адаптер SQL.

Для клиентов Flex, основанных на браузере, невозможно зашифровать автономные данные.

Этот флаг определяет, будет ли приложение отправлять запрос в локальное хранилище, когда оно не подключено. Если в установках автономного адаптера определена поддержка динамического выполнения запросов, по умолчанию при вызове fill() не будет отправляться запрос в локальное хранилище, если приложение не подключено. Если для fallBackToLocalFill установлено значение true, то также отправляется запрос в локальное хранилище, если приложение не подключено.

Это свойство можно использовать в качестве источника для связывания данных. При изменении этого свойства отправляется событие propertyChange .

Ассоциации дополнительно перечисляют события изменений свойств в свойствах связанных экземпляров. Это значение можно установить в ассоциации с атрибутом настройки hierarchical-events. Если атрибут hierarchical-events не установлен, ассоциации для указанного адреса назначения используют это свойство с целью определения значения по умолчанию.

Значение по умолчанию false. Для объектов, представленных в виде дерева (а не циклического графика), может потребоваться указание значения true для стандартного адреса назначения. Если свойства пользовательских свойств используются в средстве визуализации элементов в качестве экземпляра, определение значения true для свойства ассоциации будет вызывать обновление сетки при изменении этих свойств. Благодаря интеллектуальной системе предотвращается отправка рекурсивных событий или создание больших цепочек событий, например parent.child[0].child[1].child[3].

Значением по умолчанию является false.

Указывает, следует ли игнорировать изменения в управляемых коллекциях вместо того, чтобы отправить их на сервер для подтверждения.

Значением по умолчанию является false.

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

Указывает, инициализируются ли метаданные, связанные с этим экземпляром DataManager.

Это свойство можно использовать в качестве источника для связывания данных. При изменении этого свойства отправляется событие propertyChange .

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

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

Значение по умолчанию равно 0, что означает отсутствие установки для скорости передачи сообщений в DataManager. Обратите внимание, что это свойство должно быть установлено до выполнения подписки через DataManager, а любые изменения после подписки не будут действовать до отмены предыдущей подписки и создания через DataManager новой подписки.

Значением по умолчанию является 0.

Указывает любые ожидающие изменения, которые должны быть объединены.

Это свойство можно использовать в качестве источника для связывания данных. При изменении этого свойства отправляется событие propertyChange .

Возвращает объект типа mx.data.DataServiceOfflineAdapter. Автономный адаптер управляет реализацией сохраняемости объектов в локальном хранилище (SQLLite/LSO).

Предоставляет доступ к текущей настройке размера страницы для всех коллекций.

Указывает, настроен ли удаленный адрес назначения на возможное выполнение постраничных запросов.

Приоритет сообщения по умолчанию для сообщений, отправляемых экземпляром DataManager. Допустимы значения от 0 до 9 (0 является минимальным), -1 означает, что экземпляр DataManager не имеет установленного приоритета. Обратите внимание, что, если сообщение уже имеет определенный приоритет, эта настройка является более важной.

Предоставляет доступ к тайм-ауту выполнения запроса в секундах для одной операции. Если значение меньше или равно нулю, тайм-аут запроса не применяется. При наступлении тайм-аута выполнения текущей операции из-за превышения лимита requestTimeout для операции будет передан сбой с указанием тайм-аута выполнения запроса. Обратите внимание, что по истечении выполнения операции сервер может фактически получить операцию. При этом состояние клиента может оставаться без синхронизации с сервером.

Если свойство имеет значение true, по завершении операции заполнения отправляется событие RESET. При значении false свойства отправляются только инкрементные события ADD/REMOVE для каждого элемента, возвращенного в результате заполнения. Установка этого свойства влияет на любые инициированные заполняемые данные. Его изменение после начала заполнения не повлияет на поведение незаполненных данных.

Значением по умолчанию является true.

Указывает количество попыток, выполняемых отключенным экземпляром DataManager для повторного подписания в адресе назначения. Значение по умолчанию -1 означает постоянное выполнение попыток повторения подписки до подключения клиента.

Значением по умолчанию является -1.

Контролирует задержку между попытками повторения подписки в миллисекундах. Значение по умолчанию составляет 5000, т. е. попытка повторной подписки каждые 5 секунд.

Значением по умолчанию является 5000.

Определяет наличие несохраненных изменений в локальном кэше и необходимость вызова метода saveCache(). Этот метод может возвратить false, тогда как метод commitRequired возвратил бы true, указывая, что изменения сохранены в локальном кэше, но не переданы на сервер.

Это свойство можно использовать в качестве источника для связывания данных. При изменении этого свойства отправляется событие propertyChange .

Определяет подписку экземпляра DataManager на удаленный адрес назначения.

Это свойство можно использовать в качестве источника для связывания данных. При изменении этого свойства отправляется событие propertyChange .

Значение свойства устанавливается на false для подавления ошибок ожидания элементов при обращении к «ленивым» передаваемым данным или данным без разбиения на страницы. Вместо получения ошибки будет возвращаться null для значения свойства или выполняться вызов getItemAt() в ArrayCollection.

Метод size() возвращает 0 элементов для списка, данные о размере которого еще не были получены с сервера. Если элемент возвращается с сервера, отправляются соответствующие события PropertyChangeEvent и CollectionEvent.

Создает экземпляр объекта DataService с указанным адресом назначения. Адресат должен быть ссылкой на адрес назначения, сконфигурированный в файле services-config.xml.

Ставит в очередь ошибку, если этот менеджер данных еще не был инициализирован.

Удаляет все данные, сохраненные на диске предыдущим вызовом метода saveCache() или если метод autoSaveCache имеет значение true.

Параметры

Удаляет данные, указанные переданным дескриптором, из локального хранилища.

Параметры

Подтверждает ожидающие изменения для всех коллекций, которыми в настоящее время управляет экземпляр DataStore, связанный с этим экземпляром DataManager. Вызов этого метода эквивалентен вызову метода dataStore.commit().

Если значение свойства autoCommit равно true, транзакции не используются, и вызов этого метода не требуется. Для использования транзакций необходимо присвоить свойству autoCommit значение false и явно вызвать этот метод для подтверждения пакета изменений.

Как правило, для подтверждения всех ожидающих изменений вызывается commit() без аргументов. Для подтверждения части ожидающих изменений можно предоставить дополнительные аргументы. Перед подтверждением изменений для любого элемента в DataStore необходимо разрешить все ожидающие обработки конфликты.

Если в ассемблере use-transactions присвоено значение true, то все изменения подтверждаются атомарно. Если какая-либо операция завершается неуспешно, не применяется ни одна из операций пакета. Если use-transactions имеет значение false, то каждая операция подтверждается отдельно и при возникновении отказа обработка прекращается. Все изменения, находящиеся в пакете до произошедшей ошибки, применяются, все изменения, находящиеся в пакете после произошедшей ошибки, не применяются. Если во время обработки пакета произошла ошибка, изменения снова помещаются в очередь неподтвержденных изменений. Для удаления вызвавших ошибку изменений необходимо вызвать revertChanges.

По умолчанию метод commit подтвердит все ожидающие изменения для всех созданных, модифицированных и удаленных элементов этого DataStore. Если требуется подтвердить только часть этих изменений, можно указать комбинацию управляемых экземпляров ArrayCollection и/или управляемых элементов, определяющую подмножество изменений, которые следует включить в пакет. Для каждой указанной коллекции массивов подтверждаются любые изменения, внесенные или в членство или в порядок элементов в этой коллекции массивов, а также в элементы этой коллекции массивов. Можно также указать список отдельных управляемых элементов, что позволит подтвердить изменения только для этих элементов. Если в параметре itemsOrCollections указать какие-либо объекты, не являющиеся управляемыми коллекциями или элементами, то возникнет ошибка DataServiceError.

Если используется параметр itemsOrCollections, и у элементов имеются свойства связи, ссылающиеся на другие элементы, то можно использовать параметр cascadeCommit для проверки включения в пакет изменений, вносимых в связанные элементы. Например, если указывается элемент группы в параметре элементов, и экземпляр группы имеет свойство members, которое ссылается на список экземпляров лица при значении true для cascadeCommit, то изменения для любого экземпляра лица также будут включены в набор подтверждаемых изменений. Если cascadeCommit имеет значение false, то будут включены изменения только для группы. Для гарантированного включения в пакет любых зависимых изменений следует использовать cascadeCommit=true.

Параметры

Указывает на наличие ожидающих изменений для определенного объекта. Разрешает структурированное использование возможностей пользовательского интерфейса. (для получения уведомлений см. commitRequired для связываемых свойств).

Параметры

Вызывает попытку установления этой службой соединения с удаленным адресатом. Этот метод может использоваться совместно со свойством autoConnect и методом disconnect() для управления состоянием соединения.

Вызывает метод счета в удаленном адресате. Вызванный метод счета основан на связанных тегах <count-method> и передаваемых параметрах. Например, если был выполнен следующий вызов count("firstName", "Bob"), и теги <count-method> существуют или на них существует ссылка в services-config.xml под связанным адресатом:

            <count-method>
                <name>getCount</name>
                <params>java.lang.String,java.lang.String</params>
                <security-run-as name="freddie" password="nightmare" />
            </count-method>
     
            <count-method>
                <name>getCount</name>
                <security-constraint ref="sample-users" />
            </count-method>
      

Параметры

Связанные элементы API

Запрашивает создание указанного элемента в удаленном хранилище. При возникновении ошибки передается событие DataConflictEvent.

Параметры

Запрашивает удаление указанного элемента из удаленного хранилища. При возникновении ошибки передается событие DataConflictEvent.

Параметры

Отключает сетевое подключение экземпляра DataManager. Этот метод не ожидает завершения сетевых операций в очереди.

Выполняет запрос с предоставленным именем и аргументами. Как правило, этот метод используется с экземпляром RPCDataManager, в котором запросы имеют определенное имя. Этот метод можно также применять для запросов, определенных с использованием более общего подхода к методу заполнения, если первый параметр метода заполнения является строковым значением. В качестве первого параметра заполнения используется queryName.

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

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

Параметры

Заполняет указанный экземпляр ListCollectionView (коллекции) на основе связанного метода fill для адреса назначения. Например, в адресе назначения LiveCycle Data Services, который использует ассемблер Hibernate, первым параметром метода fill() является коллекция для заполнения, второй параметр представлен запросом Hibernate на выполнение, в то время как все остальные параметры являются параметрами запросов Hibernate. Аналогичный формат применяется к методам fill(), используемым в классах оболочки служб для разработки на основе модели.

В следующем примере представлен метод fill() для адреса назначения, который использует ассемблер Hibernate. Ассемблер получил запрос с именем getByDescription, который принимает параметр запроса с именем description:

     ProductService.fill(ac, "getByDescription", description);
     

Для адреса назначения LiveCycle Data Services, использующего подход fill-method, в котором объявляются методы заполнения в элементах XML в конфигурации адреса назначения, если следующие элементы <fill-method> находятся в конфигурации адреса назначения:

            <fill-method>
                <name>loadPersons</name>
                <params>java.lang.String,java.lang.String</params>
            </fill-method>
     
            <fill-method>
                <name>loadPersons</name>
                <security-constraint ref="sample-users" />
            </fill-method>
      

Параметры

Заполняет указанный экземпляр ListCollectionView (коллекции) на основе связанного метода fill для адреса назначения. В каждом объекте заполняется только подмножество свойств, как указано в параметре propertySpecifier.

Параметры

Выполняет запрос, возвращающий отдельный элемент.

Параметры

Возвращает ArrayCollection или отдельный управляемый объект из локального хранилища. Вызов этого метода не обновляет последнее время доступа.

Параметры

Заполняет указанный экземпляр ListCollectionView (коллекция) экземплярами CacheDataDescriptor. Если аргументы не указаны, возвращаются все связанные экземпляры CacheDataDescriptor кэшированных данных в этой службе.

Параметры

Заполняет указанный экземпляр ListCollectionView (коллекция) всеми идентификаторами кэша, которые использовались в приложении.

Параметры

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

Параметры

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

Параметры

Возвращает информацию о странице для указанной коллекции.

Параметры

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

Параметры

Вызывает инициализацию DataStore.

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

Параметры

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

Параметры

Возвращает значение true, если весь диапазон элементов разбит на страницы. В противном случае возвращает false.

Параметры

Заполняет указанный ListCollectionView на основе связанных элементов <fill-method> с учетом данных из локального хранилища. Он вызывает API offlineAdapter.executeOfflineQuery() для запроса данных и не будет выполнять отправлять запрос в удаленный адрес назначения, даже если приложение подключено. Этот способ используется в случаях, когда данные синхронизируются в клиенте и локальные запросы выполняются на основе этих данных.

Параметры

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

Обновляет все данные, контролируемые этим экземпляром DataManager. Заполнения, запросы на получение элементов и запросы на получение страниц создаются на сервере для повторного получения всех управляемых элементов. Метод DataStore.refresh() используется также для обновления всех связанных элементов ассоциаций lazy = true.

Обновляет коллекцию, ранее заполненную методом fill или управляемую как зависимая ассоциация. Этот метод посылает запрос на сервер и получает новую версию любых резидентных элементов коллекции с помощью параметров заполнения, изначально используемых с этой коллекцией, или путем получения свойства из вышестоящего элемента. При обнаружении какого-либо изменения выполняется объединение в коллекцию в инкрементном режиме.

Параметры

Отменяет управление всеми коллекциями и элементами для экземпляра DataManager.

Параметры

Связанные элементы API

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

Параметры

Отменяет управление указанным элементом с помощью этого экземпляра DataManager. При использовании экземпляра ItemReference вызовите метод releaseItem() для экземпляра ItemReference, чтобы убедиться в отправке соответствующей ссылки, если вызвано более одного getItem(), который получает аналогичный элемент из различных частей клиентского приложения.

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

Параметры

Удаляет из коллекции диапазон элементов. При просмотре большой коллекции может возникнуть необходимость освобождения занимаемых элементами ресурсов и прекращения подписки на обновления для этих элементов. Для этого следует указать startIndex первого отменяемого элемента и количество отменяемых элементов. Если элемент в этой позиции еще не разбит на страницы, этот индекс пропускается.

Параметры

Отменяет значение для ассоциации в виде отдельного значения. Если значение не разбито на страницы, возвращается значение false. Если значение разбито на страницы, эта ссылка отменяется, и возвращается значение true. Если это была последняя ссылка на определенный элемент, следующая попытка получения доступа к тому элементу вызовет ItemPendingError и появится необходимость получения значения заново.

Параметры

Отменяет любые не подтвержденные изменения указанного элемента. Если элемент отсутствует, отменяет все неподтвержденные изменения. При отмене операции создания элемент удаляется. При отмене операции удаления элемент снова добавляется. Отмена обновления восстанавливает первоначальные свойства элемента, определенные до внесения изменений. Вызов этого метода эквивалентен вызову метода dataStore.revertChanges().

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

Если получен элемент без изменений, этот метод вернет значение false. Если элемент не получен, и изменения отсутствуют, этот метод вернет значение false. В противном случае будет получено значение true.

Параметры

Отменяет изменения для любого элемента указанной коллекции, управляемой этим экземпляром DataManager.

Параметры

Этот метод сохраняет текущее состояние кэша экземпляра DataManager. Кэш включает содержащиеся в памяти элементы и изменения, внесенные в эти элементы и не переданные удаленному адресату.

Параметры

Связанные элементы API

         var customerService:DataService = new DataService("customers");
         var customers:ArrayCollection = new ArrayCollection();
         customerService.fill(customers);
         // ...
         var customer:Customer = Customer(customers[0]);
         customer.priority = "top";
         customerService.saveCache();
         // now all of the changes and items in the customers collection
         // will be persisted locally
      

Указывает наличие ожидающих изменений для определенного объекта, которые не сохранены в локальном кэше. Этот метод может возвратить false, тогда как метод commitRequiredOn возвратил бы true, указывая, что изменение сохранено в локальном кэше, но не передано на сервер.

Параметры

Получает измененные элементы для всех предварительно выполненных заливок в этой службе данных (менеджере данных).

Стандартный метод синхронизации всех локальных данных: synchronizeAllFills() вызывается в каждой указанной службе данных (менеджере данных) и маркер окончательного результата завершается только после завершения вызовов всех отдельных synchronizeAllFills().

Параметры

Получает измененные элементы, которые изменились на сервере со времени предыдущего вызова fill или synchronizeFill. К ним относятся созданные, обновленные и удаленные элементы. Если заливка предварительно не выполнялась, операция эквивалентна выполнению заливки впервые.

Параметры

Инициирует обновление для указанного элемента. При выполнении вызова управляемым экземпляром подтверждаются все внесенные в элемент изменения и возвращается маркер, используемый для отслеживания этих изменений. При отсутствии отложенных изменений, которые были внесены в элемент, возвращается пустой маркер. При выполнении вызова другой копией экземпляра, все измененные свойства копируются в массив изменений управляемого экземпляра с регистрацией любых изменений. Если autoCommit имеет значение true, выполняется немедленное подтверждение изменений для этого элемента. При значении false изменения ставятся в очередь до вызова метода commit().

Параметры

Событие DataConflictEvent.CONFLICT передается при обнаружении конфликта между отложенными изменениями на стороне этого клиента и изменениями, переданными другим клиентом, или если изменения, переданные этим клиентом, конфликтуют с изменениями в удаленном адресе назначения. Каждый DataService передает события конфликта только для элементов этого адреса назначения. Используйте событие конфликта на DataService, если требуется одновременно обработать конфликты для набора связанных адресов назначения.

Свойства объекта события имеют следующие значения:

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

Свойства объекта события имеют следующие значения:

Событие MessageEvent.MESSAGE передается, если удаленный адрес назначения инициирует уведомление об операции данных. Например, если данные обновляются в удаленном адресе назначения, операция обновления передается для прослушивания всех клиентов и преобразуется в событие сообщения на этом DataService.

Значением этой константы является message.

Свойства объекта события имеют следующие значения:

Событие PropertyChangeEvent.PROPERTY_CHANGE передается при изменении свойства этой службы. Этот процесс выполняется для следующих свойств:

• commitRequired
• mergeRequired
• connected

Свойства объекта события имеют следующие значения:

Событие ResultEvent.RESULT передается при успешном возврате вызова службы. Например, при вызове fill() передается это событие, если вызов успешно выполнен.

Свойства объекта события имеют следующие значения: