| Package | mx.data |
| Classe | public class DataService |
| Héritage | DataService  DataManager Object |
| Sous-classes | DataService |
| 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 |
Pour créer une instance DataService, il est nécessaire de spécifier la destination souhaitée. Les destinations sont généralement configurées à partir du fichier services-config.xml, mais elles peuvent également être configurées dynamiquement lors de la configuration de l’exécution, comme dans le cas du développement géré par les modèles.
Deux ensembles de méthodes différents permettent d’extraire des données à partir de la destination distante spécifiée. Le premier ensemble est destiné aux objets gérés de collection. Le deuxième ensemble de méthodes est destiné aux objets gérés uniques.
Pour les objets gérés de la collection, utilisez la méthode DataService.fill(). Cette méthode remplit un objet ArrayCollection en utilisant des objets qui sont gérés par ce service.
Pour obtenir des objets gérés uniques, utilisez les méthodes DataService.getItem() et DataService.createItem().
Lorsqu’un objet ArrayCollection rempli précédemment n’est plus nécessaire ou que les éléments de cette collection ne doivent plus recevoir ou créer de mises à jour, appelez la méthode DataService.releaseCollection().
Lorsqu’un élément extrait précédemment à l’aide de la méthode DataService.getItem() ou DataService.createItem() n’est plus nécessaire ou ne doit plus recevoir ou créer de mises à jour, appelez la méthode DataService.releaseItem(). Les méthodes DataService.createItem() et DataService.getItem() renvoient une instance ItemReference que vous pouvez utiliser pour libérer une instance spécifique d’un objet géré unique. Contrairement à la méthode DataService.releaseItem(), l’appel de la méthode ItemReference.releaseItem() libère une instance spécifique d’un objet géré unique. La méthode DataService.releaseItem() libère le premier objet géré unique qu’elle trouve, dont l’identité correspond à une identité spécifiée. Ce comportement est adéquat, à condition que le nombre d’appels des méthodes DataService.getItem() et DataService.createItem() corresponde au nombre d’appels de la méthode DataService.releaseItem.
Une connexion à la destination distante est créée automatiquement la première fois que vous appelez une méthode nécessitant une connexion. Par exemple, lorsque vous appelez la méthode DataService.fill() ou DataService.commit() alors que certaines mises à jour ne sont pas validées, l’instance DataService tente d’établir une connexion vers la destination distante. Pour contraindre une instance DataService à se déconnecter, appelez la méthode DataService.disconnect(). Vous pouvez faire appel à la méthode DataService.disconnect() pour nettoyer les ressources de la destination distante qui ne sont plus nécessaires. D’autres services pouvant utiliser la même connexion physique, le fait d’appeler la méthode DataService.disconnect() peut mettre fin à la connexion.
La propriété connected, qui peut être liée, indique l’état actuel de la connexion DataService associée.
Si une destination distante a déclaré des contraintes de sécurité pour une opération, vous devez fournir des informations d’identification en appelant la méthode DataService.setCredentials(). L’appel de la méthode DataService.setCredentials() est renvoyé sous forme de commande de connexion sur la destination distante. Pour modifier les informations d’identification ou invalider la session active, appelez la méthode DataService.logout() qui libère toutes les données locales gérées. L’appel de la méthode DataService.logout() équivaut à l’appel de la méthode DataService.release().
Chaque instance DataService est dotée d’une propriété dataStore qui renvoie un objet de type mx.data.DataStore. Cet objet stocke les modifications non validées d’une ou de plusieurs instances DataService. Par défaut, une instance DataService partage la même instance DataStore avec d’autres instances DataService si elles possèdent des propriétés d’association gérées et partagent le même ensemble de canaux. Lors du partage d’une instance DataStore, le fait d’appeler la méthode commit() sur une instance DataService valide les modifications de toutes les instances DataService qui font appel à l’instance DataStore partagée. L’ordre des opérations est ainsi préservé, dans le cas où il existe des dépendances entre les modifications des instances DataService associées.
Les instances DataService et DataStore distribuent les événements de résultat et d’erreur pour toutes les opérations nécessitant un appel distant.
Remarque : si vous créez deux instances DataService qui font référence à la même destination, ces deux instances partagent la même collection d’objets gérés et distribuent le même ensemble d’événements. Par exemple, si vous ajoutez un écouteur d’événement à une instance DataService pour une destination et que vous utilisez une instance différente pour initier une opération, la première instance DataService reçoit quand même ces événements. Chaque opération initiée sur une instance DataService renvoie une instance AsyncToken. Vous pouvez ajouter un répondeur d’événement à cette instance AsyncToken pour recevoir un événement de résultat propre à cette opération. Cette approche produit en général un code plus optimisé que lorsque vous ajoutez un gestionnaire d’événement de résultat ou d’erreur au niveau global pour une destination donnée.
Vous pouvez utiliser la liaison de données sur les propriétés de n’importe quel objet géré par une instance DataService. L’instance DataService distribue également un événement « message » lorsqu’une opération distante se produit pour un objet géré. Par exemple, lorsqu’un processus distant met à jour un élément géré localement, un message est envoyé à toutes les instances DataService qui continuent à gérer cet élément. Ce message est distribué sous forme d’événement MessageEvent.MESSAGE.
Un événement de conflit est distribué lorsqu’un conflit est détecté, soit au niveau de la destination distante suite à une modification validée par l’instance DataService, soit en raison d’une modification transférée qui entre en conflit avec une modification locale non validée. Vous pouvez gérer les événements de conflit en écoutant DataConflictEvent.CONFLICT. Utilisez la liaison de données pour mettre à jour des contrôles de l’interface utilisateur en les liant à la propriété DataService.conflicts.resolved.
La classe DataService prend en charge les modes suivants de configuration de la synchronisation des données :
-
autoCommit: lorsque la valeur est true, chaque modification est envoyée immédiatement à la destination distante une fois qu’elle est détectée. Lorsque la valeur estfalse, vous devez appeler explicitement la méthodecommit(). Utilisez la propriétéDataService.commitRequiredqui peut être liée pour déterminer s’il existe des modifications non validées. -
autoSyncEnabled: cette propriété s’applique à tous les appelsfill,getItemoucreateItemréalisés et détermine si des instances gérées écoutent ou non les modifications apportées à ces objets par d’autres clients, ainsi que les modifications réalisées à l’aide de l’API push du serveur de transaction DataService sur la destination distante. -
autoMerge: détermine si les modifications issues d’une destination distante sont appliquées immédiatement ou mises en file d’attente jusqu’à ce que la méthodeDataService.merge()soit appelée.
Utilisez la méthode DataService.revertChanges() pour rétablir les modifications apportées à un élément ou à tous les éléments. Lorsqu’une erreur se produit dans le cadre d’une opération réalisée sur une destination distante, les modifications validées sont replacées dans la file d’attente des modifications non validées, de sorte que les données restent synchronisées avec les données sur la destination distante. Si les modifications provoquent une erreur, appelez la méthode DataService.revertChanges() dans le cadre du gestionnaire d’erreur, afin de rétablir les modifications.
La classe mx.data.mxml.DataService est une sous-classe MXML de la classe mx.data.DataService permettant de définir des liaisons avec les propriétés d’une instance DataService.
Syntaxe MXML
Afficher la syntaxe MXML
Masquer la syntaxe MXMLThe <mx:DataService> element accepts the following attributes:
<mx:DataService Properties autoCommit="true" autoMerge="true" autoSaveCache="false" autoSyncEnabled="true" conflictDetector="No default." dataStore="No default." destination="No default." pageSize="No default." id="No default." Events conflict="No default." fault="No default." message="No default." propertyChange="No default." result="No default." />
Eléments de l’API associés
mx.data.Conflicts
mx.data.Conflict
mx.data.ItemReference
mx.data.IManaged
mx.data.utils.Managed
mx.data.IChangeObject
| Propriété | Défini par | ||
|---|---|---|---|
 | adapter : DataServiceAdapter = null
