DataMessage  - AS3 ADEP Data Services

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

Permet d’accéder à l’opération/la commande de cette instance DataMessage. Les opérations indiquent comment la destination distante doit traiter ce message. Pour afficher une description du type d’opération, utilisez la méthode getOperationAsString.

Eléments de l’API associés

Constructeur.

Fournit une description de l’opération spécifiée. Cette méthode est utilisée dans les opérations toString() sur ce message.

Paramètres

         var msg:DataMessage = DataMessage(event.message);
         trace("Current operation -'"+
                DataMessage.getOperationAsString(msg.operation)+ "'.");
      

Renvoie true s’il s’agit d’une opération de création.

Eléments de l’API associés

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.

Cette opération représente un ensemble d’opérations en lots à réaliser en bloc. Les clients envoient un lot lorsque la méthode DataManager.commit() est appelée. Tous les messages du lot visent la même destination. La propriété body contient tous les messages appartenant à ce lot.

Cette opération demande l’appel d’une méthode <count-method> configurée sur une destination distante. La propriété body du message contient les arguments à transmettre à la destination distante lors de l’appel de la méthode. Les clients envoient cette opération lorsque la méthode DataService.count() est appelée.

Eléments de l’API associés

Cette opération demande la création de l’élément spécifié à partir d’une destination distante. Les clients envoient cette opération lorsque la méthode DataService.createItem() est appelée. La propriété body contient l’élément à créer.

Eléments de l’API associés

Indique une opération de création. La propriété body contiendra l’élément à créer. Lorsque l’opération est réalisée à l’extérieur d’une association, un message UpdateCollectionMessage correspondant est livré pour indiquer l’emplacement/l’index où l’élément doit être ajouté. Les clients envoient cette opération lorsqu’une collection gérée par une classe DataService utilise la méthode IList.addItemAt(), IList.addItem() ou IViewCursor.insert().

Eléments de l’API associés

Cette opération indique que l’élément spécifié doit être supprimé. Les clients reçoivent et envoient cette opération lorsque l’élément est supprimé. Les clients envoient cette opération lorsque la méthode DataManager.deleteItem() ou une collection gérée par un gestionnaire de données utilise la méthode IList.removeItemAt() ou IViewCursor.remove().

Eléments de l’API associés

Cette opération demande à la destination distante de créer une séquence en utilisant l’adaptateur de la destination distante. La propriété body du message contient les arguments de remplissage à utiliser lors de la création de la séquence distante.

Semblable à FILL_OPERATION, mais fait en sorte qu’un seul élément soit renvoyé dans le tableau de réponse.

Cette opération demande à la destination distante d’obtenir un objet géré spécifique à partir de son ID unique. La propriété identity contient l’identité de l’objet souhaité.

Eléments de l’API associés

Cette opération demande à la destination distante un élément correspondant à l’identité spécifiée. S’il n’existe pas d’élément associé à cette identité, une opération de création est réalisée. Les clients envoient cette opération lorsque la méthode DataManager.getItem() est appelée en utilisant pour l’élément des valeurs par défaut autres que null. La propriété body contient les valeurs par défaut de l’élément, s’il est nécessaire de le créer.

Eléments de l’API associés

Cette opération demande l’ID de séquence d’un ensemble de paramètres de remplissage. Si la séquence existe, elle n’est pas recréée. Si elle n’existe pas, elle est recréée à distance. Les clients envoient cette opération lors de la reconnexion à une destination distante ou du basculement sur un nouveau nœud au sein d’un cluster. Cette opération est utilisée uniquement si l’attribut fetch de la balise <reconnect> du fichier XML de configuration de la destination distante est défini sur IDENTITY.

Eléments de l’API associés

Cette opération représente un ensemble d’opérations à réaliser en bloc, mais qui peut contenir plusieurs opérations de création, de mise à jour ou de suppression en lots susceptibles d’impliquer plus d’une destination, c’est-à-dire plus d’un adaptateur distant. Les clients envoient plusieurs lots lorsque la méthode DataManager.commit() est appelée et que des associations sont configurées pour cette destination. Les messages de ce lot sont envoyés vers plusieurs destinations.

Cette opération indique une demande de page d’éléments spécifiés par des identités. Cette opération est semblable à l’opération PAGE_OPERATION, mais dans ce cas, l’index de page n’est pas nécessaire. Les clients envoient cette opération lorsqu’ils récupèrent des éléments chargés à la demande pour les associations configurées en mode un-à-plusieurs et plusieurs-à-plusieurs.

Cette opération permet de récupérer une page de contenu en séquence distribué en plusieurs messages et non plus en un seul message. Elle représente une demande concernant une partie d’une séquence distante. Les clients envoient cette opération lorsqu’une propriété ou un élément demandé n’est pas stocké localement. Cette opération est exécutée uniquement si l’attribut enabled de la balise <paging> présente sous la balise <network> est défini sur true et que l’attribut pageSize est différent de zéro, ou si l’attribut lazy d’une association est configuré sur true.

Cette opération indique que le client ne souhaite plus recevoir de notification lorsque des opérations sont réalisées sur la collection spécifiée. Les clients envoient cette opération lorsque la méthode DataManager.releaseCollection() est appelée ou lorsque la méthode DataManager.fill() est appelée par le biais d’une classe ArrayCollection qui contenait précédemment d’autres paramètres, ou encore si l’élément propriétaire d’une association un-à-plusieurs est libéré.

Eléments de l’API associés

Cette opération indique que le client ne souhaite plus recevoir de notification lorsque des opérations sont réalisées sur l’élément spécifié. Les clients envoient cette opération lorsque la méthode DataService.releaseItem() ou ItemReference.releaseItem() est appelée.

