| Package | mx.data |
| Classe | public class RPCDataServiceAdapter |
| Héritage | RPCDataServiceAdapter  DataServiceAdapter 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 |
La principale difficulté liée à la manière dont ce service fonctionne est la suivante : nous voulons prendre le contrôle de l’appel de service existant, de sorte que le code utilisateur soit le moins affecté possible par l’ajout de la gestion de données. L’appel de service fonctionne de la même manière. Les mêmes événements et jetons sont distribués, mais le résultat doit être géré. Pour que tout fonctionne correctement, l’instance RPCDataServiceAdapter a associé une opération ManagedOperation à une opération de service RPC standard. La propriété operationManager de l’opération est définie et, au moment de l’initialisation et de l’appel de l’utilisateur final, elle est redirigée vers une méthode proxy de cette classe (par exemple queryProxy). L’appel de gestion de données correspondant est ainsi généré et le jeton géré est renvoyé à l’utilisateur final, de sorte qu’il puisse obtenir le résultat de l’opération gérée.
order is:
user calls service method
calls service delegates to operationManager - ManagedOpertion.xxProxy methods
calls managerOperation kicks off DMS op --> DataManager.xx
calls DMS op calls adapter to do the op --> DataServiceAdapter.invoke
calls: RPCDataServiceAdapter invokes the service operation and sets the "raw" lastResult
returns: adapter's result comes back in and is converted to DMS Result Message - RPCDataServiceResult.xxResult
returns: data manager processes result - updates managed object --> DataListRequestResponder/CommitResponder
returns: service is updated to lastResult from the operation
returns: user's result event is called
Masquer les propriétés publiques héritées
Afficher les propriétés publiques héritées| Propriété | Défini par | ||
|---|---|---|---|
| asyncRequest : AsyncRequest [override] [lecture seule]
Méthode abstraite renvoyant un objet AsyncRequest utilisé pour traiter toutes les opérations DataService. | RPCDataServiceAdapter | ||
 | connected : Boolean [lecture seule]
