MessageBatch

Package	mx.data
Classe	public class MessageBatch
Héritage	MessageBatch EventDispatcher Object
Implémente	IExternalizable

Version du langage:

ActionScript 3.0

Version du produit:

Adobe Digital Enterprise Platform Data Services for Java EE 3

Versions du moteur d’exécution:

Flash Player 9, AIR 1.1

Représente un groupe de modifications : messages de création, de mise à jour, de suppression et de mise à jour de collection. Au moins un lot ouvert est systématiquement accessible par le biais de la propriété DataStore.currentBatch. Les modifications que vous réalisez, par exemple les modifications de propriété détectées automatiquement, par le biais d’une liaison de données ou d’opérations createItem, updateItem ou deleteItem, sont stockées dans ce lot. La liste actuelle des lots non validés est stockée dans la propriété uncommittedBatches. L’appel de createBatch crée un nouveau lot, ajouté à la fin de la liste. Ce lot est automatiquement désigné comme lot currentBatch. Vous pouvez valider ou rétablir simultanément l’ensemble des modifications d’un lot. Dans tous les cas, le lot est supprimé automatiquement de la liste uncommittedBatches.

Lorsque des dépendances existent entre les modifications, vous devez valider et rétablir les modifications dans l’ordre. Ainsi, vous devez valider le lot le plus ancien de la liste (uncommittedBatches[0]) et rétablir le lot le plus récent : uncommittedBatches[uncommittedBatches.length - 1].

La propriété commitRequired est définie sur true lorsque le lot contient des modifications, c’est-à-dire lorsque items.length > 0. La propriété items stocke l’ensemble des instances DataMessage de ce lot.

Vous pouvez stocker des informations personnalisées dans une instance MessageBatch par le biais de la propriété properties. Les lots sont enregistrés/restaurés chaque fois que vous utilisez la méthode saveCache, mais aussi automatiquement lorsque la valeur de la propriété autoSaveCache est true et que vous utilisez la fonctionnalité hors ligne.

A chaque lot correspond une instance DataMessage associée dans la propriété batchMessage. Si vous devez communiquer des informations au serveur (et que vous envoyez le message de lot au serveur), vous pouvez stocker des informations dans les en-têtes de ce message.

Propriétés publiques

Masquer les propriétés publiques héritées

Afficher les propriétés publiques héritées

	Propriété		Défini par
		batchMessage : DataMessage Il s’agit du message de données utilisé pour représenter le lot envoyé au serveur.	MessageBatch
		commitRequired : Boolean [lecture seule] True si ce lot contient des modifications.	MessageBatch
		constructor : Object Référence à l’objet de classe ou à la fonction constructeur d’une occurrence donnée d’un objet.	Object
		properties : Object = null Ensemble facultatif de propriétés définies par l’utilisateur, que vous pouvez définir pour ce lot.	MessageBatch

Méthodes publiques

Masquer les méthodes publiques héritées

Afficher les méthodes publiques héritées

	Méthode		Défini par
		MessageBatch() Constructeur.	MessageBatch
		addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void Enregistre un objet écouteur d’événement auprès d’un objet EventDispatcher afin que l’écouteur soit averti d’un événement.	EventDispatcher
		commit(itemsOrCollections:Array = null, cascadeCommit:Boolean = false):mx.rpc:AsyncToken Valide les modifications du lot.	MessageBatch
		commitRequiredOn(item:Object):Boolean Indique s’il existe des modifications en attente pour cet élément particulier.	MessageBatch
		dispatchEvent(event:Event):Boolean Distribue un événement dans le flux d’événements.	EventDispatcher
		getMessage(messageId:String):DataMessage Renvoie le message avec l’id donné.	MessageBatch
		hasEventListener(type:String):Boolean Vérifie si des écouteurs sont enregistrés auprès de l’objet EventDispatcher pour un type spécifique d’événement.	EventDispatcher
		hasOwnProperty(name:String):Boolean Indique si la propriété spécifiée d’un objet est définie.	Object
		isPrototypeOf(theClass:Object):Boolean Indique si une occurrence de la classe Object figure dans la chaîne de prototype de l’objet spécifié en tant que paramètre.	Object
		propertyIsEnumerable(name:String):Boolean Indique si la propriété spécifiée existe et est énumérable.	Object
		readExternal(input:IDataInput):void Cette méthode désérialise le lot de messages.	MessageBatch
		removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void Supprime un écouteur de l’objet EventDispatcher.	EventDispatcher
		removeMessage(msg:DataMessage):void Supprime le message spécifié de ce lot.	MessageBatch
		revertChanges(item:IManaged = null):Boolean Rétablit les modifications de ce lot. Si aucun élément n’est spécifié, toutes les modifications sont rétablies. Si un élément est spécifié, seules ses modifications sont rétablies.	MessageBatch
		revertChangesForCollection(collection:ListCollectionView):Boolean Rétablit les modifications de tous les éléments de la collection gérée spécifiée.	MessageBatch
		setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void Définit la disponibilité d’une propriété dynamique pour les opérations en boucle.	Object
		toLocaleString():String Renvoie la représentation de chaîne de cet objet, formatée selon les paramètres régionaux en vigueur.	Object
		toString():String [override] Renvoie une représentation de chaîne de cet objet	MessageBatch
		valueOf():Object Renvoie la valeur primitive de l’objet spécifié.	Object
		willTrigger(type:String):Boolean Vérifie si un écouteur d’événement est enregistré auprès de cet objet EventDispatcher ou de ses ancêtres pour le type d’événement spécifié.	EventDispatcher
		writeExternal(output:IDataOutput):void Cette méthode sérialise le lot selon la structure suivante : numberOfElements:int : nombre total d’éléments sérialisés [élément répété (une fois pour chaque message du lot)]. destination:String : destination de l’instance DataService associée. uid:String : UID de l’élément associé. message:DataMessage : message de la modification associée. Le message contenant actuellement une copie de l’élément, il n’est pas nécessaire de sérialiser le message de façon particulière.	MessageBatch

Evénements

Cliquez pour plus d’informations sur les événements

Masquer les événements hérités

Afficher les événements hérités

	Evénement		Synthèse	Défini par
		activate	[Evénement de diffusion] Distribué lorsque l’application Flash Player obtient le focus du système d’exploitation et devient active.	EventDispatcher
		deactivate	[Evénement de diffusion] Distribué lorsque l’application Flash Player ou AIR perd le focus du système d’exploitation et devient inactive.	EventDispatcher

Constantes publiques

	Constante		Défini par
		items : ArrayCollection Cette constante stocke la liste des instances MessageCacheItem représentant les modifications du lot.	MessageBatch

Détails de la propriété

Détails du constructeur

Détails de la méthode

Détails de la constante

Informations juridiques | Politique de confidentialité en ligne

MessageBatch - AS3 ADEP Data Services

Packagesx

Eléments du langage

Annexes

Package mx.data

batchMessage

commitRequired

properties

commit

commitRequiredOn

getMessage

readExternal

removeMessage

revertChanges

revertChangesForCollection

toString

writeExternal

items

	`itemsOrCollections:Array` (default = `null`) — Si vous souhaitez valider uniquement certaines des modifications du lot, vous pouvez les valider pour un élément ou une collection à la fois en spécifiant le paramètre `itemsOrCollections`.

	`cascadeCommit:Boolean` (default = `false`) — La valeur est définie sur `true`, pour garantir que les modifications apportées aux éléments associés sont également incluses dans la validation.