DataMessage  - AS3 ADEP Data Services

Stellt einen Zugriff auf die Identitätsmatrix bereit, die die eindeutige Identität des Elements definiert, auf das sich diese DataMessage auswirkt (relevant für Erstell-/Aktualisier-/Löschvorgänge, aber nicht für Füllvorgänge).

Stellt einen Zugriff auf den Vorgangs/Befehl dieser DataMessage bereit. Vorgänge zeigen an, wie das Remote-Ziel diese Meldung verarbeiten soll. Verwenden Sie die getOperationAsString-Methode, um eine Beschreibung des Vorgangstyps anzuzeigen.

Verwandte API-Elemente

Konstruktor.

Stellt eine Beschreibung des angegebenen Vorgangs zur Verfügung. Diese Methode wird in Vorgängen des Typs toString() in dieser Meldung verwendet.

Parameter

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

Wenn dies ein Erstellungsvorgang ist, wird true zurückgegeben.

Verwandte API-Elemente

Wenn diese Meldung eine Aktualisierung ist und die Liste der Eigenschaftsnamen eine Länge von null hat, wird true zurückgegeben.

Dieser Vorgang stellt einen Satz von Batch-Vorgängen dar, die als eine einzelne Einheit ausgeführt werden. Clients senden einen Batch, wenn DataManager.commit() aufgerufen wird. Alle Meldungen im Batch sind für das gleiche Ziel vorgesehen. Die body-Eigenschaft enthält alle Meldungen, die zu diesem Batch gehören.

Dieser Vorgang fordert den Aufruf einer konfigurierten <count-method> an einem Remote-Ziel an. Die body-Eigenschaft der Meldung enthält die Argumente, die beim Aufrufen der Methode an das Remote-Ziel übergeben werden sollen. Clients senden diesen Vorgang, wenn die DataManager.count()-Methode aufgerufen wird.

Verwandte API-Elemente

Dieser Vorgang fordert eine Erstellung des festgelegten Elements von einem Remote-Ziel an. Clients senden diesen Vorgang, wenn die DataManager.createItem()-Methode aufgerufen wird. Die body-Eigenschaft enthält das Element, das erstellt werden soll.

Verwandte API-Elemente

Gibt einen Erstellvorgang an. Die body-Eigenschaft enthält das neue zu erstellende Element. Bei Ausführung des Vorgangs außerhalb einer Verknüpfung wird eine entsprechende UpdateCollectionMessage ausgelöst, die den Speicherort oder die Indexposition zum Hinzufügen des Elements angibt. Clients senden diesen Vorgang, wenn eine Sammlung unter Verwaltung eines DataService die IList.addItemAt()-, IList.addItem()- oder IViewCursor.insert()-Methoden verwendet.

Verwandte API-Elemente

Dieser Vorgang gibt an, dass das entsprechende Element entfernt werden soll. Clients empfangen und senden diesen Vorgang, wenn das Element entfernt wird. Clients senden diesen Vorgang bei DataManager.deleteItem() oder wenn eine Sammlung unter Verwaltung eines Datenmanagers die IList.removeItemAt()- oder IViewCursor.remove()-Methode verwendet.

Verwandte API-Elemente

Dieser Vorgang fordert die Erstellung einer Sequenz durch ein Remote-Ziel mithilfe des Adapters des Remote-Ziels an. Die body-Eigenschaft der Meldung enthält die Füllargumente, die bei der Erstellung der Remote-Sequenz verwendet werden sollen.

Entspricht „FILL_OPERATION“, aber stellt sicher, dass im Antwort-Array nur ein einzelnes Element zurückgegeben wird.

Dieser Vorgang fordert den Abruf eines bestimmten verwalteten Objekts anhand dessen eindeutiger ID durch das Remote-Ziel an. Die identity-Eigenschaft enthält die gewünschte Identität des Objekts.

Verwandte API-Elemente

Dieser Vorgang fordert ein Element mit der entsprechenden Identität vom Remote-Ziel an. Wenn kein Element mit der Identität vorhanden ist, wird ein Erstellungsvorgang ausgeführt. Clients senden diesen Vorgang, wenn die DataManager.getItem()-Methode mit Standardwerten ungleich null für das Element aufgerufen wird. Die body-Eigenschaft enthält die Standardwerte des Elements, falls es erstellt werden muss.

Verwandte API-Elemente

Dieser Vorgang fordert eine Sequenz-ID für eine Reihe von Füllparametern an. Wenn die Sequenz vorhanden ist, wird sie nicht neu erstellt. Wenn sie nicht vorhanden ist, wird sie remote neuerstellt. Clients senden diesen Vorgang bei einer erneuten Verbindung mit einem Remote-Ziel oder bei einem Fehlschlagen der Verbindung mit Wechsel zu einem neuen Knoten innerhalb eines Clusters. Dieser Vorgang wird nur verwendet, wenn das fetch-Attribut des <reconnect>-Tags in der XML-Datei der Konfiguration des Remote-Ziels als „IDENTITY“ festgelegt ist.

Verwandte API-Elemente

Dieser Vorgang stellt eine Reihe von Operationen dar, die gemeinsam als Einheit ausgeführt werden, aber mehrere Batch-, Erstellungs-, Aktualisierungs- oder Löschvorgänge erhalten, die mehr als ein Ziel, d. h. mehrere Remote-Adapter betreffen. Clients senden einen mehrfachen Batch, wenn DataManager.commit() aufgerufen wird und Verknüpfungen für dieses Ziel konfiguriert wurden. Meldungen in diesem Batch werden an mehrere Ziele gesendet.

