ManagedQuery  - AS3 ADEP Data Services

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

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

Размер страницы для этого запроса при активированной подкачке страниц.

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

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

Строка в форме a, b, c, в которой перечислены имена свойств управляемых элементов, возвращаемых этим запросом. Если значение не установлено, запрос должен возвратить все свойства объекта.

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

При удалении элемента из коллекции использовать эту операцию для удаления элемента не требуется. Вместо этого следует установить свойство deleteItemOnRemoveFromFill, и при удалении элемента из коллекции операция сервера deleteItem будет вызвана автоматически.

Имя операции в службе с параметрами, аналогичными этому запросу, который вычисляет измененные элементы запроса со времени последнего запроса. То есть выполняет synchronizeFill() для связанного fill().

Формирует ManagedQuery. nameParameter указывает имя операции службы, на которой основывается ManagedQuery. Обязательный параметр, но здесь он является дополнительным, так что этот класс может использоваться в MXML.

Инициализирует управляемую операцию, вызывающую ошибки из-за проблем конфигурации, обнаруженные во время выполнения.