RPCDataServiceAdapter  - AS3 ADEP Data Services

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

Correspondance statique entre chaque nom de destination et le gestionnaire de données pour cette destination.

Nom de destination pour cet adaptateur de service de données.

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

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.

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

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

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

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

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

Retrouve le gestionnaire de données d’une destination spécifiée.

Paramètres

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

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

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

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

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

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

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

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

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

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

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

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

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