DataMessage  - AS3 ADEP Data Services

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

Предоставляет доступ к операции/команде этого DataMessage. Операции определяют способ обработки этого сообщения в удаленном адресе назначения. Для отображения описания типа операции используется метод getOperationAsString.

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

Конструктор.

Предоставляет описание указанной операции. Этот метод используется в операциях toString() данного сообщения.

Параметры

         var msg:DataMessage = DataMessage(event.message);
         trace("Current operation -'"+
                DataMessage.getOperationAsString(msg.operation)+ "'.");
      

Возвращает значение true в случае операции создания.

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

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

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

Эта операция запрашивает вызов сконфигурированного <count-method> из удаленного адреса назначения. Свойство body этого сообщения содержит аргументы, которые должны передаваться в удаленный адрес назначения при вызове метода. Эта операция передается клиентами при вызове метода DataManager.count().

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

Эта операция создает запрос на создание указанного элемента в удаленном целевом адресе. Эта операция передается клиентами при вызове метода DataManager.createItem(). Свойство body содержит элемент, подлежащий созданию.

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

Указывает операцию создания. Свойство body содержит вновь созданный элемент. Если операция выполняется вне ассоциации, выводится соответствующее сообщение UpdateCollectionMessage, указывающее местоположение или индекс для добавления элемента. Клиенты отправляют эту операцию, если коллекция под управлением DataService использует методы IList.addItemAt(), IList.addItem() или IViewCursor.insert().

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

Эта операция указывает на необходимость удаления определенного элемента. Эта операция принимается и передается клиентами при удалении этого элемента. Эта операция передается клиентами, если DataManager.deleteItem() или коллекция под управлением менеджера данных использует метод IList.removeItemAt() или IViewCursor.remove().

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

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

Функционирует аналогично FILL_OPERATION, но обеспечивает возвращение только одного элемента в массиве ответа.

Эта операция запрашивает получение в удаленном адресате определенного управляемого объекта на основе его уникального идентификатора. Свойство identity содержит идентификатор требуемого объекта.

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

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

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

Эта операция запрашивает идентификатор последовательности для набора параметров заполнения. Если последовательность существует, ее повторное создание не выполняется. Если последовательность не существует, она вновь создается в удаленном режиме. Эта операция передается клиентами при повторном подключении к удаленному адресу назначения или при ошибке нового узла в кластере. Эта операция используется только в том случае, если атрибут fetch тега <reconnect> в файле XML конфигурации удаленного адреса назначения имеет значение IDENTITY.

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

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

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

Эта операция используется для извлечения страницы упорядоченного содержимого, поставляемого посредством не одного, а нескольких сообщений. Она представляет запрос фрагмента удаленной последовательности. Эта операция передается клиентами в случае запроса элемента или свойства, не являющегося резидентным локально. Эта операция выполняется только в том случае, если тег <paging> в <network> имеет атрибут enabled со значением true и отличный от нуля атрибут pageSize, либо если сконфигурирована связь с атрибутом lazy, имеющим значение true.

Эта операция указывает на то, что клиенту больше не требуется принимать уведомления относительно операций, выполняемых по отношению к указанной коллекции. Эта операция передается клиентами при вызове метода DataManager.releaseCollection() или метода DataManager.fill() с коллекцией ArrayCollection, предварительно заполненной различными параметрами, либо в случае освобождения элемента-владельца отношения «один ко многим».

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

Эта операция указывает на то, что клиенту больше не требуется принимать уведомления относительно операций, выполняемых по отношению к указанному элементу. Эта операция передается клиентами при вызове метода DataService.releaseItem() или ItemReference.releaseItem().

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

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

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

Эта операция подобна MULTI_BATCH_OPERATION с тем лишь дополнением, что в рамках транзакции сервер должен инкапсулировать несколько пакетов сообщений. Эта операция выполняется только в том случае, если удаленный адрес назначения имеет тег <use-transactions> в теге <properties> в файле XML конфигурации адреса назначения со значением true.

Код для неизвестного типа операции.

