Package | mx.data |
Classe | public class DataManager |
Héritage | DataManager Object |
Implémente | IEventDispatcher |
Sous-classes | DataService, RPCDataManager |
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 classe DataManager est une classe abstraite. En règle générale, vous créez une instance DataService qui étend la classe DataManager, ou générez une ou plusieurs instances RPCDataManager en plus d’un composant de service RPC, tel qu’une instance HTTPMultiService, WebService ou RemoteObject.
Pour obtenir des objets gérés uniques, on utilise les méthodes DataManager.getItem()
et DataManager.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 DataManager.releaseCollection()
.
Lorsqu’un élément extrait précédemment à l’aide de la méthode DataManager.getItem()
ou DataManager.createItem()
n’est plus nécessaire ou ne doit plus recevoir ou créer de mises à jour, appelez la méthode DataManager.releaseItem()
. Les méthodes DataManager.createItem()
et DataManager.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 DataManager.releaseItem()
, l’appel de la méthode ItemReference.releaseItem()
libère une instance spécifique d’un objet géré unique. La méthode DataManager.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 DataManager.getItem()
et DataManager.createItem()
corresponde au nombre d’appels de la méthode DataManager.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 DataManager.fill()
ou DataManager.commit()
alors que certaines mises à jour ne sont pas validées, l’instance DataManager tente d’établir une connexion vers la destination distante. Pour contraindre une instance DataManager à se déconnecter, appelez la méthode DataManager.disconnect()
. Vous pouvez faire appel à la méthode DataManager.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 DataManager.disconnect()
peut mettre fin à la connexion.
La propriété connected
, qui peut être liée, indique l’état actuel de la connexion DataManager associée.
Chaque instance DataManager
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 DataManager. Par défaut, une instance DataManager partage la même instance DataStore avec d’autres instances DataManager 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 DataManager valide les modifications de toutes les instances DataManager 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 DataManager associées.
Les instances DataManager 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 DataManager qui font référence à la même destination, ces deux instances partageront la même collection d’objets gérés et distribueront le même ensemble d’événements. Par exemple, si vous ajoutez un écouteur d’événement à une instance DataManager pour une destination et que vous utilisez une instance différente pour initier une opération, la première instance DataManager recevra quand même ces événements. Chaque opération initiée sur une instance DataManager renvoie un objet AsyncToken. Vous pouvez ajouter un répondeur d’événement à ce jeton 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 DataManager. L’instance DataManager 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 DataManager 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 DataManager, 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é DataManager.conflicts.resolved
.
La classe DataManager 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éDataManager.commitRequired
qui peut être liée pour déterminer s’il existe des modifications non validées. -
autoSyncEnabled
: cette propriété s’applique à tous les appelsfill
,getItem
oucreateItem
ré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éthodeDataManager.merge()
soit appelée.
Utilisez la méthode DataManager.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 DataManager.revertChanges()
dans le cadre du gestionnaire d’erreur, afin de rétablir les modifications.
Eléments de l’API associés
mx.data.RPCDataManager
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 | ||
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 | ||
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 | ||
---|---|---|---|
Crée une instance de l’objet DataService en utilisant la destination spécifiée. | DataManager | ||
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 | ||
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 la disponibilité d’une propriété dynamique pour les opérations en boucle. | Object | ||
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 |
Méthode | Défini par | ||
---|---|---|---|
Met en file d’attente une erreur si ce gestionnaire de données n’a pas encore été initialisé. | DataManager |
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. | DataManager | |||
L’événement DataManagerFaultEvent.FAULT est distribué lorsqu’un appel de service échoue en raison d’une erreur. | DataManager | |||
L’événement MessageEvent.MESSAGE est distribué lorsque la destination distante transfère une notification d’opération de données. | DataManager | |||
L’événement PropertyChangeEvent.PROPERTY_CHANGE est distribué lorsqu’une propriété de ce service change. | DataManager | |||
L’événement ResultEvent.RESULT est distribué lorsqu’un appel de service aboutit à un retour. | DataManager |
adapter | propriété |
public var adapter:DataServiceAdapter = null
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 |
Instance d’une classe contrôlant les interactions avec le serveur.
autoCommit | propriété |
autoCommit: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 les modifications apportées au cache local sont automatiquement validées. Les modifications validées sont envoyées immédiatement au service distant.
La valeur par défaut est true pour les instances DataService, qui sont les gestionnaires de données utilisés avec le service de gestion des données côté serveur.
La valeur par défaut est false pour les instances RPCDataManager, qui sont les gestionnaires de données procurant les fonctionnalités de gestion des données côté client aux composants de service RPC, tels que RemoteObject, HTTPMultiService et WebService.
Implémentation
public function get autoCommit():Boolean
public function set autoCommit(value:Boolean):void
autoConnect | propriété |
autoConnect: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 ce service doit essayer d’établir une connexion pour les opérations qui nécessitent une connexion. Les opérations telles que fill()
, getItem()
et count()
essaient d’établir une connexion si le service est déconnecté et que la valeur de autoConnect
est true
. Utilisez cette propriété pour contrôler le comportement des applications qui se connectent de façon occasionnelle.
La valeur par défaut est true.
Implémentation
public function get autoConnect():Boolean
public function set autoConnect(value:Boolean):void
autoMerge | propriété |
autoMerge: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 |
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. En revanche, la propriété mergeRequired
est définie sur true.
Un gestionnaire d’événement peut être enregistré pour écouter les événements change liés à cette propriété, afin d’être informé lorsqu’une fusion est nécessaire.
Pour fusionner des modifications, appelez la méthode merge()
pour que toutes les modifications soient appliquées.
Les modifications non validées ne peuvent pas être validées lorsque des modifications doivent être fusionnées.
Si la pagination est activée, toutes les demandes concernant des éléments non locaux sont mises en cache, jusqu’à ce que la méthode merge()
soit appelée. Une fois la méthode merge()
appelée, les demandes mises en cache sont traitées.
La valeur par défaut est true.
Implémentation
public function get autoMerge():Boolean
public function set autoMerge(value:Boolean):void
autoSaveCache | propriété |
autoSaveCache: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 |
Vous pouvez stocker le cache local contenant les données et les modifications sur le disque. Lorsque la valeur de la propriété autoSaveCache
est true
, chaque fois qu’une modification est réalisée ou qu’une demande distante est renvoyée, ces données sont enregistrées sur le disque. Si un problème survient lors de l’enregistrement des données, soit parce que le disque est saturé, soit parce que les autorisations en écriture sont refusées, un événement FaultEvent
est distribué ou une erreur Fault
est renvoyée.
Si cette valeur est définie sur false
(valeur par défaut), les données et les modifications ne sont pas enregistrées sur le disque. Pour forcer l’enregistrement sur le disque des données et modifications actuelles, utilisez la méthode saveCache()
.
La valeur par défaut est false.
Implémentation
public function get autoSaveCache():Boolean
public function set autoSaveCache(value:Boolean):void
Eléments de l’API associés
autoSyncEnabled | propriété |
autoSyncEnabled: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 |
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. Lorsqu’une modification est apportée à cette valeur de propriété, elle est appliquée uniquement aux appels ultérieurs des méthodes, pas aux collections ou éléments existants.
Si des éléments apparaissent dans plusieurs collections et que certaines de ces collections ont été extraites avec autoSyncEnabled
et que d’autres ont été remplies sans autoSyncEnabled
, ces éléments continuent à recevoir des événements de mise à jour.
La valeur par défaut est true.
Implémentation
public function get autoSyncEnabled():Boolean
public function set autoSyncEnabled(value:Boolean):void
cacheID | propriété |
cacheID: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 |
Permet d’accéder à l’identificateur de cache de ce service. Un identificateur de cache doit être défini avant de réaliser des opérations qui font appel à des données stockées localement sur disque. Si aucun identificateur de cache n’est défini, toutes les méthodes et propriétés du cache sont considérées comme étant incohérentes et une erreur DataServiceError
est renvoyée lorsqu’une opération faisant appel à des données du disque local est réalisée. Cette propriété fournit un identificateur « session » unique pour les données stockées localement. Le développeur doit affecter à cette propriété une valeur unique dans l’ensemble de l’application.
La propriété est considérée comme non définie si sa valeur null
ou une chaîne vide. Les demandes de données réalisées à l’aide des méthodes fill()
et getItem()
essaient d’accéder tout d’abord aux données locales du disque si la propriété cacheID
a été définie. Si la propriété cacheID
n’est pas définie, aucune tentative d’accès aux données locales n’est réalisée.
Implémentation
public function get cacheID():String
public function set cacheID(value:String):void
commitRequired | propriété |
commitRequired:Boolean
[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 |
Détermine s’il existe des modifications non validées et si la méthode commit()
doit être appelée. Lorsque la valeur de cette propriété change, un événement est distribué. Cette propriété peut être utilisée dans une application pour fournir une réponse visuelle.
Cette propriété peut être utilisée comme source de la liaison de données. Lorsque cette propriété est modifiée, elle distribue l’événement propertyChange
.
Implémentation
public function get commitRequired():Boolean
conflictDetector | propriété |
conflictDetector:ConflictDetector
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’implémentation actuellement utilisée pour détecter les conflits liés aux opérations distantes transférées vers cette instance DataManager.
Implémentation
public function get conflictDetector():ConflictDetector
public function set conflictDetector(value:ConflictDetector):void
conflicts | propriété |
conflicts:Conflicts
[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 |
Contient un objet Conflicts, c’est-à-dire une instance ArrayList d’instances Conflict.
Les conflits doivent être résolus avant d’appeler la méthode commit()
. Les conflits peuvent être résolus en parcourant la liste des conflits et en résolvant un à un chacun d’entre eux, ou en appelant la méthode acceptAllClient()
ou acceptAllServer()
sur cette propriété.
Cette propriété peut être utilisée comme source de la liaison de données. Lorsque cette propriété est modifiée, elle distribue l’événement propertyChange
.
Implémentation
public function get conflicts():Conflicts
connected | propriété |
connected:Boolean
[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 si l’instance DataService est connectée à la destination distante.
Cette propriété peut être utilisée comme source de la liaison de données. Lorsque cette propriété est modifiée, elle distribue l’événement propertyChange
.
Implémentation
public function get connected():Boolean
dataStore | propriété |
dataStore:DataStore
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 |
Contient un objet de type mx.data.DataStore. L’instance DataStore gère l’ensemble des modifications entrantes et sortantes d’une ou plusieurs instances DataManager, qui peuvent contenir des références les unes aux autres. Lorsque vous procédez à une validation dans une instance DataStore, toutes les modifications en attente de toutes les instances DataManager utilisant cette instance DataStore sont validées.
Par défaut, une instance DataManager partage la même instance DataStore avec d’autres instances DataManager si elles possèdent des propriétés d’association gérées et partagent le même ensemble de canaux. Lorsque des instances DataStore sont partagées, un appel de la méthode commit sur une instance DataManager valide toutes les modifications de toutes les instances DataManager utilisant ce magasin de données. L’ordre des opérations est ainsi préservé, dans le cas où il existe des dépendances entre les modifications présentes dans les lots de modifications non validées.
Cette propriété peut être utilisée comme source de la liaison de données. Lorsque cette propriété est modifiée, elle distribue l’événement propertyChange
.
Implémentation
public function get dataStore():DataStore
public function set dataStore(value:DataStore):void
deleteItemOnRemoveFromFill | propriété |
deleteItemOnRemoveFromFill: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 |
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. Vous pouvez ainsi utiliser un code utilisant une collection gérée et une collection non gérée de la même manière. Cependant, dans certaines situations, il peut être utile de supprimer l’élément de la collection du client sans le supprimer du serveur. Pour ce faire, définissez cet indicateur sur false
avant d’appeler la méthode removeItemAt()
.
Notez que les collections qui sont des associations ne sont pas affectées. Seules sont concernées les collections qui ont été utilisées avec la méthode fill()
.
La valeur par défaut est true.
Implémentation
public function get deleteItemOnRemoveFromFill():Boolean
public function set deleteItemOnRemoveFromFill(value:Boolean):void
encryptLocalCache | propriété |
encryptLocalCache:Boolean
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 |
Indique si le stockage hors connexion doit être chiffré pour les clients AIR qui utilisent un adaptateur SQL déconnecté.
Pour les clients Flex basés sur navigateur, les données déconnectées ne peuvent pas être chiffrées.
Implémentation
public function get encryptLocalCache():Boolean
public function set encryptLocalCache(value:Boolean):void
fallBackToLocalFill | propriété |
fallBackToLocalFill:Boolean
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.1 |
Cet indicateur détermine si l’application doit réaliser une requête sur le magasin local lorsqu’il n’est pas connecté. Par défaut, lorsque l’adaptateur déconnecté est configuré pour prendre en charge l’exécution des requêtes dynamiques, l’appel de la méthode fill()
n’entraîne pas l’interrogation du magasin local lorsque l’application n’est pas connectée. Si l’instance fallBackToLocalFill est définie sur true, le magasin local est également interrogé lorsque l’application est déconnectée.
Cette propriété peut être utilisée comme source de la liaison de données. Lorsque cette propriété est modifiée, elle distribue l’événement propertyChange
.
Implémentation
public function get fallBackToLocalFill():Boolean
public function set fallBackToLocalFill(value:Boolean):void
hierarchicalEventsDefault | propriété |
hierarchicalEventsDefault: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 |
Les associations peuvent éventuellement répertorier les événements de modification de propriété relatifs aux propriétés des instances associées. Vous pouvez définir ce comportement pour une association à l’aide de l’attribut de configuration hierarchical-events
. Si vous ne définissez pas l’attribut hierarchical-events
, les associations d’une destination particulière utilisent cette propriété pour déterminer la valeur par défaut.
La valeur par défaut est false
. Dans le cas des objets stockés dans une arborescence (et non dans un graphe cyclique), il peut parfois être utile de définir cette propriété sur true
pour certaines destinations. Si vous utilisez les propriétés de vos propriétés dans un rendu d’élément, par exemple, le fait de définir cette valeur sur true
pour cette propriété d’association provoque l’actualisation de la grille lorsque les propriétés de ces propriétés changent. Le système est conçu de telle sorte qu’il évite d’envoyer des événements récursifs ou de créer de grandes chaînes d’événements (par exemple parent.child[0].child[1].child[3]).
La valeur par défaut est false.
Implémentation
public function get hierarchicalEventsDefault():Boolean
public function set hierarchicalEventsDefault(value:Boolean):void
ignoreCollectionUpdates | propriété |
ignoreCollectionUpdates:Boolean
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 |
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.
La valeur par défaut est false.
Implémentation
public function get ignoreCollectionUpdates():Boolean
public function set ignoreCollectionUpdates(value:Boolean):void
indexReferences | propriété |
indexReferences: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 |
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é.
Implémentation
public function get indexReferences():Boolean
public function set indexReferences(value:Boolean):void
isInitialized | propriété |
isInitialized:Boolean
[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 si les métadonnées associées à cette instance DataManager sont initialisées.
Cette propriété peut être utilisée comme source de la liaison de données. Lorsque cette propriété est modifiée, elle distribue l’événement propertyChange
.
Implémentation
public function get isInitialized():Boolean
manualSync | propriété |
manualSync:ManualSyncConfiguration
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 ManualSyncConfiguration de chaque instance DataManager. La classe ManualSyncConfiguration permet de s’abonner aux modifications réalisées par d’autres clients ou sur le serveur et de contrôler la manière dont vos modifications sont publiées auprès des autres clients abonnés à cette interface.
Implémentation
public function get manualSync():ManualSyncConfiguration
public function set manualSync(value:ManualSyncConfiguration):void
maxFrequency | propriété |
maxFrequency:uint
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étermine le nombre maximal de messages par seconde que l’instance DataManager souhaite recevoir. Un serveur comprenant cette valeur l’utilise comme entrée pour déterminer la vitesse d’envoi des messages à l’instance DataManager.
La valeur par défaut 0 signifie que l’instance DataManager n’a pas de préférence concernant la vitesse d’envoi des messages. Cette propriété doit être définie avant que l’instance DataManager ne s’abonne. En outre, les modifications apportées après l’abonnement ne seront pas appliquées tant que l’abonnement de l’instance DataManager n’aura pas été résilié, puis réactivé.
La valeur par défaut est 0.
Implémentation
public function get maxFrequency():uint
public function set maxFrequency(value:uint):void
mergeRequired | propriété |
mergeRequired:Boolean
[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 s’il existe des modifications en attente à fusionner.
Cette propriété peut être utilisée comme source de la liaison de données. Lorsque cette propriété est modifiée, elle distribue l’événement propertyChange
.
Implémentation
public function get mergeRequired():Boolean
offlineAdapter | propriété |
offlineAdapter:DataServiceOfflineAdapter
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.1 |
Renvoie un objet de type mx.data.DataServiceOfflineAdapter. L’adaptateur déconnecté contrôle l’implémentation de la façon dont les objets sont conservés dans le magasin local(SQLLite/LSO).
Implémentation
public function get offlineAdapter():DataServiceOfflineAdapter
public function set offlineAdapter(value:DataServiceOfflineAdapter):void
pageSize | propriété |
pageSize: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 |
Permet d’accéder à la taille de page actuelle de toutes les collections.
Implémentation
public function get pageSize():int
public function set pageSize(value:int):void
pagingEnabled | propriété |
pagingEnabled:Boolean
[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 si la destination distante est configurée pour autoriser les demandes de page.
Implémentation
public function get pagingEnabled():Boolean
priority | propriété |
priority: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 |
Priorité par défaut des messages envoyés par l’instance DataManager. Les valeurs possibles sont les valeurs comprises entre 0 et 9 (0 correspondant à la priorité la plus faible), ainsi que -1, qui signifie que l’instance DataManager n’a pas de niveau de priorité attribué. Si un niveau de priorité est déjà défini pour le message, cette propriété est prioritaire par rapport à la valeur déjà définie.
Implémentation
public function get priority():int
public function set priority(value:int):void
requestTimeout | propriété |
requestTimeout: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 |
Permet d’accéder au délai d’expiration des demandes d’une opération, en secondes. Une valeur inférieure ou égale à zéro empêche l’expiration des demandes. Lorsqu’une opération actuelle expire parce que la limite requestTimeout
a été atteinte, une erreur est distribuée pour cette opération, pour indiquer que la demande a expiré. Lorsqu’une opération expire, cela ne signifie pas dans tous les cas que le serveur n’a pas reçu cette opération. Cela peut provoquer ainsi une désynchronisation entre l’état du client et le serveur.
Implémentation
public function get requestTimeout():int
public function set requestTimeout(value:int):void
resetCollectionOnFill | propriété |
resetCollectionOnFill: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 |
Lorsque cette propriété est définie sur true
, un événement RESET est envoyé une fois l’opération terminée. Lorsque cette propriété a la valeur false
, seuls les événements incrémentiels ADD/REMOVE sont envoyés pour chaque élément renvoyé par le résultat du remplissage. Cette propriété s’applique à toutes les méthodes fill que vous initiez. Si vous la modifiez alors qu’une opération fill est en cours, celle-ci n’est pas affectée par la modification.
La valeur par défaut est true.
Implémentation
public function get resetCollectionOnFill():Boolean
public function set resetCollectionOnFill(value:Boolean):void
resubscribeAttempts | propriété |
resubscribeAttempts: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 |
Contrôle le nombre de tentatives de réabonnement à sa destination qu’une instance DataManager déconnectée peut effectuer. La valeur par défaut -1 signifie que le réabonnement doit être retenté jusqu’à ce que le client parvienne à se reconnecter.
La valeur par défaut est -1.
Implémentation
public function get resubscribeAttempts():int
public function set resubscribeAttempts(value:int):void
resubscribeInterval | propriété |
resubscribeInterval: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 |
Contrôle le délai, en millisecondes, entre les tentatives de réabonnement. La valeur par défaut est 5000, ce qui induit une tentative de réabonnement toutes les 5 secondes.
La valeur par défaut est 5000.
Implémentation
public function get resubscribeInterval():int
public function set resubscribeInterval(value:int):void
saveCacheRequired | propriété |
saveCacheRequired:Boolean
[lecture seule] Version du langage: | ActionScript 3.0 |
Version du produit: | Adobe Digital Enterprise Platform Data Services for Java EE 4.5 |
Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
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. Cette méthode peut renvoyer la valeur false lorsque commitRequired doit renvoyer true, indiquant que des changements sont enregistrés dans le cache local, mais qu’ils ne sont pas validés sur le serveur.
Cette propriété peut être utilisée comme source de la liaison de données. Lorsque cette propriété est modifiée, elle distribue l’événement propertyChange
.
Implémentation
public function get saveCacheRequired():Boolean
subscribed | propriété |
subscribed:Boolean
[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 si l’instance DataManager est abonnée à la destination distante.
Cette propriété peut être utilisée comme source de la liaison de données. Lorsque cette propriété est modifiée, elle distribue l’événement propertyChange
.
Implémentation
public function get subscribed():Boolean
throwItemPendingErrors | propriété |
throwItemPendingErrors: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 |
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. Au lieu de renvoyer une erreur, la valeur null est renvoyée pour une valeur de propriété ou un appel getItemAt()
dans une instance ArrayCollection.
La méthode size()
ne renvoie aucun élément pour les listes dont la taille n’a pas encore été récupérée auprès du serveur. Lorsque l’élément est renvoyé par le serveur, les événements PropertyChangeEvent et CollectionEvent concernés sont distribués.
Implémentation
public function get throwItemPendingErrors():Boolean
public function set throwItemPendingErrors(value:Boolean):void
DataManager | () | Constructeur |
public function 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 |
Crée une instance de l’objet DataService en utilisant la destination spécifiée. La destination doit être une référence à une destination configurée dans le fichier services-config.xml.
checkImplementation | () | méthode |
protected function checkImplementation():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 |
Met en file d’attente une erreur si ce gestionnaire de données n’a pas encore été initialisé.
clearCache | () | méthode |
public function clearCache(value:Object = 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 |
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
.
Paramètres
value:Object (default = null ) — Référence d’objet à un objet géré unique ou à un objet ArrayCollection.
|
mx.rpc:AsyncToken — Objet AsyncToken pouvant être utilisé en réponse à la réussite ou à l’échec de l’opération.
|
clearCacheData | () | méthode |
public function clearCacheData(descriptor:CacheDataDescriptor):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 |
Efface du magasin local les données spécifiées par le descripteur transmis.
Paramètres
descriptor:CacheDataDescriptor — Référence au descripteur des données à supprimer du cache local.
|
mx.rpc:AsyncToken — Référence au jeton pouvant être utilisé pour déterminer à quel moment le résultat ou l’erreur de cette opération est survenu.
|
commit | () | méthode |
public function commit(itemsOrCollections:Array = null, cascadeCommit:Boolean = false):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 |
Valide les modifications en attente pour toutes les collections actuellement gérées par l’instance DataStore associée à cette instance DataManager. L’appel de cette méthode équivaut à appeler la méthode dataStore.commit()
.
Lorsque la valeur de la propriété autoCommit
est true
, les transactions ne sont pas utilisées et il n’est pas nécessaire d’appeler cette méthode. Pour utiliser des transactions, définissez la propriété autoCommit
sur false
et appelez cette méthode directement pour valider un lot de modifications.
En général, vous appelez simplement commit()
sans utiliser d’argument pour valider toutes les modifications en attente. Vous pouvez spécifier des arguments facultatifs pour valider un sous-ensemble des modifications en attente. Vous devez résoudre tous les conflits en attente avant de valider les modifications apportées à un élément de l’instance DataStore.
Si l’assembleur est configuré de telle sorte que la propriété use-transactions est définie sur true
, toutes les modifications sont validées de façon atomique. Si une opération échoue, aucune des opérations du lot n’est appliquée. Si la propriété use-transactions est définie sur false
, les opérations sont validées une à une jusqu’à ce qu’un échec se produise, ce qui a pour effet d’arrêter le traitement. Les modifications intervenant avant l’erreur sont appliquées, mais celles qui interviennent après l’erreur ne le sont pas. Lorsqu’une erreur se produit dans le cadre du traitement d’un lot, les modifications sont replacées dans la file d’attente des modifications non validées. Si vous souhaitez supprimer les modifications qui ont provoqué l’erreur, vous devez appeler la méthode revertChanges.
Par défaut, la méthode de validation valide toutes les modifications en attente pour tous les éléments créés, modifiés et supprimés dans cette instance DataStore. Si vous souhaitez valider un sous-ensemble de ces modifications, vous pouvez spécifier une combinaison d’instances ArrayCollection et/ou d’éléments gérés qui définissent le sous-ensemble de modifications à inclure dans le lot. Pour chaque collection de tableaux spécifiée, toutes les modifications de l’appartenance ou de l’ordre des éléments de cette collection, ainsi que les modifications portant sur les éléments de cette collection eux-mêmes sont validées. Vous pouvez également spécifier une liste d’éléments gérés individuels, de sorte que seules les modifications concernant ces éléments soient validées. Si vous spécifiez dans le paramètre itemsOrCollections des objets qui ne sont pas des collections ou des éléments gérés, une erreur DataServiceError est envoyée.
Si vous utilisez le paramètre itemsOrCollections et que les propriétés d’association des éléments font référence à d’autres éléments, vous pouvez utiliser le paramètre cascadeCommit pour définir si les modifications apportées aux éléments associés doivent ou non être incluses dans le lot. Par exemple, si vous spécifiez un élément Group dans le paramètre items et que la propriété members d’une instance Group fait référence à une liste d’instances Person alors que la valeur de cascadeCommit est true, les modifications apportées à une instance Person seront également incluses dans l’ensemble de modifications validées. Si la valeur de cascadeCommit est false, seules les modifications apportées à l’instance Group sont incluses. Utilisez cascadeCommit=true pour faire en sorte que toutes les modifications dépendantes soient incluses dans le lot.
Paramètres
itemsOrCollections:Array (default = null ) — Il s’agit d’un paramètre facultatif qui prend la valeur par défaut null lorsque vous souhaitez valider toutes les modifications en attente. Si vous souhaitez valider un sous-ensemble des modifications en attente, utilisez cet argument pour spécifier une liste d’instances gérées ListCollectionView et/ou d’éléments gérés. Les objets ListCollectionView sont le plus souvent des objets ArrayCollection spécifiés dans la méthode fill. Toutes les versions gérées de l’élément font partie des éléments adaptés à cette méthode. Il s’agit des éléments que vous extrayez à l’aide des méthodes getItem ou createItem, ou en utilisant la méthode getItemAt à partir d’une collection gérée. Seules les modifications concernant des éléments définis par les valeurs de ce tableau seront validées.
| |
cascadeCommit:Boolean (default = false ) — Si la valeur est true , les modifications apportées aux éléments associés spécifiés dans cette liste sont également validées.
|
mx.rpc:AsyncToken — Objet AsyncToken renvoyé dans la propriété call de ResultEvent.RESULT ou 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. Si aucune modification n’a été apportée aux éléments concernés, la valeur null est renvoyée à la place d’un objet AsyncToken.
|
Valeur émise
Error — Si l’initialisation est en cours. Une erreur peut se produire lorsqu’une destination d’exécution est référencée et qu’une validation est appelée avant l’initialisation de ce service, ou lorsque la propriété cacheID a été définie et que le cache local n’a pas été chargé. Dans les situations qui attendent un résultat ou une erreur sur un jeton renvoyé par un appel d’initialisation ou une opération précédente, le fait d’appeler la méthode commit permet d’éviter l’erreur.
|
commitRequiredOn | () | méthode |
public function commitRequiredOn(object:Object):Boolean
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.1 |
Indique s’il existe des modifications en attente pour cet objet particulier. Autorise l’activation granulaire dans l’interface utilisateur. (Voir la section commitRequired correspondant à la propriété liable pour les notifications).
Paramètres
object:Object — L’objet susceptible d’avoir des modifications.
|
Boolean — true si l’objet a des modifications en attente.
|
connect | () | méthode |
public function connect():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 |
Force ce service à réaliser une tentative de connexion à la destination distante. Cette méthode peut être utilisée conjointement avec la propriété autoConnect
et la méthode disconnect()
pour contrôler l’état de la connexion.
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. Lors de l’appel de la méthode connect() , le gestionnaire de résultat du jeton est systématiquement appelé et le résultat correspond à la valeur actuelle de la propriété connected de ce service.
|
count | () | méthode |
public function count(... args):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 |
Appelle une méthode count sur la destination distante. La méthode count appelée est basée sur les balises <count-method> associées et sur les paramètres transmis. Supposons par exemple que l’appel count("firstName", "Bob")
ci-dessous a été réalisé et que des balises <count-method> existent ou sont référencées dans le fichier services-config.xml de la destination associée :
<count-method> <name>getCount</name> <params>java.lang.String,java.lang.String</params> <security-run-as name="freddie" password="nightmare" /> </count-method> <count-method> <name>getCount</name> <security-constraint ref="sample-users" /> </count-method>
Paramètres
... args — Liste d’arguments à transmettre à la destination distante.
|
mx.rpc:AsyncToken — Objet 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.
|
Eléments de l’API associés
createItem | () | méthode |
public function createItem(item:Object):ItemReference
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 |
Demande la création de l’élément spécifié dans le magasin distant. Si une erreur se produit, un événement DataConflictEvent est distribué.
Paramètres
item:Object — Objet à créer dans le magasin distant.
|
ItemReference — Objet ItemReference (qui étend AsyncToken). Cette référence est renvoyée dans la propriété token 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. La propriété result de cet objet peut être liée et utilisée pour lier l’élément renvoyé. Cet objet de résultat est défini sur null si l’élément est supprimé d’un autre client. Si votre application fait appel à des objets ItemReference, vous devez appeler la méthode releaseItem() dans l’instance ItemReference lorsque vous avez terminé cette référence à l’élément. Si votre application ne fait pas appel à l’instance ItemReference , vous pouvez utiliser la méthode releaseItem() sur l’instance DataManager, qui accepte l’instance de l’élément à libérer. Lorsque la méthode createItem() échoue, une erreur est renvoyée. Cependant, l’élément reste en attente. Vous devez appeler la méthode release() pour le supprimer.
|
deleteItem | () | méthode |
public function deleteItem(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 |
Demande la suppression de l’élément spécifié du magasin distant. Si une erreur se produit, un événement DataConflictEvent est distribué.
Paramètres
item:Object — Objet à supprimer dans le magasin distant.
|
mx.rpc:AsyncToken — Objet AsyncToken renvoyé dans la propriété token 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.
|
disconnect | () | méthode |
public function disconnect():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 la connexion réseau de l’instance DataManager. Cette méthode n’attend pas que les opérations de réseau en attente se terminent.
executeQuery | () | méthode |
public function executeQuery(queryName:String, propertySpecifier:PropertySpecifier, ... args):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 en utilisant le nom et les arguments spécifiés. Cette méthode est généralement utilisée avec l’instance RPCDataManager, dans laquelle les requêtes portent un nom spécifique. Vous pouvez également utiliser cette méthode avec les requêtes définies à l’aide de l’approche plus générale utilisant la méthode fill, à condition que le premier paramètre de la méthode fill soit une valeur de chaîne. La valeur queryName est utilisée comme premier paramètre de la méthode fill.
Lorsque vous n’avez plus besoin des objets renvoyés par cette méthode, vous devez appeler la méthode releaseCollection()
pour les résultats de collection ou la méthode releaseItem pour les résultats d’élément de valeur unique. Vous pouvez également libérer toutes les références gérées extraites de cette instance DataManager, en appelant la méthode release()
.
Utilisez la méthode refreshCollection
pour actualiser le contenu des collections renvoyées par cette méthode.
Paramètres
queryName:String — Nom de l’opération à appeler.
| |
propertySpecifier:PropertySpecifier — Jeu de propriétés à récupérer.
| |
... args — Liste des arguments de la requête.
|
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.
|
fill | () | méthode |
public function fill(value:ListCollectionView, ... args):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 |
Remplit l’instance ListCollectionView (collection) spécifiée en fonction de la méthode de remplissage associée de la destination. Par exemple, pour une destination LiveCycle Data Services qui utilise un assembleur Hibernate, le premier paramètre de la méthode fill()
est la collection à remplir, le second paramètre est la requête Hibernate à exécuter, et tous les autres paramètres sont des paramètres de requête Hibernate. Le même format s’applique aux méthodes fill()
utilisées dans les classes service-wrapper pour le développement géré par modèles.
L’exemple suivant illustre une méthode fill()
pour une destination qui utilise un assembleur Hibernate. L’assembleur dispose d’une requête nommée getByDescription
qui prend un paramètre de requête nommé description
:
ProductService.fill(ac, "getByDescription", description);
Pour une destination LiveCycle Data Services faisant appel à la méthode de remplissage dans laquelle vous déclarez les méthodes de remplissage dans les éléments XML de la configuration de destination, si les éléments <fill-method> suivants sont dans la configuration de destination :
<fill-method> <name>loadPersons</name> <params>java.lang.String,java.lang.String</params> </fill-method> <fill-method> <name>loadPersons</name> <security-constraint ref="sample-users" /> </fill-method>Le fait d’appeler
fill(myCollection, "firstName", "Bob")
appelle le premier élément <fill-method>, car il contient deux paramètres, dont les types et le nombre correspondent à la balise <params>. De même, le fait d’appeler fill(myCollection)
appelle la deuxième balise <fill-method>, car elle ne contient pas de balise <params>.
Toutes les modifications en attente concernant les éléments de cette collection sont supprimées. Notez que les données de la collection sont effacées lorsque vous appelez la méthode fill. Vous pouvez également appeler la méthode fill en utilisant une collection remplie précédemment. Dans ce cas, si les paramètres de remplissage sont identiques, la collection est effacée et la méthode fill du serveur est rappelée. Si les paramètres de remplissage diffèrent, l’ancienne collection est libérée et la nouvelle collection est remplie.
Paramètres
value:ListCollectionView — Référence à la collection à remplir à l’aide des arguments spécifiés.
| |
... args — Liste variable d’arguments à transmettre à la destination distante.
|
mx.rpc:AsyncToken — AsyncToken Vous pouvez utiliser ce 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 fill. 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.
|
fillSubset | () | méthode |
public function fillSubset(value:ListCollectionView, ps:PropertySpecifier, ... args):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 |
Remplit l’instance ListCollectionView (collection) spécifiée en fonction de la méthode de remplissage associée de la destination. Un seul sous-ensemble des propriétés est rempli sur chaque objet, comme spécifié dans le paramètre propertySpecifier
.
Paramètres
value:ListCollectionView — Référence à la collection à remplir à l’aide des arguments spécifiés.
| |
ps:PropertySpecifier — Objet PropertySpecifier à transmettre à l’implémentation de la méthode fill du serveur, indiquant quels sous-ensemble de propriétés doivent être remplis sur chaque élément.
| |
... args — Liste variable d’arguments à transmettre à la destination distante.
|
mx.rpc:AsyncToken — AsyncToken Vous pouvez utiliser ce 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 fill. 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.
|
findItem | () | méthode |
public function findItem(queryName:String, propertySpecifier:PropertySpecifier, ... args):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 qui renvoie un seul élément.
Paramètres
queryName:String — Nom de l’opération à appeler.
| |
propertySpecifier:PropertySpecifier — Jeu de propriétés à récupérer.
| |
... args — Liste des arguments de la requête.
|
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.
|
getCacheData | () | méthode |
public function getCacheData(descriptor:CacheDataDescriptor):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 |
Renvoie un objet ArrayCollection ou un objet géré unique, issu du magasin local. L’appel de cette méthode ne met pas à jour l’heure du dernier accès.
Paramètres
descriptor:CacheDataDescriptor — Instance CacheDataDescriptor des données de cache souhaitées.
|
mx.rpc:AsyncToken — Référence AsyncToken au jeton pouvant être utilisé pour déterminer à quel moment le résultat ou l’erreur de cette opération est survenu. La propriété result de l’objet AsyncToken ou de l’événement associé contient une nouvelle instance d’un objet ArrayCollection non géré ou d’un objet ItemReference pour chaque appel.
|
getCacheDescriptors | () | méthode |
public function getCacheDescriptors(view:ListCollectionView, options:uint = 0, item:Object = 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 |
Remplit l’instance ListCollectionView (collection) spécifiée avec des instances CacheDataDescriptor. Si aucun argument n’est spécifié, toutes les instances CacheDataDescriptor associées des données mises en cache pour ce service sont renvoyées.
Paramètres
view:ListCollectionView — Référence ListCollectionView à une collection pouvant être remplie à l’aide des descripteurs souhaités.
| |
options:uint (default = 0 ) — Doit correspondre à l’une des constantes suivantes :
| |
item:Object (default = null ) — Référence d’objet à une instance ItemReference spécifique, à un élément géré ou à une instance ListCollectionView . Lorsque ce paramètre est spécifié, il remplace l’argument options.
|
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.
|
getCacheIDs | () | méthode |
public function getCacheIDs(view:ListCollectionView):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 |
Remplit l’instance ListCollectionView (collection) spécifiée avec tous les identificateurs de cache précédemment utilisés dans l’application.
Paramètres
view:ListCollectionView — Référence ListCollectionView à une collection devant être remplie en utilisant tous les identificateurs de cache précédemment utilisés dans l’application.
|
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.
|
getItem | () | méthode |
public function getItem(identity:Object, defaultValue:Object = null):ItemReference
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éalise une demande asynchrone concernant un élément correspondant à l’identité spécifiée. Si vous spécifiez une valeur defaultValue
et que l’élément n’existe pas, l’élément est créé en utilisant les informations définies dans defaultValue
. Cette méthode renvoie une instance ItemReference. Si vous recevez une instance valide de l’appel de la méthode getItem()
, vous devez appeler la méthode releaseItem()
pour libérer une instance de l’élément. Si vous faites appel à l’instance ItemReference, vous devez appeler la méthode releaseItem()
sur la référence pour faire en sorte de libérer la référence correcte au cas où votre client aurait réalisé plusieurs appels de la méthode getItem()
pour le même élément. Si vous ne faites pas appel à l’instance ItemReference, vous pouvez appeler la méthode releaseItem()
sur l’instance DataManager en utilisant l’élément lui-même.
Paramètres
identity:Object — Objet contenant les propriétés d’identité de l’objet souhaité.
| |
defaultValue:Object (default = null ) — Instance de ce type utilisant les valeurs par défaut et devant être créée si elle n’existe pas.
|
ItemReference — Instance ItemReference de l’élément que vous souhaitez obtenir. L’instance ItemReference étend l’instance AsyncToken et vous pouvez par conséquent l’utiliser pour recevoir des notifications signalant quand l’élément a été extrait ou quand cet appel génère une erreur. L’instance ItemReference est renvoyée dans la propriété token de ResultEvent.RESULT ou dans FaultEvent.FAULT si vous écoutez les événements de l’objet DataManager. 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. Vous pouvez également utiliser une liaison de données pour établir une liaison avec la propriété result de l’instance ItemReference. Cette propriété est définie sur une valeur valide lorsque l’élément est rempli à partir de la destination distante et peut être liée. Ainsi, vous pouvez tout simplement lier vos contrôles d’interface utilisateur aux propriétés de la propriété result de l’instance ItemReference. Si l’élément est supprimé du serveur ou d’un autre client, cette référence est définie sur null. L’instance ItemReference comporte également une propriété invalid , définie sur true si des erreurs renvoient l’élément ou si le serveur renvoie la valeur null pour un élément.
|
getLocalItem | () | méthode |
public function getLocalItem(identity:Object):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 |
Recherche l’élément spécifié en utilisant l’identité indiquée. Si l’élément est déjà géré sur ce client, l’instance gérée est renvoyée. Sinon, la valeur null est renvoyée. Contrairement à l’appel de la méthode getItem
, cet appel n’envoie pas de requête au serveur et n’ajoute pas de référence supplémentaire à l’élément.
Paramètres
identity:Object — Objet contenant les propriétés d’identité de l’objet souhaité.
|
Object — Objet Objet géré ou null si l’élément correspondant à cet ID n’est pas encore géré sur ce client.
|
getPageInformation | () | méthode |
public function getPageInformation(view:ListCollectionView):PageInformation
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 les informations sur la page de la collection spécifiée.
Paramètres
view:ListCollectionView — Collection d’intérêt.
|
PageInformation — Informations sur la page de la collection spécifiée.
|
getPendingOperation | () | méthode |
public function getPendingOperation(item:Object):uint
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 l’opération en cours dans le cache de messages de l’élément spécifié. Utilisez cette méthode pour fournir à un utilisateur un aperçu visuel du type de modifications apportées à un élément.
Paramètres
item:Object — Objet IManaged à comparer.
|
uint — Valeur uint indiquant quelle opération en attente a été réalisée. Opérations valides pour un élément :
|
initialize | () | méthode |
public function initialize():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 |
Force l’initialisation de l’instance DataStore.
Valeur renvoyéemx.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.
|
isCollectionManaged | () | méthode |
public function isCollectionManaged(view:ListCollectionView):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 |
Renvoie true si la collection transmise est gérée par ce service. Si la collection est gérée par ce service, vous pouvez sans problème transmettre la collection à la méthode releaseCollection()
pour la libérer et faire en sorte qu’elle ne soit plus gérée.
Paramètres
view:ListCollectionView — Référence ListCollectionView devant être testée pour savoir si elle est gérée par ce service.
|
Boolean — True si la collection est gérée par ce service, false dans le cas contraire.
|
isCollectionPaged | () | méthode |
public function isCollectionPaged(view:ListCollectionView):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 |
Renvoie true si la collection transmise utilise des fonctionnalités de pagination. Si la collection est paginée par ce service, vous pouvez sans problème transmettre la collection à la méthode releaseItemsFromCollection()
afin de libérer les différents éléments de la collection et faire en sorte qu’ils ne soient plus gérés.
Paramètres
view:ListCollectionView — Référence ListCollectionView devant être testée pour savoir si elle est gérée par ce service.
|
Boolean — True si la collection utilise des fonctionnalités de pagination, false dans le cas contraire.
|
isRangeResident | () | méthode |
public function isRangeResident(view:ListCollectionView, startIndex:int, numberOfItems:int):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 |
Renvoie true si la plage d’éléments spécifiée est intégralement paginée. Renvoie false dans le cas contraire.
Paramètres
view:ListCollectionView — Instance ListCollectionView gérée par ce service de données.
| |
startIndex:int — Index de départ de l’instance ListCollectionView.
| |
numberOfItems:int — Nombre d’éléments de l’instance ListCollectionView.
|
Boolean — true si la collection est intégralement résidente, false si au moins un des éléments présents dans la plage spécifiée n’est pas résident.
|
localFill | () | méthode |
public function localFill(value:ListCollectionView, ps:PropertySpecifier, ... args):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 |
Remplit l’instance ListCollectionView spécifiée en fonction des éléments <fill-method> associés, conformément aux données du magasin local. Elle appellera l’API offlineAdapter.executeOfflineQuery() pour interroger les données et ne tentera pas d’interroger la destination distante, même si l’application est connectée. Cette méthode est parfaitement adaptée lorsque les données sont synchronisées sur le client et que les requêtes locales sont exécutées par rapport.
Paramètres
value:ListCollectionView — Référence à la collection à remplir à l’aide des arguments spécifiés.
| |
ps:PropertySpecifier — Objet PropertySpecifier à transmettre à l’adaptateur déconnecté, indiquant quel sous-ensemble de propriétés doit être rempli sur chaque élément.
| |
... args — Liste de variables d’arguments args:Array à transmettre à l’adaptateur déconnecté.
|
mx.rpc:AsyncToken — AsyncToken Vous pouvez utiliser ce 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 fill locale. Ce jeton est également renvoyé dans la propriété call de ResultEvent.RESULT ou dans FaultEvent.FAULT .
|
merge | () | méthode |
public function merge():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 |
Fusionne les mises à jour en attente dans l’ensemble d’objets géré. Le processus de fusion des modifications détecte les conflits et traite les éventuelles demandes d’élément en attente. Cette opération fusionne tous les messages des autres instances DataManager qui partagent cette instance DataStore.
refresh | () | méthode |
public function refresh():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 |
Actualise toutes les données gérées par cette instance DataManager. Les remplissages, les demandes d’obtention d’élément et les demandes de page sont effectués sur le serveur pour récupérer tous les éléments gérés. Utilisez la méthode DataStore.refresh()
pour actualiser également tous les éléments associés pour les associations pour lesquelles lazy = true.
mx.rpc:AsyncToken — Vous pouvez utiliser le jeton AsyncToken pour enregistrer une ou plusieurs fonctions de rappel pour les événements de résultat ou d’erreur issus de l’opération réactualiser.
|
refreshCollection | () | méthode |
public function refreshCollection(value:ListCollectionView):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 |
Actualise une collection précédemment remplie en utilisant la méthode fill ou gérée en tant qu’association gérée. Cette méthode envoie une demande au serveur et récupère la nouvelle version des éléments résidents de la collection en utilisant les paramètres fill utilisés initialement avec cette collection ou en récupérant la propriété de l’élément parent. Si des modifications sont détectées, elles sont fusionnées dans la collection de façon incrémentielle.
Paramètres
value:ListCollectionView — Instance ListCollectionView gérée par cette instance DataManager.
|
mx.rpc:AsyncToken — Vous pouvez utiliser le jeton AsyncToken pour enregistrer une ou plusieurs fonctions de rappel afin de recevoir les événements de résultat ou d’erreur issus de l’opération réactualiser. La valeur null est renvoyée s’il n’y a rien à actualiser pour une collection paginée. 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.
|
release | () | méthode |
public function release(clear:Boolean = true, copyStillManagedItems:Boolean = true):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 |
Libère tous les éléments et collections gérés de l’instance DataManager.
Paramètres
clear:Boolean (default = true ) — Booléen indiquant si tous les éléments doivent être supprimés de la liste. Par ailleurs, aucune copie d’élément n’est réalisée.
| |
copyStillManagedItems:Boolean (default = true ) — Utilisez ce paramètre si après avoir libéré ce service de données, les références issues d’associations gérées d’autres services de données sont susceptibles de contenir des références à certains de ces objets gérés. Dans ce cas, certaines collections gérées de ce service de données peuvent encore être gérées. Si vous transmettez la valeur true pour cet indicateur, ces références soit sont supprimées (clear=true), soit clonée (clear=false). Si vous transmettez la valeur false pour cet indicateur, ces références actives sont conservées telles quelles. L’utilisation de la valeur false constitue le moyen le plus rapide pour effacer l’état du système. En utilisant la valeur true , vous vous assurez que les collections ou éléments extraits à partir de ce service de données ne contiennent pas de référence à des états gérés.
|
Eléments de l’API associés
releaseCollection | () | méthode |
public function releaseCollection(view:ListCollectionView, clear:Boolean = false, copyStillManagedItems:Boolean = true):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 |
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. Si l’élément est présent dans plusieurs collections, une copie de l’élément est réalisée. Les modifications non validées apportées à un élément présent uniquement dans cette collection sont libérées, y compris les suppressions, créations et mises à jour.
Paramètres
view:ListCollectionView — Référence ListCollectionView qui ne doit plus recevoir de mise à jour distante.
| |
clear:Boolean (default = false ) — Indique si tous les éléments doivent être supprimés de la liste. Par ailleurs, aucune copie d’élément n’est réalisée.
| |
copyStillManagedItems:Boolean (default = true ) — Indique s’il existe d’autres références gérées à des éléments de cette collection. Ce paramètre détermine si des copies de ces éléments doivent être réalisées, de sorte qu’après l’appel, vous êtes certain que la collection ne contient plus d’élément géré. En définissant à la fois cette option et le paramètre clear sur false, vous pouvez libérer rapidement les références gérées.
|
releaseItem | () | méthode |
public function releaseItem(item:IManaged, copyStillManagedItems:Boolean = true, enableStillManagedCheck:Boolean = true):IManaged
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 |
Libère l’élément spécifié afin qu’il ne soit plus géré par cette instance DataManager. Si vous faites appel à une instance ItemReference, vous devez appeler la méthode releaseItem()
sur l’instance ItemReference pour faire en sorte de libérer la référence correcte, au cas où plusieurs appels getItem()
extrayant le même élément dans différentes parties de l’application cliente auraient été réalisés.
Cet appel libère les ressources associées, y compris les propriétés imbriquées. L’élément spécifié ne reçoit plus de mise à jour de la destination distante. Par ailleurs, s’il existe des modifications non validées pour cet élément et qu’il ne s’affiche pas dans une autre collection, ces modifications sont également libérées. Si l’élément spécifié est présent dans plusieurs collections, la valeur renvoyée est une copie de l’original, sauf si le paramètre allowCopy
est défini sur false
.
Paramètres
item:IManaged — Référence IManaged à l’élément à libérer.
| |
copyStillManagedItems:Boolean (default = true ) — Booléen indiquant si des copies des éléments qui sont toujours gérés doivent être réalisées dans le graphique d’objets. La valeur false efface la référence à ces éléments.
| |
enableStillManagedCheck:Boolean (default = true ) — Transmettez une valeur false pour ce paramètre pour désactiver la copie ou effacer des éléments encore gérés. Dans ce cas votre valeur renvoyée est toujours la valeur gérée d’origine libérée et si une autre référence utilise toujours cet élément, il continue à être géré même après sa libération.
|
IManaged — Elément libéré, c’est-à-dire une copie si copyStillManagedItems a la valeur false et que l’élément est géré par une autre référence.
|
releaseItemsFromCollection | () | méthode |
public function releaseItemsFromCollection(collection:ListCollectionView, startIndex:int, numberOfItems:int):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 |
Libère une plage d’éléments de la collection. Lorsque la pagination est activée pour une collection volumineuse, il peut être utile de libérer les ressources occupées par les éléments de la collection et de résilier les abonnements aux mises à jour de ces éléments. Vous devez spécifier la valeur startIndex
du premier élément à libérer, ainsi que le nombre d’éléments à libérer. Si un élément qui se trouve à cette position n’est pas encore paginé, cet index est ignoré.
Paramètres
collection:ListCollectionView — Instance ListCollectionView gérée.
| |
startIndex:int — Index du premier élément à libérer.
| |
numberOfItems:int — Nombre d’éléments à libérer à partir de la position spécifiée. La valeur de numberOfItems doit être supérieure à 0 et la somme de startIndex et de numberOfItems doit être inférieure à collection.length.
|
int — Nombre de références libérées.
|
releaseReference | () | méthode |
public function releaseReference(item:Object, propName:String):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 |
Libère la valeur d’une association monovaluée. Si la valeur n’est pas paginée, la valeur false est renvoyée. Si la valeur est paginée, cette référence est libérée et la valeur true est renvoyée. S’il s’agissait de la dernière référence à l’élément spécifique, la tentative suivante pour accéder à cet élément entraîne une nouvelle récupération de l’erreur ItemPendingError et de la valeur.
Paramètres
item:Object — Elément parent contenant une propriété qui est une association monovaluée.
| |
propName:String — Nom de la propriété faisant référence à une association monovaluée.
|
Boolean — true si la valeur a été libérée.
|
revertChanges | () | méthode |
public function revertChanges(item:IManaged = null):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 |
Rétablit les modifications non validées apportées à l’élément spécifié. Si aucun élément n’est spécifié, toutes les modifications non validées sont rétablies. Si vous rétablissez une opération de création, l’élément est supprimé. Si vous rétablissez une opération de suppression, l’élément est à nouveau ajouté. Le fait de rétablir une mise à jour restaure les propriétés d’origine de l’élément, telles qu’elles étaient définies avant que vous ne commenciez à les modifier. L’appel de cette méthode équivaut à appeler la méthode dataStore.revertChanges()
.
Cette méthode est notamment utilisée lorsqu’une erreur survient. Ainsi, les modifications qui ont échoué sont replacées dans la liste des modifications non validées. A ce stade, vous pouvez soit modifier les modifications pour corriger le problème, soit les rétablir à l’aide de cette méthode, pour éviter qu’elles ne soient à nouveau appliquées.
Si un élément est fourni et que celui-ci ne comporte aucune modification, cette méthode renvoie false. Si aucun élément n’est fourni et qu’aucune modification n’est présente, cette méthode renvoie false. Dans le cas contraire, elle renvoie la valeur true.
Paramètres
item:IManaged (default = null ) — Référence aux modifications rétablies ou null si vous souhaitez rétablir toutes les modifications.
|
Boolean — Booléen indiquant si des modifications ont été rétablies.
|
revertChangesForCollection | () | méthode |
public function revertChangesForCollection(collection:ListCollectionView = null):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 |
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.
Paramètres
collection:ListCollectionView (default = null ) — La collection à rétablir.
|
Boolean — True si des modifications ont été rétablies.
|
saveCache | () | méthode |
public function saveCache(value:Object = 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 enregistre l’état actif du cache de l’instance DataManager. Le cache inclut les éléments en mémoire ainsi que les modifications apportées à ces éléments qui n’ont pas été envoyées à la destination distante.
Paramètres
value:Object (default = null ) — Référence d’objet à une instance ListCollectionView gérée ou à un objet.
|
mx.rpc:AsyncToken — Objet AsyncToken pouvant être utilisé pour signaler la réussite ou l’échec de l’opération.
|
Eléments de l’API associés
Exemple ( Comment utiliser cet exemple )
var customerService:DataService = new DataService("customers"); var customers:ArrayCollection = new ArrayCollection(); customerService.fill(customers); // ... var customer:Customer = Customer(customers[0]); customer.priority = "top"; customerService.saveCache(); // now all of the changes and items in the customers collection // will be persisted locally
saveCacheRequiredOn | () | méthode |
public function saveCacheRequiredOn(object:Object):Boolean
Version du langage: | ActionScript 3.0 |
Version du produit: | Adobe Digital Enterprise Platform Data Services for Java EE 4.5 |
Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Indique s’il existe des modifications en attente pour cet objet particulier qui n’ont pas été enregistrées dans le cache local. Cette méthode peut renvoyer la valeur false lorsque comitRequiredOn doit renvoyer true, indiquant que le changement est enregistré dans le cache local, mais qu’il n’est pas validé sur le serveur.
Paramètres
object:Object — L’objet susceptible d’avoir des modifications.
|
Boolean — true si l’objet a des modifications en attente.
|
synchronizeAllFills | () | méthode |
public function synchronizeAllFills():mx.rpc:AsyncToken
Version du langage: | ActionScript 3.0 |
Version du produit: | Adobe Digital Enterprise Platform Data Services for Java EE 4.5 |
Versions du moteur d’exécution: | Flash Player 10.1, AIR 2.0 |
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).
Valeur renvoyéemx.rpc:AsyncToken — AsyncToken Vous pouvez utiliser ce 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.
|
synchronizeDataServices | () | méthode |
public static function synchronizeDataServices(services:Array):mx.rpc:AsyncToken
Version du langage: | ActionScript 3.0 |
Version du produit: | Adobe Digital Enterprise Platform Data Services for Java EE 4.5 |
Versions du moteur d’exécution: | Flash Player 10.1, AIR 2.0 |
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.
Paramètres
services:Array — Un tableau de services de données à synchroniser.
|
mx.rpc:AsyncToken — AsyncToken Vous pouvez utiliser ce 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.
|
synchronizeFill | () | méthode |
public function synchronizeFill(... fillArgs):mx.rpc:AsyncToken
Version du langage: | ActionScript 3.0 |
Version du produit: | Adobe Digital Enterprise Platform Data Services for Java EE 4.5 |
Versions du moteur d’exécution: | Flash Player 10.1, AIR 2.0 |
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. Il s’agit des éléments créés, des éléments mis à jour et des éléments supprimés. Si aucun remplissage précédent ne s’est produit, cela équivaut à la réalisation d’un premier remplissage.
Paramètres
... fillArgs — fillArgs Les paramètres du remplissage.
|
mx.rpc:AsyncToken — AsyncToken Vous pouvez utiliser ce 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 fill. Une instance ChangedItems est utilisée comme objet de résultat dans l’événement ResultEvent transmis au gestionnaire de résultats, décrivant les éléments modifiés qui ont été renvoyés.
|
updateItem | () | méthode |
public function updateItem(item:Object, origItem:Object = null, changes:Array = 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 |
Déclenche une mise à jour de l’élément spécifié. Si vous appelez cette méthode en utilisant l’instance gérée, elle valide les modifications apportées à cet élément et renvoie un jeton que vous pouvez utiliser pour suivre ces modifications. S’il n’existe pas de modifications en attente pour cet élément, un jeton null est renvoyé. Si vous appelez cette méthode en utilisant une autre copie de l’instance, elle copie les propriétés modifiées du tableau des modifications dans le journal de l’instance gérée, puis valide ces modifications. Si la méthode autoCommit
est définie sur la valeur true
, les modifications pour cet élément sont validées immédiatement. Si elle est définie sur false
, les modifications sont mises en file d’attente jusqu’à ce que la méthode commit()
soit appelée.
Paramètres
item:Object — élément à mettre à jour.
| |
origItem:Object (default = null ) — version de l’élément avant les modifications. Cette version est utilisée pour la détection de conflit. Peut être null.
| |
changes:Array (default = null ) — tableau des noms de propriétés qui ont été mis à jour. Utilisé à des fins d’amélioration des performances. Peut être null.
|
mx.rpc:AsyncToken — Un objet AsyncToken que vous pouvez utiliser pour suivre les modifications (par exemple, un événement fault ou result est distribué lorsque des modifications apportées à cet élément sont validées). S’il n’existe pas de modifications à un élément, un objet AsyncToken null est renvoyé at aucun autre élément n’est mis en attente.
|
conflict | Evénement |
mx.data.events.DataConflictEvent
proprié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.
CONFLICT
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.DataServiceFaultEvent
proprié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 DataManagerFaultEvent.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 l’erreur 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.MessageEvent
proprié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.PropertyChangeEvent
proprié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 :
commitRequired
mergeRequired
connected
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.ResultEvent
proprié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