ActionScript® 3.0 Referenzhandbuch für die Adobe® Flash®-Plattform
Home  |  Liste der Pakete und Klassen ausblenden |  Pakete  |  Klassen  |  Neue Funktionen  |  Stichwortverzeichnis  |  Anhänge  |  Warum auf Englisch?
Filter: Daten werden vom Server abgerufen...
Daten werden vom Server abgerufen...
mx.data 

MessageBatch  - AS3 ADEP Data Services

Paketmx.data
Klassepublic class MessageBatch
VererbungMessageBatch Inheritance EventDispatcher Inheritance 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

Stellt eine Gruppe von Änderungen dar: Erstellungs-, Aktualisierungs-, Löschvorgänge und Meldungen für die Aktualisierung der Sammlung. Der Zugriff auf mindestens einen offenen Batch über die 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.



Öffentliche Eigenschaften
 EigenschaftDefiniert 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
 Inheritedconstructor : 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
Öffentliche Methoden
 MethodeDefiniert von
  
Konstruktor.
MessageBatch
 Inherited
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
  
commit(itemsOrCollections:Array = null, cascadeCommit:Boolean = false):mx.rpc:AsyncToken
Übernimmt die Änderungen in diesem Batch.
MessageBatch
  
Zeigt an, ob ausstehende Änderungen für dieses bestimmte Element vorhanden sind.
MessageBatch
 Inherited
Sendet ein Ereignis in den Ereignisablauf.
EventDispatcher
  
Gibt die Meldung mit der angegebenen ID zurück.
MessageBatch
 Inherited
Überprüft, ob das EventDispatcher-Objekt Listener für einen bestimmten Ereignistyp registriert hat.
EventDispatcher
 Inherited
Gibt an, ob für ein Objekt eine bestimmte Eigenschaft definiert wurde.
Object
 Inherited
Gibt an, ob eine Instanz der Object-Klasse in der Prototypkette des Objekts vorhanden ist, das als Parameter angegeben wurde.
Object
 Inherited
Gibt an, ob die angegebene Eigenschaft vorhanden ist und durchlaufen werden kann.
Object
  
Diese Methode hebt die Serialisierung des Meldungs-Batch auf.
MessageBatch
 Inherited
removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void
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
 Inherited
Legt die Verfügbarkeit einer dynamischen Eigenschaft für Schleifenoperationen fest.
Object
 Inherited
Gibt die Stringdarstellung dieses Objekts zurück, formatiert entsprechend den Konventionen des Gebietsschemas.
Object
  
[override] Gibt eine Stringdarstellung dieses Objekts zurück.
MessageBatch
 Inherited
Gibt den Grundwert des angegebenen Objekts zurück.
Object
 Inherited
Ü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
Ereignisse
 Ereignis Übersicht Definiert von
 Inherited[broadcast event] Wird ausgelöst, wenn Flash Player oder eine AIR-Anwendung den Betriebssystemfokus erhält und aktiv wird.EventDispatcher
 Inherited[broadcast event] Wird ausgelöst, wenn Flash Player- oder die AIR-Anwendung den Fokus verliert und inaktiv wird.EventDispatcher
Öffentliche Konstanten
 KonstanteDefiniert von
  items : ArrayCollection
Dies speichert die Liste der MessageCacheItem-Instanzen, die die Änderungen im Batch darstellen.
MessageBatch
Eigenschaftendetails

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():Boolean

properties

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..

Konstruktordetails

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.

Methodendetails

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) — Wenn Sie nur einige Änderungen im Batch übernehmen möchten, können Sie Änderungen für jeweils ein einzelnes Element oder eine Sammlung von Elementen übernehmen, indem Sie den itemsOrCollections-Parameter festlegen.
 
cascadeCommit:Boolean (default = false) — Bei true wird sichergestellt, dass Änderungen an den verknüpften Elementen auch im Commit-Vorgang enthalten sind.

Rückgabewerte
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.

Rückgabewerte
Booleantrue, 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.

Rückgabewerte
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) — Das wiederherzustellende Element.

Rückgabewerte
Booleantrue, 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.

Rückgabewerte
Booleantrue, 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ückgabewerte
String — 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.

Konstantendetails

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.





[ X ]Warum auf Englisch?
Inhalt des ActionScript 3.0-Referenzhandbuchs wird in englischer Sprache angezeigt

Nicht alle Teile des ActionScript 3.0-Referenzhandbuchs wurden in alle Sprachen übersetzt. Wenn der Text zu einem Sprachelement nicht übersetzt wurde, wird er auf Englisch angezeigt. Zum Beispiel wurden die Informationen zur ga.controls.HelpBox-Klasse nicht in andere Sprachen übersetzt. In der deutschen Version des Referenzhandbuchs erscheint der Abschnitt zur ga.controls.HelpBox-Klasse deshalb auf Englisch.