Instance d’une classe contrôlant les interactions avec le serveur. | DataManager | |
| autoCommit : Boolean
Indique si les modifications apportées au cache local sont automatiquement validées. | DataManager | |
| autoConnect : Boolean
Indique si ce service doit essayer d’établir une connexion pour les opérations qui nécessitent une connexion. | DataManager | |
| autoMerge : Boolean
Si la valeur est définie sur false, lorsque des modifications sont transférées de la destination distante vers le client, elles ne sont pas appliquées immédiatement. | DataManager | |
| autoSaveCache : Boolean
Vous pouvez stocker le cache local contenant les données et les modifications sur le disque. | DataManager | |
| autoSyncEnabled : Boolean
Lorsque la valeur est true, les demandes fill(), createItem() et getItem() renvoient les éléments qui écoutent les mises à jour réalisées sur ces éléments à partir de la destination distante. | DataManager | |
| cacheID : String
Permet d’accéder à l’identificateur de cache de ce service. | DataManager | |
| channelSet : ChannelSet
Fournit un accès à la classe ChannelSet utilisée par le service. | DataService | ||
| commitRequired : Boolean [lecture seule]
Détermine s’il existe des modifications non validées et si la méthode commit() doit être appelée. | DataManager | |
| conflictDetector : ConflictDetector
Permet d’accéder à l’implémentation actuellement utilisée pour détecter les conflits liés aux opérations distantes transférées vers cette instance DataManager. | DataManager | |
| conflicts : Conflicts [lecture seule]
Contient un objet Conflicts, c’est-à-dire une instance ArrayList d’instances Conflict. | DataManager | |
| connected : Boolean [lecture seule]
Indique si l’instance DataService est connectée à la destination distante. | DataManager | |
| constructor : Object
Référence à l’objet de classe ou à la fonction constructeur d’une occurrence donnée d’un objet. | Object | |
| dataStore : DataStore
Contient un objet de type mx.data.DataStore. | DataManager | |
| deleteItemOnRemoveFromFill : Boolean
Par défaut, lorsque vous appelez la méthode removeItemAt() sur une collection remplie gérée, elle lance un appel de suppression d’élément vers le serveur pour supprimer physiquement l’élément. | DataManager | |
| destination : String [lecture seule]
Indique à quelle destination distante ce service est associé. | DataService | ||
| encryptLocalCache : Boolean
Indique si le stockage hors connexion doit être chiffré pour les clients AIR qui utilisent un adaptateur SQL déconnecté. | DataManager | |
| fallBackToLocalFill : Boolean
Cet indicateur détermine si l’application doit réaliser une requête sur le magasin local lorsqu’il n’est pas connecté. | DataManager | |
| hierarchicalEventsDefault : Boolean
Les associations peuvent éventuellement répertorier les événements de modification de propriété relatifs aux propriétés des instances associées. | DataManager | |
| ignoreCollectionUpdates : Boolean
Indique si les modifications apportées aux collections gérées doivent être ignorées au lieu d’être communiquées au serveur lors d’une validation. | DataManager | |
| indexReferences : Boolean
Pour optimiser la vitesse de votre application, définissez cette propriété sur false si le nombre de remplissages ou de références concernant les éléments gérés par cette instance DataManager et issus des propriétés d’association d’autres éléments est relativement limité. | DataManager | |
| isInitialized : Boolean [lecture seule]
Indique si les métadonnées associées à cette instance DataManager sont initialisées. | DataManager | |
| manualSync : ManualSyncConfiguration
Permet d’accéder à l’instance ManualSyncConfiguration de chaque instance DataManager. | DataManager | |
| maxFrequency : uint
Détermine le nombre maximal de messages par seconde que l’instance DataManager souhaite recevoir. | DataManager | |
| mergeRequired : Boolean [lecture seule]
Indique s’il existe des modifications en attente à fusionner. | DataManager | |
| offlineAdapter : DataServiceOfflineAdapter
Renvoie un objet de type mx.data.DataServiceOfflineAdapter. | DataManager | |
| pageSize : int
Permet d’accéder à la taille de page actuelle de toutes les collections. | DataManager | |
| pagingEnabled : Boolean [lecture seule]
Indique si la destination distante est configurée pour autoriser les demandes de page. | DataManager | |
| priority : int
Priorité par défaut des messages envoyés par l’instance DataManager. | DataManager | |
| requestTimeout : int
Permet d’accéder au délai d’expiration des demandes d’une opération, en secondes. | DataManager | |
| resetCollectionOnFill : Boolean
Lorsque cette propriété est définie sur true, un événement RESET est envoyé une fois l’opération terminée. | DataManager | |
| resubscribeAttempts : int
Contrôle le nombre de tentatives de réabonnement à sa destination qu’une instance DataManager déconnectée peut effectuer. | DataManager | |
| resubscribeInterval : int
Contrôle le délai, en millisecondes, entre les tentatives de réabonnement. | DataManager | |
| saveCacheRequired : Boolean [lecture seule]
Indique s’il existe des modifications qui n’ont pas été enregistrées dans le cache local et que la méthode saveCache() doit être appelée. | DataManager | |
| subscribed : Boolean [lecture seule]
Indique si l’instance DataManager est abonnée à la destination distante. | DataManager | |
| throwItemPendingErrors : Boolean
Définissez cette propriété sur false si vous souhaitez supprimer l’envoi d’erreurs d’éléments en attente lors de l’accès à des données récupérées à la demande ou non paginées. | DataManager | |
| Méthode | Défini par | ||
|---|---|---|---|
DataService(destination:String)
Crée une instance DataService avec la destination spécifiée. | DataService | ||
|
Efface les données stockées sur le disque lors d’un appel de la méthode saveCache() réalisé précédemment ou alors que la méthode autoSaveCache était définie sur true.
| DataManager | |
|
Efface du magasin local les données spécifiées par le descripteur transmis. | DataManager | |
|
Valide les modifications en attente pour toutes les collections actuellement gérées par l’instance DataStore associée à cette instance DataManager. | DataManager | |
|
Indique s’il existe des modifications en attente pour cet objet particulier. | DataManager | |
|
Force ce service à réaliser une tentative de connexion à la destination distante. | DataManager | |
|
Appelle une méthode count sur la destination distante. | DataManager | |
|
Demande la création de l’élément spécifié dans le magasin distant. | DataManager | |
|
Demande la suppression de l’élément spécifié du magasin distant. | DataManager | |
|
Déconnecte la connexion réseau de l’instance DataManager. | DataManager | |
|
Exécute une requête en utilisant le nom et les arguments spécifiés. | DataManager | |
|
Remplit l’instance ListCollectionView (collection) spécifiée en fonction de la méthode de remplissage associée de la destination. | DataManager | |
|
Remplit l’instance ListCollectionView (collection) spécifiée en fonction de la méthode de remplissage associée de la destination. | DataManager | |
|
Exécute une requête qui renvoie un seul élément. | DataManager | |
|
Renvoie un objet ArrayCollection ou un objet géré unique, issu du magasin local. | DataManager | |
| getCacheDescriptors(view:ListCollectionView, options:uint = 0, item:Object = null):mx.rpc:AsyncToken
Remplit l’instance ListCollectionView (collection) spécifiée avec des instances CacheDataDescriptor. | DataManager | |
|
Remplit l’instance ListCollectionView (collection) spécifiée avec tous les identificateurs de cache précédemment utilisés dans l’application. | DataManager | |
|
Réalise une demande asynchrone concernant un élément correspondant à l’identité spécifiée. | DataManager | |
|
Recherche l’élément spécifié en utilisant l’identité indiquée. | DataManager | |
|
Renvoie les informations sur la page de la collection spécifiée. | DataManager | |
|
Renvoie l’opération en cours dans le cache de messages de l’élément spécifié. | DataManager | |
|
Indique si la propriété spécifiée d’un objet est définie. | Object | |
|
Force l’initialisation de l’instance DataStore. | DataManager | |
|
Renvoie true si la collection transmise est gérée par ce service. | DataManager | |
|
Renvoie true si la collection transmise utilise des fonctionnalités de pagination. | DataManager | |
|
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 | |
|
Renvoie true si la plage d’éléments spécifiée est intégralement paginée. | DataManager | |
|
Remplit l’instance ListCollectionView spécifiée en fonction des éléments <fill-method> associés, conformément aux données du magasin local. | DataManager | |
Déconnecte l’utilisateur de la destination de l’instance DataService. | DataService | ||
|
Fusionne les mises à jour en attente dans l’ensemble d’objets géré. | DataManager | |
|
Indique si la propriété spécifiée existe et est énumérable. | Object | |
|
Actualise toutes les données gérées par cette instance DataManager. | DataManager | |
|
Actualise une collection précédemment remplie en utilisant la méthode fill ou gérée en tant qu’association gérée. | DataManager | |
|
Libère tous les éléments et collections gérés de l’instance DataManager. | DataManager | |
| releaseCollection(view:ListCollectionView, clear:Boolean = false, copyStillManagedItems:Boolean = true):void
Libère un élément de la gestion dans la collection spécifiée, de sorte qu’il ne soit plus géré par cette instance DataManager. | DataManager | |
| releaseItem(item:IManaged, copyStillManagedItems:Boolean = true, enableStillManagedCheck:Boolean = true):IManaged
Libère l’élément spécifié afin qu’il ne soit plus géré par cette instance DataManager. | DataManager | |
|
Libère une plage d’éléments de la collection. | DataManager | |
|
Libère la valeur d’une association monovaluée. | DataManager | |
|
Rétablit les modifications non validées apportées à l’élément spécifié. | DataManager | |
|
Rétablit les modifications appliquées aux éléments contenus dans la collection spécifiée et devant être gérés par cette instance DataManager. | DataManager | |
|
Cette méthode enregistre l’état actif du cache de l’instance DataManager. | DataManager | |
|
Indique s’il existe des modifications en attente pour cet objet particulier qui n’ont pas été enregistrées dans le cache local. | DataManager | |
Définit les informations d’identification de cette destination DataService. | DataService | ||
|
Définit la disponibilité d’une propriété dynamique pour les opérations en boucle. | Object | |
Définit les informations d’identification du tiers de cette destination DataService. | DataService | ||
|
Obtient les éléments modifiés pour tous les remplissages exécutés précédemment sur ce service de données (gestionnaire de données). | DataManager | |
| [statique]
Une méthode pratique afin d’autoriser la synchronisation de l’ensemble des données locales : synchronizeAllFills() est invoqué sur chaque service de données spécifié(gestionnaire de données), de sorte que le jeton du résultat final ne soit rempli que lorsque tous les appels synchronizeAllFills() sont terminées. | DataManager | |
|
Obtient les éléments modifiés qui ont changé sur le serveur depuis la dernière fois qu’une action fill ou synchronizeFill a été invoquée. | DataManager | |
|
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 | |
|
Déclenche une mise à jour de l’élément spécifié. | DataManager | |
|
Renvoie la valeur primitive de l’objet spécifié. | Object | |
| Evénement | Synthèse | Défini par | ||
|---|---|---|---|---|
| L’événement DataConflictEvent.CONFLICT est distribué lorsqu’un conflit entre des modifications locales en attente et des modifications demandées par un autre client est détecté, ou lorsque des modifications demandées par ce client entrent en conflit avec celles de la destination distante. | DataService | |||
| L’événement DataServiceFaultEvent.FAULT est distribué lorsqu’un appel de service échoue en raison d’une erreur. | DataService | |||
| L’événement MessageEvent.MESSAGE est distribué lorsque la destination distante transfère une notification d’opération de données. | DataService | |||
| L’événement PropertyChangeEvent.PROPERTY_CHANGE est distribué lorsqu’une propriété de ce service change. | DataService | |||
| L’événement ResultEvent.RESULT est distribué lorsqu’un appel de service aboutit à un retour. | DataService | |||
channelSet | propriété |
channelSet:ChannelSet| 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 |
Permet d’accéder à l’instance ChannelSet utilisée par le service. La classe ChannelSet peut être manuellement construite et assignée, ou elle sera dynamiquement créée afin d’utiliser les canaux configurés pour la destination de ce service.
Implémentation
public function get channelSet():ChannelSet public function set channelSet(value:ChannelSet):voiddestination | propriété |
destination:String [lecture seule] | 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 à quelle destination distante ce service est associé.
Implémentation
public function get destination():StringDataService | () | Constructeur |
public function DataService(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 |
Crée une instance DataService avec la destination spécifiée. Le nom de la destination doit être une référence à une destination configurée dans un fichier de configuration LiveCycle Data Service ou avec la configuration de l’exécution.
Paramètresdestination:String — Contient le nom de la destination souhaitée.
|
logout | () | méthode |
public function logout():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 |
Déconnecte l’utilisateur de la destination de l’instance DataService. La déconnexion d’une destination s’applique à tous les éléments connectés à l’aide de la même classe ChannelSet tel que spécifié dans la configuration de serveur. Par exemple, si vous êtes connecté par le biais du canal my-rtmp et que vous vous déconnectez en utilisant l’une des instances DataService, toutes les connexions établies par le biais de la même instance ChannelSet sont fermées.
Remarque : Adobe vous recommande d’utiliser la méthode mx.messaging.ChannelSet.logout() au lieu de cette méthode.
Eléments de l’API associés
setCredentials | () | méthode |
public function setCredentials(username:String, password:String):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 |
Définit les informations d’identification de cette destination DataService. Les informations d’identification sont appliquées à tous les services connectés via la même classe ChannelSet.
Paramètres
username:String — Nom d’utilisateur pour la destination.
| |
password:String — Mot de passe de la destination.
|
setRemoteCredentials | () | méthode |
public function setRemoteCredentials(username:String, password:String):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 |
Définit les informations d’identification du tiers de cette destination DataService.
Paramètres
username:String — Nom d’utilisateur pour la destination.
| |
password:String — Mot de passe pour la destination.
|
conflict | Evénement |
mx.data.events.DataConflictEventpropriété DataConflictEvent.type =
mx.data.events.DataConflictEvent.CONFLICT| 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 |
L’événement DataConflictEvent.CONFLICT est distribué lorsqu’un conflit entre des modifications locales en attente et des modifications demandées par un autre client est détecté, ou lorsque des modifications demandées par ce client entrent en conflit avec celles de la destination distante. Chaque instance DataService envoie des événements de conflit uniquement pour les éléments associés à cette destination spécifique.
Utilisez l’événement de conflit sur l’instance DataService si vous souhaitez traiter les conflits de tout un ensemble de destinations liées simultanément.
La constanteCONFLICT définit la valeur de la propriété type de l’objet d’événement d’un événement conflict.
Les valeurs des propriétés de l’objet d’événement sont les suivantes :
| Propriété | Valeur |
|---|---|
bubbles | false |
cancelable | false |
currentTarget | Objet définissant l’écouteur d’événement qui traite l’événement. Par exemple, si vous utilisez myButton.addEventListener() pour enregistrer un écouteur d’événement, myButton est la valeur de currentTarget. |
conflict | Objet Conflict contenant le conflit qui s’est produit. |
message | Message associé à cet événement. |
target | Objet qui a distribué l’événement (il ne s’agit pas toujours de l’objet qui écoute l’événement). Pour accéder systématiquement à l’objet qui écoute l’événement, utilisez la propriété currentTarget. |
fault | Evénement |
mx.data.events.DataServiceFaultEventpropriété DataServiceFaultEvent.type =
mx.data.events.DataServiceFaultEvent.FAULT| 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 |
L’événement DataServiceFaultEvent.FAULT est distribué lorsqu’un appel de service échoue en raison d’une erreur. Il est par exemple distribué lorsqu’un appel de la méthode fill() échoue. Cet événement est également envoyé pour chaque élément générant une erreur dans la cadre d’un résultat de validation. Dans ce cas, l’événement DataServiceFaultEvent contient le jeton renvoyé par la validation, mais l’élément et les chaînes de message d’erreur de la défaillance sont propres à l’élément qui a provoqué l’erreur.
FAULT définit la valeur de la propriété type de l’objet d’événement d’un événement fault.
Les valeurs des propriétés de l’objet d’événement sont les suivantes :
| Propriété | Valeur |
|---|---|
bubbles | false |
cancelable | true, appeler preventDefault() à partir de la méthode responder.fault du jeton associé empêchera le service ou l’opération de distribuer cet événement. |
currentTarget | Objet définissant l’écouteur d’événement qui traite l’événement. Par exemple, si vous utilisez myButton.addEventListener() pour enregistrer un écouteur d’événement, myButton est la valeur de currentTarget. |
fault | Objet Fault contenant le conflit qui s’est produit. |
item | Elément à l’origine de l’erreur. |
identity | Identité de l’élément à l’origine de l’erreur. |
message | Message associé à cet événement. |
token | Jeton représentant l’appel à la méthode. Utilisé dans le modèle de jeton d’achèvement asynchrone. |
target | Objet qui a distribué l’événement (il ne s’agit pas toujours de l’objet qui écoute l’événement). Pour accéder systématiquement à l’objet qui écoute l’événement, utilisez la propriété currentTarget. |
message | Evénement |
mx.messaging.events.MessageEventpropriété MessageEvent.type =
mx.messaging.events.MessageEvent.MESSAGE| 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 |
L’événement MessageEvent.MESSAGE est distribué lorsque la destination distante transfère une notification d’opération de données. Par exemple, lorsque des données sont mises à jour dans la destination distante, une opération de mise à jour est envoyée à tous les clients qui écoutent et cette opération est convertie en événement de message sur cette instance DataService.
La valeur de cette constante est "message".
Les valeurs des propriétés de l’objet d’événement sont les suivantes :
| Propriété | Valeur |
|---|---|
bubbles | false |
cancelable | false |
currentTarget | Objet définissant l’écouteur d’événement qui traite l’événement. Par exemple, si vous utilisez myButton.addEventListener() pour enregistrer un écouteur d’événement, myButton est la valeur de currentTarget. |
message | Message associé à cet événement. |
target | Objet qui a distribué l’événement (il ne s’agit pas toujours de l’objet qui écoute l’événement). Pour accéder systématiquement à l’objet qui écoute l’événement, utilisez la propriété currentTarget. |
propertyChange | Evénement |
mx.events.PropertyChangeEventpropriété PropertyChangeEvent.type =
mx.events.PropertyChangeEvent.PROPERTY_CHANGE| 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 |
L’événement PropertyChangeEvent.PROPERTY_CHANGE est distribué lorsqu’une propriété de ce service change. Cela est le cas lorsque les propriétés suivantes sont modifiées :
commitRequiredmergeRequiredconnected
PropertyChangeEvent.PROPERTY_CHANGE définit la valeur de la propriété type de l’objet d’événement d’un événement PropertyChange.
Les valeurs des propriétés de l’objet d’événement sont les suivantes :
| Propriété | Valeur |
|---|---|
bubbles | Valeur déterminée par le constructeur, false par défaut. |
cancelable | Valeur déterminée par le constructeur, false par défaut. |
kind | Type de modification : PropertyChangeEventKind.UPDATE ou PropertyChangeEventKind.DELETE. |
oldValue | Valeur d’origine de la propriété. |
newValue | Nouvelle valeur de la propriété, le cas échéant. |
property | Propriété modifiée. |
source | Objet contenant la propriété modifiée. |
currentTarget | Objet définissant l’écouteur d’événement qui traite l’événement. Par exemple, si vous utilisez myButton.addEventListener() pour enregistrer un écouteur d’événement, myButton est la valeur de currentTarget. |
target | Objet qui a distribué l’événement (il ne s’agit pas toujours de l’objet qui écoute l’événement). Pour accéder systématiquement à l’objet qui écoute l’événement, utilisez la propriété currentTarget. |
result | Evénement |
mx.rpc.events.ResultEventpropriété ResultEvent.type =
mx.rpc.events.ResultEvent.RESULT| 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 |
L’événement ResultEvent.RESULT est distribué lorsqu’un appel de service aboutit à un retour. Il est par exemple distribué lorsqu’un appel de la méthode fill() aboutit.
Les valeurs des propriétés de l’objet d’événement sont les suivantes :
| Propriété | Valeur |
|---|---|
bubbles | false |
cancelable | true, preventDefault() de la méthode responder.fault du jeton associé empêchera le service ou l’opération de distribuer cet événement. |
currentTarget | Objet définissant l’écouteur d’événement qui traite l’événement. Par exemple, si vous utilisez myButton.addEventListener() pour enregistrer un écouteur d’événement, myButton est la valeur de currentTarget. |
message | Message associé à cet événement. |
target | Objet qui a distribué l’événement (il ne s’agit pas toujours de l’objet qui écoute l’événement). Pour accéder systématiquement à l’objet qui écoute l’événement, utilisez la propriété currentTarget. |
result | Résultat que l’appel RPC renvoie. |
token | Jeton représentant l’appel individuel à la méthode. Utilisé dans le modèle de jeton d’achèvement asynchrone. |
Tue Jun 12 2018, 09:30 AM Z