Renvoie true lorsque ce service d’adaptateur est connecté à sa source. | DataServiceAdapter | |
| constructor : Object
Référence à l’objet de classe ou à la fonction constructeur d’une occurrence donnée d’un objet. | Object | |
| dataManagerRegistry : Object [statique]
Correspondance statique entre chaque nom de destination et le gestionnaire de données pour cette destination. | RPCDataServiceAdapter | ||
| dataStore : DataStore
Contient un objet de type mx.data.DataStore. | DataServiceAdapter | |
| destination : String
Nom de destination pour cet adaptateur de service de données. | RPCDataServiceAdapter | ||
| serializeAssociations : Boolean [override] [lecture seule]
Elle détermine si DMS enveloppe ou non les éléments dans un descripteur de sérialisation excluant les associations. | RPCDataServiceAdapter | ||
| throwUnhandledFaults : Boolean [override] [lecture seule]
Renvoie la valeur false car ce gestionnaire de données ne renvoie pas d’erreur s’il existe une erreur d’absence d’écouteurs sur le gestionnaire des données. | RPCDataServiceAdapter | ||
| Méthode | Défini par | ||
|---|---|---|---|
Cette méthode est appelée par la classe RPCDataServiceAdapter dans le but de réaliser l’opération createItem. | RPCDataServiceAdapter | ||
Cette méthode est appelée par la classe RPCDataServiceAdapter lorsque la couche de gestion souhaite supprimer un élément du serveur. | RPCDataServiceAdapter | ||
executeQuery(dataManager:RPCDataManager, queryName:String, includeSpecifier:PropertySpecifier, queryArgs:Array):mx.rpc:AsyncToken
Appelée lorsque l’adaptateur doit exécuter une requête nommée. | RPCDataServiceAdapter | ||
Renvoie un tableau des noms de propriété qui créent un conflit entre la version du client d’un élément et la version du serveur. | RPCDataServiceAdapter | ||
[override]
Retrouve le gestionnaire de données d’une destination spécifiée. | RPCDataServiceAdapter | ||
|
Recherche un adaptateur de service de données associé. | DataServiceAdapter | |
getItem(dataManager:RPCDataManager, identity:Object, defaultValue:Object = null, includeSpecifier:PropertySpecifier = null):mx.rpc:AsyncToken
Appelée pour extraire un élément individuel d’un adaptateur à partir de son identité. | RPCDataServiceAdapter | ||
getItems(dataManager:RPCDataManager, ids:Array, includeSpecifier:PropertySpecifier):mx.rpc:AsyncToken
Méthode d’adaptateur appelée lorsqu’une liste d’éléments doit être récupérée pour une destination spécifique. | RPCDataServiceAdapter | ||
Cette méthode est appelée une fois que le traitement d’une erreur liée à une opération de création, de mise à jour, de suppression ou de mise à jour de collection est terminé. | RPCDataServiceAdapter | ||
|
Indique si la propriété spécifiée d’un objet est définie. | Object | |
|
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 | |
pageQuery(dataManager:RPCDataManager, queryName:String, queryArgs:Array, startIndex:int, numItems:int):mx.rpc:AsyncToken
Exécute une requête pour une page unique d’une requête côté client. | RPCDataServiceAdapter | ||
Simule un événement à partir du serveur qui correspond à la suppression d’un élément. | RPCDataServiceAdapter | ||
postItemUpdate(dataManager:RPCDataManager, item:Object, origItem:Object = null, changes:Array = null):void
Simule un événement à partir du serveur qui correspond à la mise à jour ou la création d’un élément. | RPCDataServiceAdapter | ||
Méthode de bas niveau utilisée par la classe DataManager pour traiter un message de données. | RPCDataServiceAdapter | ||
|
Indique si la propriété spécifiée existe et est énumérable. | Object | |
|
Définit la disponibilité d’une propriété dynamique pour les opérations en boucle. | Object | |
Cette méthode est appelée lorsqu’une erreur signale un conflit possible sur le serveur. | RPCDataServiceAdapter | ||
|
Renvoie la représentation de chaîne de cet objet, formatée selon les paramètres régionaux en vigueur. | Object | |
|
Renvoie la représentation sous forme de chaîne de l’objet spécifié. | Object | |
updateCollection(dataManager:RPCDataManager, mq:ManagedQuery, ucmsg:UpdateCollectionMessage):mx.rpc:AsyncToken
Cette méthode est appelée lorsque des éléments sont ajoutés ou supprimés dans une collection gérée par une requête (et non par une association). | RPCDataServiceAdapter | ||
updateItem(dataManager:RPCDataManager, item:Object, origItem:Object, changes:Array):mx.rpc:AsyncToken
Cette méthode est appelée par la classe RPCDataServiceAdapter dans le but de réaliser une opération updateItem spécifique. | RPCDataServiceAdapter | ||
|
Renvoie la valeur primitive de l’objet spécifié. | Object | |
| Méthode | Défini par | ||
|---|---|---|---|
Cette méthode est appelée lorsqu’une erreur susceptible d’indiquer un conflit est reçue. | RPCDataServiceAdapter | ||
internalGetItem(dataManager:RPCDataManager, identity:Object, defaultValue:Object = null, includeSpecifier:PropertySpecifier = null):mx.rpc:AsyncToken
Cette méthode exécute en fait l’opération getItem, mais le gestionnaire de résultat n’est pas utilisé pour mettre à jour le résultat géré. | RPCDataServiceAdapter | ||
Répondeur d’erreur pour les opérations RPCDataService. | RPCDataServiceAdapter | ||
Répondeur de réussite pour les opérations RPCDataService. | RPCDataServiceAdapter | ||
asyncRequest | propriété |
asyncRequest:AsyncRequest [lecture seule] [override] | 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 |
Méthode abstraite renvoyant un objet AsyncRequest utilisé pour traiter toutes les opérations DataService. En remplaçant la méthode AsyncRequest.invoke, vous pouvez intercepter les demandes gérées. La classe AsyncRequest expose les différentes méthodes permettant de déterminer si le service est connecté ou déconnecté.
Implémentation
override public function get asyncRequest():AsyncRequestdataManagerRegistry | propriété |
public static var dataManagerRegistry: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 |
Correspondance statique entre chaque nom de destination et le gestionnaire de données pour cette destination.
destination | propriété |
public var destination:String| 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 |
Nom de destination pour cet adaptateur de service de données.
serializeAssociations | propriété |
serializeAssociations:Boolean [lecture seule] [override] | 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 |
Elle détermine si DMS enveloppe ou non les éléments dans un descripteur de sérialisation excluant les associations. La classe MessagingDataServiceAdapter utilise cette approche pour envoyer des associations (non utilisée dans la classe RPCDataServiceAdapter).
Implémentation
override public function get serializeAssociations():BooleanthrowUnhandledFaults | propriété |
throwUnhandledFaults:Boolean [lecture seule] [override] | 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 |
Renvoie la valeur false car ce gestionnaire de données ne renvoie pas d’erreur s’il existe une erreur d’absence d’écouteurs sur le gestionnaire des données. Dans le cas des services RPC, ces erreurs sont transmises par proxy aux écouteurs du serveur et il est donc inadéquat de renvoyer l’erreur.
Implémentation
override public function get throwUnhandledFaults():BooleancheckForConflict | () | méthode |
protected function checkForConflict(resultEvent:ResultEvent, token:mx.rpc:AsyncToken):void| 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 |
Cette méthode est appelée lorsqu’une erreur susceptible d’indiquer un conflit est reçue. Dans le gestionnaire d’erreur de cette erreur, émettez un appel getItem() afin d’extraire la version actuelle de l’élément sur le serveur.
Il peut notamment être utile de remplacer cette méthode pour prendre les mesures nécessaires lorsqu’aucun conflit n’est détecté.
Paramètres
resultEvent:ResultEvent — Objet d’événement de l’appel getItem().
| |
token:mx.rpc:AsyncToken — Contient une propriété cause, qui correspond à l’instance DataMessage d’origine de la modification. Cette méthode peut appeler Conflicts.raiseConflict() lorsqu’un conflit est détecté ou ne rien faire si elle ne détecte pas de conflit.
|
createItem | () | méthode |
public function createItem(dataManager:RPCDataManager, item:Object):mx.rpc:AsyncToken| 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 |
Cette méthode est appelée par la classe RPCDataServiceAdapter dans le but de réaliser l’opération createItem. L’implémentation par défaut consiste à appeler l’opération gérée enregistrée pour l’opération createItem en utilisant l’élément comme premier paramètre. Si vous souhaitez appeler plusieurs services ou modifier la signature de paramètres de cette opération, vous pouvez étendre la classe RPCDataServiceAdapter et remplacer la méthode createItem.
Paramètres
dataManager:RPCDataManager — gestionnaire en charge de l’opération de création à invoquer.
| |
item:Object — élément à créer.
|
mx.rpc:AsyncToken — Vous pouvez utiliser le jeton pour enregistrer une ou plusieurs fonctions de rappel afin de recevoir les événements de résultat ou d’erreur issus de cette opération de création. Ce jeton est également renvoyé dans la propriété call de ResultEvent.RESULT ou dans FaultEvent.FAULT. Des données personnalisées peuvent être jointes à cet objet et examinées ultérieurement au cours de la phase de traitement d’événement.
|
deleteItem | () | méthode |
public function deleteItem(dataManager:RPCDataManager, item:Object):mx.rpc:AsyncToken| 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 |
Cette méthode est appelée par la classe RPCDataServiceAdapter lorsque la couche de gestion souhaite supprimer un élément du serveur. L’élément à supprimer est fourni comme argument. L’implémentation par défaut de cette méthode recherche une opération ManagedOperation de type delete. Cette méthode est appelée en utilisant l’élément à supprimer ou son ID si la propriété parameters de l’opération ManagedOperation est définie sur id.
Paramètres
dataManager:RPCDataManager — gestionnaire en charge de l’opération de suppression à invoquer.
| |
item:Object — élément à supprimer.
|
mx.rpc:AsyncToken — Vous pouvez utiliser le jeton pour enregistrer une ou plusieurs fonctions de rappel afin de recevoir les événements de résultat ou d’erreur issus de cette opération de suppression. Ce jeton est également renvoyé dans la propriété call de ResultEvent.RESULT ou dans FaultEvent.FAULT. Des données personnalisées peuvent être jointes à cet objet et examinées ultérieurement au cours de la phase de traitement d’événement.
|
executeQuery | () | méthode |
public function executeQuery(dataManager:RPCDataManager, queryName:String, includeSpecifier:PropertySpecifier, queryArgs:Array):mx.rpc:AsyncToken| 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 |
Appelée lorsque l’adaptateur doit exécuter une requête nommée. Si la pagination est activée, la première page de la collection est ainsi récupérée.
Paramètres
dataManager:RPCDataManager — gestionnaire en charge de l’opération d’interrogation à invoquer.
| |
queryName:String — nom de la requête
| |
includeSpecifier:PropertySpecifier — jeu de propriétés à récupérer.
| |
queryArgs:Array — arguments de l’invocation d’opération de requête.
|
mx.rpc:AsyncToken — Vous pouvez utiliser le jeton pour enregistrer une ou plusieurs fonctions de rappel afin de recevoir les événements de résultat ou d’erreur issus de cette opération d’interrogation. Ce jeton est également renvoyé dans la propriété call de ResultEvent.RESULT ou dans FaultEvent.FAULT. Des données personnalisées peuvent être jointes à cet objet et examinées ultérieurement au cours de la phase de traitement d’événement.
|
getConflictingProperties | () | méthode |
public function getConflictingProperties(dmgr:RPCDataManager, cause:DataMessage, serverObject:Object):Array| 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 |
Renvoie un tableau des noms de propriété qui créent un conflit entre la version du client d’un élément et la version du serveur. Renvoie la valeur null en l’absence de conflit.
Paramètres
dmgr:RPCDataManager — gestionnaire de données associé.
| |
cause:DataMessage — message de données dont le traitement peut avoir déclenché un conflit.
| |
serverObject:Object — version de l’élément du serveur.
|
Array — un tableau des noms de propriété qui créent un conflit entre la version du client d’un élément et la version du serveur. Renvoie la valeur null en l’absence de conflit.
|
getDataManager | () | méthode |
override public function getDataManager(destination:String):DataManager| 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 |
Retrouve le gestionnaire de données d’une destination spécifiée.
Paramètres
destination:String — Destination
|
DataManager — Objet DataManager correspondant à la destination.
|
getItem | () | méthode |
public function getItem(dataManager:RPCDataManager, identity:Object, defaultValue:Object = null, includeSpecifier:PropertySpecifier = null):mx.rpc:AsyncToken| 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 |
Appelée pour extraire un élément individuel d’un adaptateur à partir de son identité. Le paramètre includeSpecifier spécifie l’ensemble de propriétés demandé.
Paramètres
dataManager:RPCDataManager — gestionnaire de données associé.
| |
identity:Object — identité de l’élément à récupérer.
| |
defaultValue:Object (default = null) | |
includeSpecifier:PropertySpecifier (default = null) |
mx.rpc:AsyncToken — Liaison AsyncToken à la propriété de résultat de l’objet AsyncToken à partir duquel le résultat doit être extrait. Vous pouvez également écouter l’événement change de la propriété de résultat, ajouter un ou plusieurs répondeurs au jeton et ajouter des informations supplémentaires en tant que propriétés dynamiques du jeton afin de réaliser un suivi des résultats de l’opération.
|
getItems | () | méthode |
public function getItems(dataManager:RPCDataManager, ids:Array, includeSpecifier:PropertySpecifier):mx.rpc:AsyncToken| 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 |
Méthode d’adaptateur appelée lorsqu’une liste d’éléments doit être récupérée pour une destination spécifique. La classe PropertySpecifier indique l’ensemble minimal de propriétés nécessaires. L’implémentation par défaut de cette méthode consiste à appeler la méthode getItem à plusieurs reprises. Si votre serveur peut réaliser cette opération de façon plus efficace, il peut être utile d’implémenter cette méthode pour améliorer certaines opérations.
Paramètres
dataManager:RPCDataManager — gestionnaire de données associé.
| |
ids:Array — tableau d’identités des éléments à récupérer.
| |
includeSpecifier:PropertySpecifier — [facultatif] jeu de propriétés à récupérer.
|
mx.rpc:AsyncToken — Liaison AsyncToken à la propriété de résultat de l’objet AsyncToken à partir duquel le résultat doit être extrait. Vous pouvez également écouter l’événement change de la propriété de résultat, ajouter un ou plusieurs répondeurs au jeton et ajouter des informations supplémentaires en tant que propriétés dynamiques du jeton afin de réaliser un suivi des résultats de l’opération.
|
handleFault | () | méthode |
public function handleFault(errMsg:ErrorMessage, cause:DataMessage):void| 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 |
Cette méthode est appelée une fois que le traitement d’une erreur liée à une opération de création, de mise à jour, de suppression ou de mise à jour de collection est terminé. Elle permet à l’adaptateur de personnaliser la logique associée au traitement de l’erreur et de détecter les éventuels conflits. L’implémentation par défaut implémente la fonctionnalité conflictMode de la classe RPCDataManager. Lorsqu’une erreur liée à une opération UPDATE ou DELETE est reçue, la version actuelle présente sur le serveur de l’objet mis à jour ou supprimé est comparée à la version d’origine. Si la version du serveur est différente, un conflit est signalé. Cela suppose que la modification à l’origine de l’erreur a déjà été replacée dans le lot des modifications non validées.
Paramètres
errMsg:ErrorMessage — Description de l’erreur.
| |
cause:DataMessage — Opération qui a provoqué l’erreur.
|
internalGetItem | () | méthode |
protected function internalGetItem(dataManager:RPCDataManager, identity:Object, defaultValue:Object = null, includeSpecifier:PropertySpecifier = null):mx.rpc:AsyncToken| 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 |
Cette méthode exécute en fait l’opération getItem, mais le gestionnaire de résultat n’est pas utilisé pour mettre à jour le résultat géré. Cette méthode est utilisée par l’implémentation getItem par défaut pour appeler l’opération. Lorsque la détection des conflits est activée, si une erreur liée à une opération de mise à jour ou de suppression est reçue, cette méthode est appelée pour extraire la version de l’objet actuellement sur le serveur, afin de déterminer si l’erreur est ou non le signe d’un conflit et d’obtenir la version du serveur pour résoudre ce conflit.
Paramètres
dataManager:RPCDataManager — gestionnaire de données associé.
| |
identity:Object — identité de l’élément à récupérer.
| |
defaultValue:Object (default = null) | |
includeSpecifier:PropertySpecifier (default = null) |
mx.rpc:AsyncToken — Liaison AsyncToken à la propriété de résultat de l’objet AsyncToken à partir duquel le résultat doit être extrait. Vous pouvez également écouter l’événement change de la propriété de résultat, ajouter un ou plusieurs répondeurs au jeton et ajouter des informations supplémentaires en tant que propriétés dynamiques du jeton afin de réaliser un suivi des résultats de l’opération.
|
pageQuery | () | méthode |
public function pageQuery(dataManager:RPCDataManager, queryName:String, queryArgs:Array, startIndex:int, numItems:int):mx.rpc:AsyncToken| 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 |
Exécute une requête pour une page unique d’une requête côté client. Cette méthode est appelée lorsque la propriété pagingEnabled est activée dans une instance ManagedQuery. Le code client envoie la requête normalement, en utilisant les paramètres de requête habituels. La couche de gestion insère les paramètres startIndex et numItems avant de réaliser l’appel.
Paramètres
dataManager:RPCDataManager — gestionnaire en charge de l’opération d’interrogation à invoquer.
| |
queryName:String — nom de la requête
| |
queryArgs:Array — arguments de l’invocation d’opération de requête.
| |
startIndex:int — index de départ de la page à récupérer.
| |
numItems:int — taille de page.
|
mx.rpc:AsyncToken — Vous pouvez utiliser le jeton pour enregistrer une ou plusieurs fonctions de rappel afin de recevoir les événements de résultat ou d’erreur issus de cette opération d’interrogation. Ce jeton est également renvoyé dans la propriété call de ResultEvent.RESULT ou dans FaultEvent.FAULT. Des données personnalisées peuvent être jointes à cet objet et examinées ultérieurement au cours de la phase de traitement d’événement.
|
postItemDeletion | () | méthode |
public function postItemDeletion(dataManager:RPCDataManager, identity:Object):void| Version du langage: | ActionScript 3.0 |
| Version du produit: | Adobe Digital Enterprise Platform Data Services for Java EE 3.1 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.5 |
Simule un événement à partir du serveur qui correspond à la suppression d’un élément. Cette option est utile pour informer LCDS qu’un élément a été supprimé sur le serveur.
Paramètres
dataManager:RPCDataManager — gestionnaire de données associé.
| |
identity:Object — l’identité de l’élément supprimé.
|
postItemUpdate | () | méthode |
public function postItemUpdate(dataManager:RPCDataManager, item:Object, origItem:Object = null, changes:Array = null):void| Version du langage: | ActionScript 3.0 |
| Version du produit: | Adobe Digital Enterprise Platform Data Services for Java EE 3.1 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.5 |
Simule un événement à partir du serveur qui correspond à la mise à jour ou la création d’un élément. Cette option est utile pour informer LCDS qu’un élément a été modifié sur le serveur.
Paramètres
dataManager:RPCDataManager — le gestionnaire de données associé.
| |
item:Object — l’élément mis à jour.
| |
origItem:Object (default = null) | |
changes:Array (default = null) |
processDataMessage | () | méthode |
public function processDataMessage(msg:IMessage, responder:IResponder):void| 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 |
Méthode de bas niveau utilisée par la classe DataManager pour traiter un message de données. Elle convertit le message de données en appels d’interface d’adaptateur. Vous pouvez par conséquent remplacer l’une de ces opérations.
Paramètres
msg:IMessage — message à traiter.
| |
responder:IResponder — répondeur à rappeler une fois le traitement du message terminé.
|
rpcAdapterFault | () | méthode |
protected function rpcAdapterFault(ev:FaultEvent, token:mx.rpc:AsyncToken):void| 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 |
Répondeur de défaillance pour les opérations RPCDataService. Gère les défaillances en créant le message d’erreur appropriée et en le propageant le long de la chaîne de réponse du jeton.
Paramètres
ev:FaultEvent — événement d’erreur reçu du serveur.
| |
token:mx.rpc:AsyncToken — jeton associé à l’invocation.
|
sendResultEvent | () | méthode |
protected function sendResultEvent(token:mx.rpc:AsyncToken, msg:IMessage):void| 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 |
Répondeur de réussite pour les opérations RPCDataService. Enveloppe le message reçu dans un événement de message et le propage le long de la chaîne de réponse du jeton.
Paramètres
token:mx.rpc:AsyncToken — jeton associé à l’invocation.
| |
msg:IMessage — message de résultat reçu du serveur
|
startCheckForConflict | () | méthode |
public function startCheckForConflict(dmgr:RPCDataManager, cause:DataMessage, errMsg:ErrorMessage = null):void| 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 |
Cette méthode est appelée lorsqu’une erreur signale un conflit possible sur le serveur. Nous allons essayer d’obtenir les valeurs actuelles de l’élément en conflit, puis les comparer à l’élément d’origine dans la modification que nous avons essayé d’appliquer. Si des différences existent, il s’agit d’un conflit à signaler.
Paramètres
dmgr:RPCDataManager — gestionnaire de données associé à la destination de cet adaptateur.
| |
cause:DataMessage — message de données d’origine ayant potentiellement provoqué un conflit.
| |
errMsg:ErrorMessage (default = null) |
updateCollection | () | méthode |
public function updateCollection(dataManager:RPCDataManager, mq:ManagedQuery, ucmsg:UpdateCollectionMessage):mx.rpc:AsyncToken| 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 |
Cette méthode est appelée lorsque des éléments sont ajoutés ou supprimés dans une collection gérée par une requête (et non par une association). Il s’agit d’un seul message, contenant une liste de modifications individuelles. Bien souvent, il n’est pas nécessaire de remplacer cette méthode, car ces modifications ne sont pas requises pour que les modifications réalisées sur le client soient persistantes.
Si vous implémentez des associations à l’aide de requêtes, par exemple une relation plusieurs-à-plusieurs, il peut cependant être utile d’ajouter ou de supprimer une ligne au cours de ces opérations.
L’implémentation RPCDataServiceAdapter mappe ces opérations à des appels individuels d’ajout et de suppression.
Paramètres
dataManager:RPCDataManager — gestionnaire de données associé à la destination de cet adaptateur.
| |
mq:ManagedQuery — requête gérée pour laquelle des éléments ont été ajoutés ou supprimés.
| |
ucmsg:UpdateCollectionMessage — message de collection de mise à jour qui détaille les éléments qui ont été ajoutés ou supprimés
|
mx.rpc:AsyncToken — Référence ASyncToken au jeton qui identifie cette opération dans un événement de résultat ou d’erreur distribué par ce service.
|
updateItem | () | méthode |
public function updateItem(dataManager:RPCDataManager, item:Object, origItem:Object, changes:Array):mx.rpc:AsyncToken| 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 |
Cette méthode est appelée par la classe RPCDataServiceAdapter dans le but de réaliser une opération updateItem spécifique. Elle reçoit la nouvelle version de l’élément, la version d’origine de cet élément avant la modification sur le client, ainsi que la liste des propriétés modifiées. L’implémentation par défaut recherche une opération ManagedOperation de type update et l’appelle. L’opération gérée accepte au minimum la nouvelle version de l’élément en tant que paramètre. Si elle déclare en plus des paramètres utilisant les noms spéciaux « origItem » et « changes », ces paramètres sont également fournis au service distant.
Paramètres
dataManager:RPCDataManager — gestionnaire de données.
| |
item:Object — nouvelle version de l’élément.
| |
origItem:Object — élément d’origine.
| |
changes:Array — liste des propriétés à modifier.
|
mx.rpc:AsyncToken — Référence ASyncToken au jeton qui identifie cette opération dans un événement de résultat ou d’erreur distribué par ce service.
|
Tue Jun 12 2018, 09:30 AM Z