| Paket | mx.data |
| Klasse | public class MessageBatch |
| Vererbung | MessageBatch  EventDispatcher Object |
| Implementiert | IExternalizable |
| Sprachversion: | ActionScript 3.0 |
| Produktversion: | Adobe Digital Enterprise Platform Data Services für Java EE 3 |
| Laufzeitversionen: | Flash Player 9, AIR 1.1 |
DataStore.currentBatch-Eigenschaft ist immer möglich. Von Ihnen durchgeführte Änderungen wie Eigenschaftsänderungen, die über die Datenbindung, createItem()-, updateItem()- oder deleteItem()-Vorgänge automatisch erkannt wurden, werden automatisch in diesem Batch gespeichert. Die aktuelle Liste der nicht übernommenen Batches wird in der uncommittedBatches-Eigenschaft gespeichert. Sie rufen createBatch auf, um einen neuen Batch zu erstellen, der an das Ende der Liste eingefügt wird. Dieser Batch wird automatisch ein currentBatch. Sie können alle Änderungen übernehmen oder den vorherigen Zustand wiederherstellen, indem Sie die Batches nacheinander verarbeiten. Bei beiden Vorgängen wird der Batch automatisch aus der uncommittedBatches-Liste entfernt.
Bei bestehenden Abhängigkeiten zwischen Änderungen sollten Sie Änderungen der Reihe nach übernehmen bzw. den vorherigen Zustand wiederherstellen - d. h. den ältesten Batch in der Liste übernehmen (uncommittedBatches[0]) und den vorherigen Zustand für den aktuellsten Batch wiederherstellen - uncommittedBatches[uncommittedBatches.length - 1].
Die commitRequired-Eigenschaft wird als „true“ festgelegt, wenn Änderungen am Batch vorhanden sind (d. h. items.length > 0). Die items-Eigenschaft speichert den Satz von DataMessages in diesem Batch.
Sie können über die properties-Eigenschaft benutzerdefinierte Informationen in einem MessageBatch speichern. Batches werden jedes Mal bei Verwendung der saveCache-Methode oder automatisch gespeichert/wiederhergestellt, wenn autoSaveCache bei Verwendung der Offline-Funktion als „true“ festgelegt ist.
Außerdem ist mit jedem Batch eine DataMessage in der batchMessage-Eigenschaft verknüpft. Wenn Sie Informationen zum Server vermitteln müssen (und Sie die Batch-Meldung an den Server senden), können Sie im Header dieser Meldung Informationen speichern.
Vererbte öffentliche Eigenschaften ausblenden
Vererbte öffentliche Eigenschaften anzeigen| Eigenschaft | Definiert von | ||
|---|---|---|---|
| batchMessage : DataMessage
Dies ist die Datenmeldung, die zur Darstellung des Batchs verwendet wird, der zum Server gesendet wurde. | MessageBatch | ||
| commitRequired : Boolean [schreibgeschützt]
Der Wert ist „true“, wenn Änderungen in diesem Batch vorhanden sind. | MessageBatch | ||
 | constructor : Object