Eléments de l’API associés

Alias distant spécifiant la classe qualifiée côté serveur correspondant à cette classe.

Cette opération demande à la destination distante de créer une séquence en utilisant l’adaptateur de la destination distante. La propriété body du message contient les arguments de remplissage à utiliser lors de la création de la séquence distante.

Cette opération est semblable à l’opération MULTI_BATCH_OPERATION, mais dans ce cas, le serveur doit encapsuler les différents lots de messages au sein d’une transaction. Cette opération est réalisée uniquement lorsque la valeur de la balise <use-transactions>, qui se trouve sous la balise <properties> du fichier xml de configuration de destination de la destination distante, est true

Code désignant un type d’opération inconnu.

Cette constante est utilisée pour accéder à la liste des noms de propriété modifiés. Utilisez cette propriété en l’encadrant de crochets dans la propriété body d’un message au sein d’un élément operation de l’opération UPDATE_OPERATION.

Eléments de l’API associés

         var msg:DataMessage = DataMessage(event.message);
         if (msg.operation == DataMessage.UPDATE_OPERATION)
         {
            // look at each change and display the old and new values
            var propertyNames:Array = msg.body[DataMessage.UPDATE_BODY_CHANGES];
            var newValues:Object = msg.body[DataMessage.UPDATE_BODY_NEW];
            var oldValues:Object = msg.body[DataMessage.UPDATE_BODY_PREV];
            var propertyName:String;
            for (var i:int=0; i<propertyNames.length; i++)
            {
                propertyName = propertyNames[i];
                trace("Property '"+ propertyName + "' was changed from '" +
                      oldValues[propertyName] + "' to '"+ newValues[propertyName] +
                      "'.");
            }
         }
      

Cette constante est utilisée pour accéder à la nouvelle valeur d’un élément modifié. Utilisez cette propriété en l’encadrant de crochets dans la propriété body d’un message au sein d’un élément operation de l’opération UPDATE_OPERATION.

Eléments de l’API associés

         var msg:DataMessage = DataMessage(event.message);
         if (msg.operation == DataMessage.UPDATE_OPERATION)
         {
            // look at each change and display the old and new values
            var propertyNames:Array = msg.body[DataMessage.UPDATE_BODY_CHANGES];
            var newValues:Object = msg.body[DataMessage.UPDATE_BODY_NEW];
            var oldValues:Object = msg.body[DataMessage.UPDATE_BODY_PREV];
            var propertyName:String;
            for (var i:int=0; i<propertyNames.length; i++)
            {
                propertyName = propertyNames[i];
                trace("Property '"+ propertyName + "' was changed from '" +
                      oldValues[propertyName] + "' to '"+ newValues[propertyName] +
                      "'.");
            }
         }
      

Cette constante est utilisée pour accéder à la valeur précédente de l’élément modifié. Utilisez cette propriété en l’encadrant de crochets dans la propriété body d’un message au sein d’un élément operation de l’opération UPDATE_OPERATION.

Eléments de l’API associés

         var msg:DataMessage = DataMessage(event.message);
         if (msg.operation == DataMessage.UPDATE_OPERATION)
         {
            // look at each change and display the old and new values
            var propertyNames:Array = msg.body[DataMessage.UPDATE_BODY_CHANGES];
            var newValues:Object = msg.body[DataMessage.UPDATE_BODY_NEW];
            var oldValues:Object = msg.body[DataMessage.UPDATE_BODY_PREV];
            var propertyName:String;
            for (var i:int=0; i<propertyNames.length; i++)
            {
                propertyName = propertyNames[i];
                trace("Property '"+ propertyName + "' was changed from '" +
                      oldValues[propertyName] + "' to '"+ newValues[propertyName] +
                      "'.");
            }
         }
      

Cette opération est envoyée lorsqu’une séquence locale ou distante a été modifiée par une ou plusieurs opérations d’insertion ou de suppression. Cette opération fournit des informations sur les emplacements des opérations d’insertion et de suppression, de sorte que l’état de la collection puisse être restauré.

La propriété body contient un tableau d’objets UpdateCollectionRanges indiquant quels éléments ont été supprimés ou ajoutés. 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.

Cette opération indique qu’une mise à jour d’un objet de données a été réalisée. Les clients envoient et reçoivent cette opération lorsqu’un élément est mis à jour.

La propriété body du message est un tableau contenant des informations spécifiques sur la mise à jour réalisée. L’emplacement de DataMessage.UPDATE_BODY_CHANGES au sein du tableau contient un tableau de noms de propriété modifiés au cours de la mise à jour.

L’emplacement de DataMessage.UPDATE_BODY_NEW au sein du tableau contient l’objet à son nouvel état modifié. L’emplacement de DataMessage.UPDATE_BODY_NEW au sein du tableau contient l’objet à son état antérieur.

         var msg:DataMessage = DataMessage(event.message);
         if (msg.operation == DataMessage.UPDATE_OPERATION)
         {
            // look at each change and display the old and new values
            var propertyNames:Array = msg.body[DataMessage.UPDATE_BODY_CHANGES];
            var newValues:Object = msg.body[DataMessage.UPDATE_BODY_NEW];
            var oldValues:Object = msg.body[DataMessage.UPDATE_BODY_PREV];
            var propertyName:String;
            for (var i:int=0; i<propertyNames.length; i++)
            {
                propertyName = propertyNames[i];
                trace("Property '"+ propertyName + "' was changed from '" +
                      oldValues[propertyName] + "' to '"+ newValues[propertyName] +
                      "'.");
            }
         }