DataService

Package	mx.data.mxml
Classe	public class DataService
Héritage	DataService DataService DataManager Object
Implémente	IMXMLObject

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 DataService offre une fonctionnalité de niveau supérieur côté client pour le service de gestion des données LiveCycle Data Services. Il s’agit d’une sous-classe MXML de la classe mx.data.DataService permettant de définir des liaisons avec les propriétés d’une instance DataService.

Remarque : pour que vous puissiez utiliser un objet DataService, la propriété destination doit être définie.

Syntaxe MXML expanded

Masquer la syntaxe MXML

The <mx:DataService> tag accepts the following tag attributes:

  <mx:DataService
   Properties
   autoCommit="true"
   autoMerge="true"
   autoSaveCache="false"
   autoSyncEnabled="true"
   conflictDetector="No default."
   dataStore="No default."
   destination="No default."
   pageSize="No default."
   id="No default."
 
   Events
   conflict="No default."
   fault="No default."
   message="No default."
   propertyChange="No default."
   result="No default."
 />

Eléments de l’API associés

mx.data.DataService
mx.data.Conflicts
mx.data.Conflict
mx.data.ItemReference
mx.data.IManaged
mx.data.utils.Managed
mx.data.IChangeObject

Propriétés publiques

Masquer les propriétés publiques héritées

Afficher les propriétés publiques héritées

	Propriété		Défini par
		adapter : DataServiceAdapter = null Instance d’une classe contrôlant les interactions avec le serveur.	DataManager
		autoCommit : Boolean Indique si les modifications apportées au cache local sont automatiquement validées.	DataManager
		autoConnect : Boolean Indique si ce service doit essayer d’établir une connexion pour les opérations qui nécessitent une connexion.	DataManager
		autoMerge : Boolean Si la valeur est définie sur false, lorsque des modifications sont transférées de la destination distante vers le client, elles ne sont pas appliquées immédiatement.	DataManager
		autoSaveCache : Boolean Vous pouvez stocker le cache local contenant les données et les modifications sur le disque.	DataManager
		autoSyncEnabled : Boolean Lorsque la valeur est true, les demandes fill(), createItem() et getItem() renvoient les éléments qui écoutent les mises à jour réalisées sur ces éléments à partir de la destination distante.	DataManager
		cacheID : String Permet d’accéder à l’identificateur de cache de ce service.	DataManager
		channelSet : ChannelSet Fournit un accès à la classe ChannelSet utilisée par le service.	DataService
		commitRequired : Boolean [lecture seule] Détermine s’il existe des modifications non validées et si la méthode commit() doit être appelée.	DataManager
		conflictDetector : ConflictDetector Permet d’accéder à l’implémentation actuellement utilisée pour détecter les conflits liés aux opérations distantes transférées vers cette instance DataManager.	DataManager
		conflicts : Conflicts [lecture seule] Contient un objet Conflicts, c’est-à-dire une instance ArrayList d’instances Conflict.	DataManager
		connected : Boolean [lecture seule] Indique si l’instance DataService est connectée à la destination distante.	DataManager
		constructor : Object Référence à l’objet de classe ou à la fonction constructeur d’une occurrence donnée d’un objet.	Object
		dataStore : DataStore Contient un objet de type mx.data.DataStore.	DataManager
		deleteItemOnRemoveFromFill : Boolean Par défaut, lorsque vous appelez la méthode removeItemAt() sur une collection remplie gérée, elle lance un appel de suppression d’élément vers le serveur pour supprimer physiquement l’élément.	DataManager
		destination : String [override] Indique à quelle destination distante ce service est associé.	DataService
		encryptLocalCache : Boolean Indique si le stockage hors connexion doit être chiffré pour les clients AIR qui utilisent un adaptateur SQL déconnecté.	DataManager
		fallBackToLocalFill : Boolean Cet indicateur détermine si l’application doit réaliser une requête sur le magasin local lorsqu’il n’est pas connecté.	DataManager
		hierarchicalEventsDefault : Boolean Les associations peuvent éventuellement répertorier les événements de modification de propriété relatifs aux propriétés des instances associées.	DataManager
		ignoreCollectionUpdates : Boolean Indique si les modifications apportées aux collections gérées doivent être ignorées au lieu d’être communiquées au serveur lors d’une validation.	DataManager
		indexReferences : Boolean Pour optimiser la vitesse de votre application, définissez cette propriété sur false si le nombre de remplissages ou de références concernant les éléments gérés par cette instance DataManager et issus des propriétés d’association d’autres éléments est relativement limité.	DataManager
		isInitialized : Boolean [lecture seule] Indique si les métadonnées associées à cette instance DataManager sont initialisées.	DataManager
		manualSync : ManualSyncConfiguration Permet d’accéder à l’instance ManualSyncConfiguration de chaque instance DataManager.	DataManager
		maxFrequency : uint Détermine le nombre maximal de messages par seconde que l’instance DataManager souhaite recevoir.	DataManager
		mergeRequired : Boolean [lecture seule] Indique s’il existe des modifications en attente à fusionner.	DataManager
		offlineAdapter : DataServiceOfflineAdapter Renvoie un objet de type mx.data.DataServiceOfflineAdapter.	DataManager
		pageSize : int Permet d’accéder à la taille de page actuelle de toutes les collections.	DataManager
		pagingEnabled : Boolean [lecture seule] Indique si la destination distante est configurée pour autoriser les demandes de page.	DataManager
		priority : int Priorité par défaut des messages envoyés par l’instance DataManager.	DataManager
		requestTimeout : int Permet d’accéder au délai d’expiration des demandes d’une opération, en secondes.	DataManager
		resetCollectionOnFill : Boolean Lorsque cette propriété est définie sur true, un événement RESET est envoyé une fois l’opération terminée.	DataManager
		resubscribeAttempts : int Contrôle le nombre de tentatives de réabonnement à sa destination qu’une instance DataManager déconnectée peut effectuer.	DataManager
		resubscribeInterval : int Contrôle le délai, en millisecondes, entre les tentatives de réabonnement.	DataManager
		saveCacheRequired : Boolean [lecture seule] Indique s’il existe des modifications qui n’ont pas été enregistrées dans le cache local et que la méthode saveCache() doit être appelée.	DataManager
		subscribed : Boolean [lecture seule] Indique si l’instance DataManager est abonnée à la destination distante.	DataManager
		throwItemPendingErrors : Boolean Définissez cette propriété sur false si vous souhaitez supprimer l’envoi d’erreurs d’éléments en attente lors de l’accès à des données récupérées à la demande ou non paginées.	DataManager