Ein Verweis auf das Klassenobjekt oder die Konstruktorfunktion für eine angegebene Objektinstanz. | Object | |
| properties : Object = null
Ein optionaler Satz mit benutzerdefinierten Eigenschaften, die Sie für diesen Batch festlegen können.. | MessageBatch | ||
| Methode | Definiert von | ||
|---|---|---|---|
Konstruktor. | MessageBatch | ||
| addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
Registriert ein Ereignis-Listener-Objekt bei einem EventDispatcher-Objekt, sodass der Listener über ein Ereignis benachrichtigt wird. | EventDispatcher | |
Übernimmt die Änderungen in diesem Batch. | MessageBatch | ||
Zeigt an, ob ausstehende Änderungen für dieses bestimmte Element vorhanden sind. | MessageBatch | ||
|
Sendet ein Ereignis in den Ereignisablauf. | EventDispatcher | |
Gibt die Meldung mit der angegebenen ID zurück. | MessageBatch | ||
|
Überprüft, ob das EventDispatcher-Objekt Listener für einen bestimmten Ereignistyp registriert hat. | EventDispatcher | |
|
Gibt an, ob für ein Objekt eine bestimmte Eigenschaft definiert wurde. | Object | |
|
Gibt an, ob eine Instanz der Object-Klasse in der Prototypkette des Objekts vorhanden ist, das als Parameter angegeben wurde. | Object | |
|
Gibt an, ob die angegebene Eigenschaft vorhanden ist und durchlaufen werden kann. | Object | |
Diese Methode hebt die Serialisierung des Meldungs-Batch auf. | MessageBatch | ||
|
Entfernt einen Listener aus dem EventDispatcher-Objekt. | EventDispatcher | |
Entfernt die angegebene Meldung aus diesem Batch. | MessageBatch | ||
Stellt den vorherigen Zustand des Batchs wieder her – entweder alle Änderungen, wenn kein Element angegeben ist, andernfalls nur die Änderungen für das festgelegte Element. | MessageBatch | ||
Stellt den vorherigen Zustand aller Elemente in der festgelegten verwalteten Sammlung wieder her. | MessageBatch | ||
|
Legt die Verfügbarkeit einer dynamischen Eigenschaft für Schleifenoperationen fest. | Object | |
|
Gibt die Stringdarstellung dieses Objekts zurück, formatiert entsprechend den Konventionen des Gebietsschemas. | Object | |
[override]
Gibt eine Stringdarstellung dieses Objekts zurück. | MessageBatch | ||
|
Gibt den Grundwert des angegebenen Objekts zurück. | Object | |
|
Überprüft, ob bei diesem EventDispatcher-Objekt oder bei einem seiner Vorgänger ein Ereignis-Listener für einen bestimmten Ereignistyp registriert ist. | EventDispatcher | |
Diese Methode serialisiert den Batch mit der folgenden Struktur: numberOfElements:int - Gesamtzahl der serialisierten Elemente [wiederholtes Element(ein Mal pro Meldung im Batch)] destination:String - Ziel des verknüpften DataService uid:String - UID des verknüpften Elements message:DataMessage - Meldung für die verknüpfte Änderung. Da die Meldung zurzeit eine Kopie des Elements enthält, muss die Meldung nicht auf eine spezielle Weise serialisiert werden. | MessageBatch | ||
| Konstante | Definiert von | ||
|---|---|---|---|
| items : ArrayCollection
Dies speichert die Liste der MessageCacheItem-Instanzen, die die Änderungen im Batch darstellen. | MessageBatch | ||
batchMessage | Eigenschaft |
public var batchMessage:DataMessage| Sprachversion: | ActionScript 3.0 |
| Produktversion: | Adobe Digital Enterprise Platform Data Services für Java EE 3 |
| Laufzeitversionen: | Flash Player 9, AIR 1.1 |
Dies ist die Datenmeldung, die zur Darstellung des Batchs verwendet wird, der zum Server gesendet wurde. Wenn Sie zusätzliche transaktionsspezifische Informationen übergeben müssen, können Sie die Header dieser Meldung zur Kommunikation mit dem Servercode verwenden (unter der Voraussetzung, dass die Meldung gesendet und nicht vom Client konvertiert wird).
commitRequired | Eigenschaft |
commitRequired:Boolean [schreibgeschützt] | Sprachversion: | ActionScript 3.0 |
| Produktversion: | Adobe Digital Enterprise Platform Data Services für Java EE 3 |
| Laufzeitversionen: | Flash Player 9, AIR 1.1 |
Der Wert ist „true“, wenn Änderungen in diesem Batch vorhanden sind. Diese Eigenschaft ist bindbar.
Diese Eigenschaft kann als Quelle für die Datenbindung verwendet werden. Beim Ändern dieser Eigenschaft wird das propertyChange -Ereignis ausgelöst.
Implementierung
public function get commitRequired():Booleanproperties | Eigenschaft |
public var properties:Object = null| Sprachversion: | ActionScript 3.0 |
| Produktversion: | Adobe Digital Enterprise Platform Data Services für Java EE 3 |
| Laufzeitversionen: | Flash Player 9, AIR 1.1 |
Ein optionaler Satz mit benutzerdefinierten Eigenschaften, die Sie für diesen Batch festlegen können..
MessageBatch | () | Konstruktor |
public function MessageBatch()| Sprachversion: | ActionScript 3.0 |
| Produktversion: | Adobe Digital Enterprise Platform Data Services für Java EE 3 |
| Laufzeitversionen: | Flash Player 9, AIR 1.1 |
Konstruktor.
commit | () | Methode |
public function commit(itemsOrCollections:Array = null, cascadeCommit:Boolean = false):mx.rpc:AsyncToken| Sprachversion: | ActionScript 3.0 |
| Produktversion: | Adobe Digital Enterprise Platform Data Services für Java EE 3 |
| Laufzeitversionen: | Flash Player 9, AIR 1.1 |
Übernimmt die Änderungen in diesem Batch. Normalerweise erfolgt der Aufruf ohne Argumente.
Parameter
itemsOrCollections:Array (default = null)itemsOrCollections-Parameter festlegen.
| |
cascadeCommit:Boolean (default = false)true wird sichergestellt, dass Änderungen an den verknüpften Elementen auch im Commit-Vorgang enthalten sind.
|
mx.rpc:AsyncToken — AsyncToken-Verweis auf das Token, das diesen Vorgang in einem Ergebnis- oder Fehlerereignis identifizieren wird, das von diesem Dienst ausgelöst wird.
|
commitRequiredOn | () | Methode |
public function commitRequiredOn(item:Object):Boolean| Sprachversion: | ActionScript 3.0 |
| Produktversion: | Adobe Digital Enterprise Platform Data Services für Java EE 3.1 |
| Laufzeitversionen: | Flash Player 9, AIR 1.1 |
Zeigt an, ob ausstehende Änderungen für dieses bestimmte Element vorhanden sind.
Parameter
item:Object — Das Objekt, bei dem möglicherweise Änderungen vorgenommen werden müssen.
|
Boolean — true, wenn das Element ausstehende Änderungen aufweist.
|
getMessage | () | Methode |
public function getMessage(messageId:String):DataMessage| Sprachversion: | ActionScript 3.0 |
| Produktversion: | Adobe Digital Enterprise Platform Data Services für Java EE 3 |
| Laufzeitversionen: | Flash Player 9, AIR 1.1 |
Gibt die Meldung mit der angegebenen ID zurück. Gibt „null“ zurück, wenn dieser Batch keine Meldung mit der angegebenen ID enthält.
Parameter
messageId:String — ID der gewünschten Meldung.
|
DataMessage — Die Meldung mit der angegebenen ID. Gibt „null“ zurück, wenn dieser Batch keine Meldung mit der angegebenen ID enthält.
|
readExternal | () | Methode |
public function readExternal(input:IDataInput):void| Sprachversion: | ActionScript 3.0 |
| Produktversion: | Adobe Digital Enterprise Platform Data Services für Java EE 3 |
| Laufzeitversionen: | Flash Player 9, AIR 1.1 |
Diese Methode hebt die Serialisierung des Meldungs-Batch auf. Es wird erwartet, dass der Eingabebytestrom die folgende Struktur hat:
- numberOfElements:int – Gesamtzahl der serialisierten Elemente [wiederholtes Element (einmal pro Meldung im Batch)] t]
- destination:String – das Ziel des verknüpften DataService
- uid:String – die UID des verknüpften Elements
- message:DataMessage – die Meldung für die verknüpfte Änderung
Parameter
input:IDataInput — Eingabestream
|
removeMessage | () | Methode |
public function removeMessage(msg:DataMessage):void| Sprachversion: | ActionScript 3.0 |
| Produktversion: | Adobe Digital Enterprise Platform Data Services für Java EE 3 |
| Laufzeitversionen: | Flash Player 9, AIR 1.1 |
Entfernt die angegebene Meldung aus diesem Batch.
Parameter
msg:DataMessage — Zu entfernende Meldung.
|
revertChanges | () | Methode |
public function revertChanges(item:IManaged = null):Boolean| Sprachversion: | ActionScript 3.0 |
| Produktversion: | Adobe Digital Enterprise Platform Data Services für Java EE 3 |
| Laufzeitversionen: | Flash Player 9, AIR 1.1 |
Stellt den vorherigen Zustand des Batchs wieder her – entweder alle Änderungen, wenn kein Element angegeben ist, andernfalls nur die Änderungen für das festgelegte Element. Sie sollten normalerweise nur den Zustand vor den Änderungen im aktuellsten Batch wiederherstellen, da das System keine Abhängigkeiten auflöst oder repariert, wenn Sie eine ältere Änderung wiederherstellen, auf die sich eine spätere Änderung bezieht.
Parameter
item:IManaged (default = null) |
Boolean — true, wenn die Wiederherstellung erfolgreich abgeschlossen wurde.
|
revertChangesForCollection | () | Methode |
public function revertChangesForCollection(collection:ListCollectionView):Boolean| Sprachversion: | ActionScript 3.0 |
| Produktversion: | Adobe Digital Enterprise Platform Data Services für Java EE 3 |
| Laufzeitversionen: | Flash Player 9, AIR 1.1 |
Stellt den vorherigen Zustand aller Elemente in der festgelegten verwalteten Sammlung wieder her.
Parameter
collection:ListCollectionView — Die wiederherzustellende Sammlung.
|
Boolean — true, wenn die Wiederherstellung erfolgreich abgeschlossen wurde.
|
toString | () | Methode |
override public function toString():String| Sprachversion: | ActionScript 3.0 |
| Produktversion: | Adobe Digital Enterprise Platform Data Services für Java EE 3 |
| Laufzeitversionen: | Flash Player 9, AIR 1.1 |
Gibt eine Stringdarstellung dieses Objekts zurück.
RückgabewerteString — Eine Stringdarstellung dieses Objekts.
|
writeExternal | () | Methode |
public function writeExternal(output:IDataOutput):void| Sprachversion: | ActionScript 3.0 |
| Produktversion: | Adobe Digital Enterprise Platform Data Services für Java EE 3 |
| Laufzeitversionen: | Flash Player 9, AIR 1.1 |
Diese Methode serialisiert den Batch mit der folgenden Struktur:
- numberOfElements:int – Gesamtzahl der serialisierten Elemente [wiederholtes Element (einmal pro Meldung im Batch)]
- destination:String – das Ziel des verknüpften DataService
- uid:String – die UID des verknüpften Elements
- message:DataMessage – die Meldung für die verknüpfte Änderung
Da die Meldung zurzeit eine Kopie des Elements enthält, muss die Meldung nicht auf eine spezielle Weise serialisiert werden.
Parameter
output:IDataOutput — Objekt, in das serialisierte Byte geschrieben werden.
|
items | Konstante |
public const items:ArrayCollection| Sprachversion: | ActionScript 3.0 |
| Produktversion: | Adobe Digital Enterprise Platform Data Services für Java EE 3 |
| Laufzeitversionen: | Flash Player 9, AIR 1.1 |
Dies speichert die Liste der MessageCacheItem-Instanzen, die die Änderungen im Batch darstellen. Sie ist bindbar, sodass Sie auf Änderungsereignisse in dieser Sammlung warten können, um über neue Änderungen benachrichtigt zu werden.
Tue Jun 12 2018, 10:04 AM Z