Guide de référence ActionScript® 3.0 pour la plate-forme Adobe® Flash®
Accueil  |  Masquer la liste des packages et des classes |  Packages  |  Classes  |  Nouveautés  |  Index  |  Annexes  |  Pourquoi existe-t-il du contenu en anglais ?
Filtres : Récupération des données du serveur...
Récupération des données du serveur...
mx.data.messages 

UpdateCollectionMessage  - AS3 ADEP Data Services

Packagemx.data.messages
Classepublic class UpdateCollectionMessage
HéritageUpdateCollectionMessage Inheritance DataMessage Inheritance AsyncMessage Inheritance AbstractMessage Inheritance Object

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

Ce message permet d’assurer la cohérence entre la séquence distante et la collection locale correspondante. Il contient toutes les opérations d’insertion et de suppression réalisées sur une collection. Les clients envoient ce message lorsqu’une collection locale est mise à jour par le biais de l’API de collection (IListView.removeItemAt(), etc.) ou de l’API d’objet géré unique (DataService.createItem()). La destination distante envoie ce message lorsque la séquence distante est mise à jour et que des éléments sont déplacés, ou supprimés et insérés. Cette propriété body contient une liste d’objets UpdateCollectionRange indiquant de quelle manière la collection a été modifiée. Si les plages de collection de mise à jour sont appliquées dans l’ordre, les éléments de la collection spécifiée sont ordonnés de façon cohérente.



Propriétés publiques
 PropriétéDéfini par
 Inheritedbody : Object
Le corps d’un message contient les données spécifiques à délivrer à la destination distante.
AbstractMessage
 InheritedclientId : String
L’ID clientId indique quelle classe MessageAgent a envoyé le message.
AbstractMessage
  collectionId : Object
Identificateur unique de la collection mise à jour.
UpdateCollectionMessage
 Inheritedconstructor : Object
Référence à l’objet de classe ou à la fonction constructeur d’une occurrence donnée d’un objet.
Object
 InheritedcorrelationId : String
Fournit un accès à l’ID de corrélation du message.
AsyncMessage
 Inheriteddestination : String
Destination du message.
AbstractMessage
 Inheritedheaders : Object
Les en-têtes d’un message sont un tableau associatif où la clé est le nom d’en-tête et la valeur la valeur d’en-tête.
AbstractMessage
 Inheritedidentity : Object
Permet d’accéder au mappage d’identités définissant l’identité unique de l’élément affecté par cette instance DataMessage (concerne les opérations de création/mise à jour/suppression, mais pas les opérations de remplissage).
DataMessage
 InheritedmessageId : String
ID unique du message.
AbstractMessage
 Inheritedoperation : uint
Permet d’accéder à l’opération/la commande de cette instance DataMessage.
DataMessage
  replace : Boolean
Indique si l’intégralité de la collection doit être remplacée par le contenu de ce message.
UpdateCollectionMessage
 Inheritedtimestamp : Number
Fournit un accès à l’horodatage du message.
AbstractMessage
 InheritedtimeToLive : Number
La valeur de la durée de vie d’un message indique la durée pendant laquelle le message doit être considéré comme valide et délivrable.
AbstractMessage
  updateMode : int
Indique l’état de cette mise à jour.
UpdateCollectionMessage
Méthodes publiques
 MéthodeDéfini par
  
Crée une nouvelle instance de classe UpdateCollectionMessage vide.
UpdateCollectionMessage
 Inherited
[statique] Fournit une description de l’opération spécifiée.
DataMessage
 Inherited
Indique si la propriété spécifiée d’un objet est définie.
Object
 Inherited
Renvoie true s’il s’agit d’une opération de création.
DataMessage
 Inherited
Renvoie true si le message est une mise à jour et que la longueur de sa liste de noms de propriété est égale à zéro.
DataMessage
 Inherited
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
 Inherited
Indique si la propriété spécifiée existe et est énumérable.
Object
 Inherited
