MessageBatch

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

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

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

Öffentliche Methoden

Vererbte öffentliche Methoden ausblenden

Vererbte öffentliche Methoden anzeigen

	Methode		Definiert von
		MessageBatch() 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
		commit(itemsOrCollections:Array = null, cascadeCommit:Boolean = false):mx.rpc:AsyncToken Übernimmt die Änderungen in diesem Batch.	MessageBatch
		commitRequiredOn(item:Object):Boolean Zeigt an, ob ausstehende Änderungen für dieses bestimmte Element vorhanden sind.	MessageBatch
		dispatchEvent(event:Event):Boolean Sendet ein Ereignis in den Ereignisablauf.	EventDispatcher
		getMessage(messageId:String):DataMessage Gibt die Meldung mit der angegebenen ID zurück.	MessageBatch
		hasEventListener(type:String):Boolean Überprüft, ob das EventDispatcher-Objekt Listener für einen bestimmten Ereignistyp registriert hat.	EventDispatcher
		hasOwnProperty(name:String):Boolean Gibt an, ob für ein Objekt eine bestimmte Eigenschaft definiert wurde.	Object
		isPrototypeOf(theClass:Object):Boolean Gibt an, ob eine Instanz der Object-Klasse in der Prototypkette des Objekts vorhanden ist, das als Parameter angegeben wurde.	Object
		propertyIsEnumerable(name:String):Boolean Gibt an, ob die angegebene Eigenschaft vorhanden ist und durchlaufen werden kann.	Object
		readExternal(input:IDataInput):void Diese Methode hebt die Serialisierung des Meldungs-Batch auf.	MessageBatch
		removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void Entfernt einen Listener aus dem EventDispatcher-Objekt.	EventDispatcher
		removeMessage(msg:DataMessage):void Entfernt die angegebene Meldung aus diesem Batch.	MessageBatch
		revertChanges(item:IManaged = null):Boolean 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
		revertChangesForCollection(collection:ListCollectionView):Boolean Stellt den vorherigen Zustand aller Elemente in der festgelegten verwalteten Sammlung wieder her.	MessageBatch
		setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void Legt die Verfügbarkeit einer dynamischen Eigenschaft für Schleifenoperationen fest.	Object
		toLocaleString():String Gibt die Stringdarstellung dieses Objekts zurück, formatiert entsprechend den Konventionen des Gebietsschemas.	Object
		toString():String [override] Gibt eine Stringdarstellung dieses Objekts zurück.	MessageBatch
		valueOf():Object Gibt den Grundwert des angegebenen Objekts zurück.	Object
		willTrigger(type:String):Boolean Überprüft, ob bei diesem EventDispatcher-Objekt oder bei einem seiner Vorgänger ein Ereignis-Listener für einen bestimmten Ereignistyp registriert ist.	EventDispatcher
		writeExternal(output:IDataOutput):void 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

Klicken Sie, um weitere Informationen zu Ereignissen zu erhalten.

Vererbte Ereignisse ausblenden

Vererbte Ereignisse anzeigen

	Ereignis		Übersicht	Definiert von
		activate	[broadcast event] Wird ausgelöst, wenn Flash Player oder eine AIR-Anwendung den Betriebssystemfokus erhält und aktiv wird.	EventDispatcher
		deactivate	[broadcast event] Wird ausgelöst, wenn Flash Player- oder die AIR-Anwendung den Fokus verliert und inaktiv wird.	EventDispatcher

Öffentliche Konstanten

	Konstante		Definiert von
		items : ArrayCollection Dies speichert die Liste der MessageCacheItem-Instanzen, die die Änderungen im Batch darstellen.	MessageBatch

Eigenschaftendetails

Konstruktordetails

Methodendetails

Konstantendetails

Rechtliche Hinweise | Onlinedatenschutzerklärung

MessageBatch - AS3 ADEP Data Services

Paketex

Sprachelemente

Anhänge

Paket mx.data

batchMessage

commitRequired

properties

commit

commitRequiredOn

getMessage

readExternal

removeMessage

revertChanges

revertChangesForCollection

toString

writeExternal

items

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