Méthodes publiques

Masquer les méthodes publiques héritées

Afficher les méthodes publiques héritées

	Méthode		Défini par
		DataService(dest:String = null) Crée une instance de l’objet DataService en utilisant la destination spécifiée.	DataService
		clearCache(value:Object = null):mx.rpc:AsyncToken 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
		clearCacheData(descriptor:CacheDataDescriptor):mx.rpc:AsyncToken Efface du magasin local les données spécifiées par le descripteur transmis.	DataManager
		commit(itemsOrCollections:Array = null, cascadeCommit:Boolean = false):mx.rpc:AsyncToken Valide les modifications en attente pour toutes les collections actuellement gérées par l’instance DataStore associée à cette instance DataManager.	DataManager
		commitRequiredOn(object:Object):Boolean Indique s’il existe des modifications en attente pour cet objet particulier.	DataManager
		connect():mx.rpc:AsyncToken Force ce service à réaliser une tentative de connexion à la destination distante.	DataManager
		count(... args):mx.rpc:AsyncToken Appelle une méthode count sur la destination distante.	DataManager
		createItem(item:Object):ItemReference Demande la création de l’élément spécifié dans le magasin distant.	DataManager
		deleteItem(item:Object):mx.rpc:AsyncToken Demande la suppression de l’élément spécifié du magasin distant.	DataManager
		disconnect():void Déconnecte la connexion réseau de l’instance DataManager.	DataManager
		executeQuery(queryName:String, propertySpecifier:PropertySpecifier, ... args):mx.rpc:AsyncToken Exécute une requête en utilisant le nom et les arguments spécifiés.	DataManager
		fill(value:ListCollectionView, ... args):mx.rpc:AsyncToken Remplit l’instance ListCollectionView (collection) spécifiée en fonction de la méthode de remplissage associée de la destination.	DataManager
		fillSubset(value:ListCollectionView, ps:PropertySpecifier, ... args):mx.rpc:AsyncToken Remplit l’instance ListCollectionView (collection) spécifiée en fonction de la méthode de remplissage associée de la destination.	DataManager
		findItem(queryName:String, propertySpecifier:PropertySpecifier, ... args):mx.rpc:AsyncToken Exécute une requête qui renvoie un seul élément.	DataManager
		getCacheData(descriptor:CacheDataDescriptor):mx.rpc:AsyncToken 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
		getCacheIDs(view:ListCollectionView):mx.rpc:AsyncToken Remplit l’instance ListCollectionView (collection) spécifiée avec tous les identificateurs de cache précédemment utilisés dans l’application.	DataManager
		getItem(identity:Object, defaultValue:Object = null):ItemReference Réalise une demande asynchrone concernant un élément correspondant à l’identité spécifiée.	DataManager
		getLocalItem(identity:Object):Object Recherche l’élément spécifié en utilisant l’identité indiquée.	DataManager
		getPageInformation(view:ListCollectionView):PageInformation Renvoie les informations sur la page de la collection spécifiée.	DataManager
		getPendingOperation(item:Object):uint Renvoie l’opération en cours dans le cache de messages de l’élément spécifié.	DataManager
		hasOwnProperty(name:String):Boolean Indique si la propriété spécifiée d’un objet est définie.	Object
		initialize():mx.rpc:AsyncToken Force l’initialisation de l’instance DataStore.	DataManager
		isCollectionManaged(view:ListCollectionView):Boolean Renvoie true si la collection transmise est gérée par ce service.	DataManager
		isCollectionPaged(view:ListCollectionView):Boolean Renvoie true si la collection transmise utilise des fonctionnalités de pagination.	DataManager
		isPrototypeOf(theClass:Object):Boolean 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
		isRangeResident(view:ListCollectionView, startIndex:int, numberOfItems:int):Boolean Renvoie true si la plage d’éléments spécifiée est intégralement paginée.	DataManager
		localFill(value:ListCollectionView, ps:PropertySpecifier, ... args):mx.rpc:AsyncToken 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
		logout():void Déconnecte l’utilisateur de la destination de l’instance DataService.	DataService
		merge():void Fusionne les mises à jour en attente dans l’ensemble d’objets géré.	DataManager
		propertyIsEnumerable(name:String):Boolean Indique si la propriété spécifiée existe et est énumérable.	Object
		refresh():mx.rpc:AsyncToken Actualise toutes les données gérées par cette instance DataManager.	DataManager
		refreshCollection(value:ListCollectionView):mx.rpc:AsyncToken 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
		release(clear:Boolean = true, copyStillManagedItems:Boolean = true):void 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
		releaseItemsFromCollection(collection:ListCollectionView, startIndex:int, numberOfItems:int):int Libère une plage d’éléments de la collection.	DataManager
		releaseReference(item:Object, propName:String):Boolean Libère la valeur d’une association monovaluée.	DataManager
		revertChanges(item:IManaged = null):Boolean Rétablit les modifications non validées apportées à l’élément spécifié.	DataManager
		revertChangesForCollection(collection:ListCollectionView = null):Boolean 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
		saveCache(value:Object = null):mx.rpc:AsyncToken Cette méthode enregistre l’état actif du cache de l’instance DataManager.	DataManager
		saveCacheRequiredOn(object:Object):Boolean Indique s’il existe des modifications en attente pour cet objet particulier qui n’ont pas été enregistrées dans le cache local.	DataManager
		setCredentials(username:String, password:String):void Définit les informations d’identification de cette destination DataService.	DataService
		setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void Définit la disponibilité d’une propriété dynamique pour les opérations en boucle.	Object
		setRemoteCredentials(username:String, password:String):void Définit les informations d’identification du tiers de cette destination DataService.	DataService
		synchronizeAllFills():mx.rpc:AsyncToken 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
		synchronizeDataServices(services:Array):mx.rpc:AsyncToken [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
		synchronizeFill(... fillArgs):mx.rpc:AsyncToken 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
		toLocaleString():String Renvoie la représentation de chaîne de cet objet, formatée selon les paramètres régionaux en vigueur.	Object
		toString():String Renvoie la représentation sous forme de chaîne de l’objet spécifié.	Object
		updateItem(item:Object, origItem:Object = null, changes:Array = null):mx.rpc:AsyncToken Déclenche une mise à jour de l’élément spécifié.	DataManager
		valueOf():Object Renvoie la valeur primitive de l’objet spécifié.	Object

Méthodes protégées

Masquer les méthodes protégées héritées

Afficher les méthodes protégées héritées

	Méthode		Défini par
		checkImplementation():void Met en file d’attente une erreur si ce gestionnaire de données n’a pas encore été initialisé.	DataManager

Evénements

Cliquez pour plus d’informations sur les événements

Masquer les événements hérités

Afficher les événements hérités

	Synthèse	Défini par
conflict	L’événement DataConflictEvent.CONFLICT est distribué lorsqu’un conflit entre des modifications locales en attente et des modifications demandées par un autre client est détecté, ou lorsque des modifications demandées par ce client entrent en conflit avec celles de la destination distante.	DataService
fault	L’événement DataServiceFaultEvent.FAULT est distribué lorsqu’un appel de service échoue en raison d’une erreur.	DataService
message	L’événement MessageEvent.MESSAGE est distribué lorsque la destination distante transfère une notification d’opération de données.	DataService
propertyChange	L’événement PropertyChangeEvent.PROPERTY_CHANGE est distribué lorsqu’une propriété de ce service change.	DataService
result	L’événement ResultEvent.RESULT est distribué lorsqu’un appel de service aboutit à un retour.	DataService

Détails de la propriété

destination

propriété

destination:String[override]

Version du langage:

ActionScript 3.0

Version du produit:

Adobe Digital Enterprise Platform Data Services for Java EE 3

Versions du moteur d’exécution:

Flash Player 9, AIR 1.1

Indique à quelle destination distante ce service est associé.

Implémentation
override public function get destination():String
override public function set destination(value:String):void

Détails du constructeur

()

Constructeur

public function DataService(dest:String = 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

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.

Paramètres

dest:String (default = null) — Chaîne contenant le nom de la destination distante à laquelle ce service se connectera.

Informations juridiques | Politique de confidentialité en ligne

DataService - AS3 ADEP Data Services

Classes x

destination

DataService