Définit la disponibilité d’une propriété dynamique pour les opérations en boucle.
Object
 Inherited
Renvoie la représentation de chaîne de cet objet, formatée selon les paramètres régionaux en vigueur.
Object
 Inherited
Renvoie une représentation de chaîne du message.
AbstractMessage
 Inherited
Renvoie la valeur primitive de l’objet spécifié.
Object
Constantes publiques
 ConstanteDéfini par
  CLIENT_UPDATE : int = 0
[statique] Indique que ce message de collection de mise à jour a été généré par un client.
UpdateCollectionMessage
  SERVER_OVERRIDE : int = 2
[statique] Indique que ce message de mise à jour de collection a été généré par un client et que la destination distante a déterminé qu’il doit être rétabli sur ce client.
UpdateCollectionMessage
  SERVER_UPDATE : int = 1
[statique] Indique que ce message de collection de mise à jour a été généré à distance et qu’il est basé sur l’état actuel de la séquence distante.
UpdateCollectionMessage
Détails de la propriété

collectionId

propriété
public var collectionId:Object

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

Identificateur unique de la collection mise à jour. Si la collection a été remplie par la méthode DataService.fill(), cette propriété contient un tableau des paramètres spécifiés.

replace

propriété 
public var replace:Boolean

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

Indique si l’intégralité de la collection doit être remplacée par le contenu de ce message. Lorsque le nombre de modifications apportées à une séquence distante atteint un seuil de basculement, un message de remplacement est généré sous forme d’optimisation. Si la valeur est true, la propriété body contient un tableau d’identités d’élément devant remplacer les éléments existants.

updateMode

propriété 
public var updateMode:int

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

Indique l’état de cette mise à jour. La destination distante envoie des messages de collection de mise à jour aux clients, en utilisant l’un des trois modes de mise à jour :

  • UpdateCollectionMessage.SERVER_UPDATE : le client applique cette collection de mise à jour sans condition.
  • UpdateCollectionMessage.CLIENT_UPDATE : il n’est pas nécessaire que le client de validation traite cette collection de mise à jour.
  • UpdateCollectionMessage.SERVER_OVERRIDEN : la destination distante a modifié le message de mise à jour de collection envoyé par le client et le client de validation doit rétablir cette mise à jour de collection.

Détails du constructeur

UpdateCollectionMessage

()Constructeur
public function UpdateCollectionMessage()

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

Crée une nouvelle instance de classe UpdateCollectionMessage vide.

Détails de la constante

CLIENT_UPDATE

Constante
public static const CLIENT_UPDATE:int = 0

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

Indique que ce message de collection de mise à jour a été généré par un client.

Eléments de l’API associés

SERVER_OVERRIDE

Constante 
public static const SERVER_OVERRIDE:int = 2

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

Indique que ce message de mise à jour de collection a été généré par un client et que la destination distante a déterminé qu’il doit être rétabli sur ce client. Un autre message de collection de mise à jour sera ensuite généré ; celui-ci contiendra les valeurs correctes à appliquer pour rétablir la cohérence entre la collection du client et la collection distante.

Eléments de l’API associés

SERVER_UPDATE

Constante 
public static const SERVER_UPDATE:int = 1

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

Indique que ce message de collection de mise à jour a été généré à distance et qu’il est basé sur l’état actuel de la séquence distante.

Eléments de l’API associés





[ X ]Pourquoi existe-t-il du contenu en anglais ?
Certaines parties du Guide de référence ActionScript 3.0 sont en anglais

Tout le contenu du Guide de référence ActionScript 3.0 n’a pas été traduit dans toutes les langues. Si un élément de langage n’est pas traduit, il s’affiche en anglais. Par exemple, la classe ga.controls.HelpBox n’est traduite dans aucune langue. Ainsi, dans la version française du guide de référence, la classe ga.controls.HelpBox apparaît en anglais.