Эта константа используется для получения доступа к списку имен измененных свойств. Это свойство используется с нотацией в скобках для свойства body сообщения со значением operation операции UPDATE_OPERATION.

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

         var msg:DataMessage = DataMessage(event.message);
         if (msg.operation == DataMessage.UPDATE_OPERATION)
         {
            // look at each change and display the old and new values
            var propertyNames:Array = msg.body[DataMessage.UPDATE_BODY_CHANGES];
            var newValues:Object = msg.body[DataMessage.UPDATE_BODY_NEW];
            var oldValues:Object = msg.body[DataMessage.UPDATE_BODY_PREV];
            var propertyName:String;
            for (var i:int=0; i<propertyNames.length; i++)
            {
                propertyName = propertyNames[i];
                trace("Property '"+ propertyName + "' was changed from '" +
                      oldValues[propertyName] + "' to '"+ newValues[propertyName] +
                      "'.");
            }
         }
      

Эта константа используется для получения доступа к новому значению измененного элемента. Это свойство используется с нотацией в скобках для свойства body сообщения со значением operation операции UPDATE_OPERATION.

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

         var msg:DataMessage = DataMessage(event.message);
         if (msg.operation == DataMessage.UPDATE_OPERATION)
         {
            // look at each change and display the old and new values
            var propertyNames:Array = msg.body[DataMessage.UPDATE_BODY_CHANGES];
            var newValues:Object = msg.body[DataMessage.UPDATE_BODY_NEW];
            var oldValues:Object = msg.body[DataMessage.UPDATE_BODY_PREV];
            var propertyName:String;
            for (var i:int=0; i<propertyNames.length; i++)
            {
                propertyName = propertyNames[i];
                trace("Property '"+ propertyName + "' was changed from '" +
                      oldValues[propertyName] + "' to '"+ newValues[propertyName] +
                      "'.");
            }
         }
      

Эта константа используется для получения доступа к предыдущему значению измененного элемента. Это свойство используется с нотацией в скобках для свойства body сообщения со значением operation операции UPDATE_OPERATION.

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

         var msg:DataMessage = DataMessage(event.message);
         if (msg.operation == DataMessage.UPDATE_OPERATION)
         {
            // look at each change and display the old and new values
            var propertyNames:Array = msg.body[DataMessage.UPDATE_BODY_CHANGES];
            var newValues:Object = msg.body[DataMessage.UPDATE_BODY_NEW];
            var oldValues:Object = msg.body[DataMessage.UPDATE_BODY_PREV];
            var propertyName:String;
            for (var i:int=0; i<propertyNames.length; i++)
            {
                propertyName = propertyNames[i];
                trace("Property '"+ propertyName + "' was changed from '" +
                      oldValues[propertyName] + "' to '"+ newValues[propertyName] +
                      "'.");
            }
         }
      

Эта операция передается в случае изменения локальной или удаленной последовательности, а также одной или нескольких вставок или удалений. Эта операция предоставляет информацию о местоположении всех вставок и удалений, что позволяет восстановить состояние последовательности коллекции.

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

Эта операция указывает на выполнение обновления объекта данных. Эта операция принимается и передается клиентами при обновлении элемента.

Значения свойства body сообщения представляют собой массив, содержащий определенную информацию о выполненном обновлении. Местоположение DataMessage.UPDATE_BODY_CHANGES в пределах массива содержит массив имен свойств, измененных в процессе обновления.

Местоположение DataMessage.UPDATE_BODY_NEW в пределах массива содержит объект в его новом измененном состоянии. Местоположение DataMessage.UPDATE_BODY_PREV в пределах массива содержит объект в его состоянии до обновления.

         var msg:DataMessage = DataMessage(event.message);
         if (msg.operation == DataMessage.UPDATE_OPERATION)
         {
            // look at each change and display the old and new values
            var propertyNames:Array = msg.body[DataMessage.UPDATE_BODY_CHANGES];
            var newValues:Object = msg.body[DataMessage.UPDATE_BODY_NEW];
            var oldValues:Object = msg.body[DataMessage.UPDATE_BODY_PREV];
            var propertyName:String;
            for (var i:int=0; i<propertyNames.length; i++)
            {
                propertyName = propertyNames[i];
                trace("Property '"+ propertyName + "' was changed from '" +
                      oldValues[propertyName] + "' to '"+ newValues[propertyName] +
                      "'.");
            }
         }