Dieser Vorgang zeigt eine Anforderung für eine Seite von Elementen an, die von Identitäten festgelegt wurden. Dieser Vorgang ist einer PAGE_OPERATION ähnlich, wobei die Seitenindexposition nicht erforderlich ist. Clients senden diesen Vorgang beim Abrufen von mit Lazy-Load geladenen Elementen für Verknüpfungen, die mithilfe von 1:n- und m:n-Beziehungen konfiguriert wurden.

Dieser Vorgang wird zum Abrufen einer Seite mit aufeinanderfolgendem Inhalt verwendet, der mithilfe mehrerer Meldungen übermittelt wird, anstatt von einer einzelnen. Dies stellt eine Anforderung für einen Teil einer Remote-Sequenz dar. Clients senden diesen Vorgang, wenn Elemente oder Eigenschaften angefordert werden, die nicht lokal vorhanden sind. Dieser Vorgang wird nur ausgeführt, wenn entweder im <paging >-Tag unter dem <network>-Tag das enabled-Attribut auf true mit einem pageSize-Attribut ungleich null gesetzt ist oder wenn eine Verknüpfung mit dem lazy-Attribut auf true gesetzt wurde.

Dieser Vorgang zeigt an, dass der Client kein weiteres Interesse am Empfang von Benachrichtigungen über Vorgänge hat, die in der festgelegten Sammlung ausgeführt werden. Clients senden diesen Vorgang, wenn DataManager.releaseCollection() aufgerufen wird oder wenn DataManager.fill() mit einer ArrayCollection aufgerufen wird, die vorher mit verschiedenen Parametern gefüllt wurde, oder wenn das übergeordnete Element einer 1:n-Verknüpfung freigegeben wird.

Verwandte API-Elemente

Dieser Vorgang zeigt an, dass der Client kein weiteres Interesse am Empfang von Benachrichtigungen über Vorgänge hat, die für das festgelegte Element ausgeführt werden. Clients senden diesen Vorgang, wenn DataService.releaseItem() oder ItemReference.releaseItem() aufgerufen wird.

Verwandte API-Elemente

Remote-Alias, das die vollständig qualifizierte serverseitige Klasse angibt, die dieser Klasse entspricht.

Dieser Vorgang fordert die Erstellung einer Sequenz durch ein Remote-Ziel mithilfe des Adapters des Remote-Ziels an. Die body-Eigenschaft der Meldung enthält die Füllargumente, die bei der Erstellung der Remote-Sequenz verwendet werden sollen.

Dieser Vorgang ist einer MULTI_BATCH_OPERATION ähnlich. Zusätzlich sollte der Server die Batches von Meldungen, von denen mehrere vorhanden sind, innerhalb einer Transaktion einbinden. Dieser Vorgang wird nur ausgeführt, wenn für das Remote-Ziel das <use-transactions>-Tag unter dem <properties>-Tag innerhalb der Zielkonfigurations-XML mit dem Wert true festgelegt wurde.

Code für einen unbekannten Vorgangstyp.

Diese Konstante wird verwendet, um auf die Liste der geänderten Eigenschaftsnamen zuzugreifen. Verwenden Sie diese Eigenschaft in Klammerschreibweise für die body-Eigenschaft einer Meldung mit einer operation von UPDATE_OPERATION.

Verwandte API-Elemente

         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] +
                      "'.");
            }
         }
      

Diese Konstante wird verwendet, um auf den neuen Wert eines geänderten Elements zuzugreifen. Verwenden Sie diese Eigenschaft in Klammerschreibweise für die body-Eigenschaft einer Meldung mit einer operation von UPDATE_OPERATION.

Verwandte API-Elemente

         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] +
                      "'.");
            }
         }
      

Diese Konstante wird verwendet, um auf den früheren Wert des geänderten Elements zuzugreifen. Verwenden Sie diese Eigenschaft in Klammerschreibweise für die body-Eigenschaft einer Meldung mit einer operation von UPDATE_OPERATION.

Verwandte API-Elemente

         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] +
                      "'.");
            }
         }
      

Dieser Vorgang wird gesendet, wenn eine lokale oder Remote-Sequenz durch Einfüge- oder Löschvorgänge modifiziert wurde. Dieser Vorgang stellt Informationen über die Positionen aller Einfüge- und Löschvorgänge bereit, sodass der Zustand der Sammlungsreihenfolge wiederhergestellt werden kann.

Der body enthält ein Array an UpdateCollectionRanges, die anzeigen, welche Elemente entfernt und hinzugefügt wurden. Durch Anwenden der Sammlungsbereiche für die Aktualisierung in der gegebenen Reihenfolge wird eine einheitliche Reihenfolge der Elemente in der angegebene Sammlung hergestellt.

Dieser Vorgang zeigt an, dass die Aktualisierung eines Datenobjekts ausgeführt wurde. Clients empfangen und senden diesen Vorgang, wenn ein Element aktualisiert wurde.

Die body-Eigenschaft der Meldung ist ein Array, das spezifische Informationen über die aufgetretene Aktualisierung enthält. Die DataMessage.UPDATE_BODY_CHANGES-Position innerhalb des Arrays enthält ein Array an Eigenschaftsnamen, die während der Aktualisierung geändert wurden.

Die DataMessage.UPDATE_BODY_NEW-Position innerhalb des Arrays enthält das Objekt im neuen, geänderten Zustand. Die DataMessage.UPDATE_BODY_PREV-Position innerhalb des Arrays enthält das Objekt im ursprünglichen Zustand vor der Aktualisierung.

         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] +
                      "'.");
            }
         }