Guide de référence ActionScript® 3.0 pour la plate-forme Adobe® Flash®
Accueil  |  Masquer la liste des packages et des classes |  Packages  |  Classes  |  Nouveautés  |  Index  |  Annexes  |  Pourquoi existe-t-il du contenu en anglais ?
Filtres : Récupération des données du serveur...
Récupération des données du serveur...
mx.data 

Conflict  - AS3 ADEP Data Services

Packagemx.data
Classepublic class Conflict
HéritageConflict Inheritance Error Inheritance Object
Implémente IExternalizable

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

Représente une erreur survenue à cause d’une opération de mise à jour. Un conflit peut avoir de nombreuses causes. Il se peut par exemple qu’un autre client ait mis à jour la même propriété d’un élément.

Les conflits sont déterminés à la fois par la destination distante et par l’instance DataService locale. Un conflit détecté par l’instance DataService est considéré comme étant un conflit local. Un conflit détecté par la destination distante est un conflit distant.

Les assembleurs personnalisés peuvent générer un conflit distant pour une opération lors du traitement d’une mise à jour. Les conflits locaux sont déterminés par l’objet ConflictDetector. Pour personnaliser la détection des conflits locaux, vous pouvez étendre la classe ConflictDetector et l’affecter à la propriété DataService.conflictDetector.

Pour que les modifications puissent être validées, tous les conflits doivent être résolus.



Propriétés publiques
 PropriétéDéfini par
  cause : DataMessage
[lecture seule] Objet DataMessage qui a provoqué le conflit.
Conflict
  causedByLocalCommit : Boolean
[lecture seule] Contient true si le conflit est dû à la validation d’une modification locale sur la destination distante ou false si le conflit est dû à un conflit entre une modification transférée et une modification locale.
Conflict
  clientObject : Object
[lecture seule] Etat de l’objet client (dont la propriété a été modifiée) au moment où le conflit est survenu.
Conflict
 Inheritedconstructor : Object
Référence à l’objet de classe ou à la fonction constructeur d’une occurrence donnée d’un objet.
Object
  destination : String
[lecture seule] Destination du service de données de l’élément impliqué dans ce conflit.
Conflict
 InheritederrorID : int
[lecture seule] Contient le numéro de référence associé au message d’erreur spécifique.
Error
 Inheritedmessage : String
Contient le message associé à l’objet Error.
Error
 Inheritedname : String
Contient le nom de l’objet Error.
Error
  originalObject : Object
[lecture seule] Etat de l’objet client d’origine, avant modification de ses propriétés, tel qu’il apparaissait au moment où le conflit est survenu.
Conflict
  propertyNames : Array
[lecture seule] Tableau contenant les noms des propriétés provoquant un conflit entre la modification du client et l’état de l’élément distant.
Conflict
  resolved : Boolean
[lecture seule] Indique si ce conflit a été résolu (la méthode acceptClient() ou acceptServer() a été appelée).
Conflict
  serverObject : Object
[lecture seule] Valeur de l’objet serveur dont la propriété allait être modifiée.
Conflict
  serverObjectDeleted : Boolean
[lecture seule] Lorsque la propriété serverObject de cette classe est null, cette propriété permet de savoir si la version serveur est null parce que l’élément a été supprimé du serveur (true) ou parce que l’élément a été supprimé d’un remplissage auquel ce client est abonné (false).
Conflict
  serverObjectReferencedIds : Object
[lecture seule] Si l’objet serverObject comporte des propriétés contenant lazy="true", un objet stockant les tableaux referencedId de chaque propriété chargée à la demande est renvoyé, en utilisant le nom de propriété comme valeur de clé de recherche.
Conflict
Méthodes publiques
 MéthodeDéfini par
  
Met à nouveau en file d’attente les modifications locales actuelles et met à jour les valeurs des propriétés, de sorte que l’appel suivant de la méthode DataService.commit() réussisse et que ces modifications remplacent les modifications précédentes.
Conflict
  
Supprime la modification locale à l’origine du conflit et applique à l’élément local les valeurs des propriétés présentes dans la propriété Conflict.serverObject.
Conflict
 Inherited
Renvoie la pile d’appel pour générer une erreur au moment de la construction de l’erreur en tant que chaîne.
Error
 Inherited
Indique si la propriété spécifiée d’un objet est définie.
Object
 Inherited
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
  
matches(otherConflict:Conflict):Boolean
Vérifie si ce conflit décrit le même élément que celui du conflit donné.
Conflict
 Inherited
Indique si la propriété spécifiée existe et est énumérable.
Object
  
Conflict
 Inherited
Définit la disponibilité d’une propriété dynamique pour les opérations en boucle.
Object
 Inherited
Renvoie la représentation de chaîne de cet objet, formatée selon les paramètres régionaux en vigueur.
Object
  
Renvoie une représentation de chaîne de cet objet de conflit.
Conflict
 Inherited
Renvoie la valeur primitive de l’objet spécifié.
Object
  
Conflict
Constantes publiques
 ConstanteDéfini par
  NONE : String = "none"
[statique] Constante de mode de conflit représentant une détection de zéro conflit.
Conflict
  OBJECT : String = "object"
[statique] Constante de mode de conflit représentant une détection de conflit au niveau de l’objet.
Conflict
  PROPERTY : String = "property"
[statique] Constante de mode de conflit représentant une détection de conflit au niveau de la propriété.
Conflict
Détails de la propriété

cause

propriété
cause:DataMessage  [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

Objet DataMessage qui a provoqué le conflit.



Implémentation
    public function get cause():DataMessage

causedByLocalCommit

propriété 
causedByLocalCommit: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

Contient true si le conflit est dû à la validation d’une modification locale sur la destination distante ou false si le conflit est dû à un conflit entre une modification transférée et une modification locale.



Implémentation
    public function get causedByLocalCommit():Boolean

clientObject

propriété 
clientObject:Object  [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

Etat de l’objet client (dont la propriété a été modifiée) au moment où le conflit est survenu.



Implémentation
    public function get clientObject():Object

destination

propriété 
destination:String  [lecture seule]

Version du langage: ActionScript 3.0
Version du produit: Adobe Digital Enterprise Platform Data Services for Java EE 3
Versions du moteur d’exécution: Flash Player 9, AIR 1.1

Destination du service de données de l’élément impliqué dans ce conflit.



Implémentation
    public function get destination():String

originalObject

propriété 
originalObject:Object  [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

Etat de l’objet client d’origine, avant modification de ses propriétés, tel qu’il apparaissait au moment où le conflit est survenu.



Implémentation
    public function get originalObject():Object

propertyNames

propriété 
propertyNames:Array  [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

Tableau contenant les noms des propriétés provoquant un conflit entre la modification du client et l’état de l’élément distant. Tous les noms des propriétés sont des valeurs String et sont présents dans l’espace de nom public.



Implémentation
    public function get propertyNames():Array

resolved

propriété 
resolved: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 ce conflit a été résolu (la méthode acceptClient() ou acceptServer() a été appelée).



Implémentation
    public function get resolved():Boolean

Eléments de l’API associés

serverObject

propriété 
serverObject:Object  [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

Valeur de l’objet serveur dont la propriété allait être modifiée.



Implémentation
    public function get serverObject():Object

serverObjectDeleted

propriété 
serverObjectDeleted: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

Lorsque la propriété serverObject de cette classe est null, cette propriété permet de savoir si la version serveur est null parce que l’élément a été supprimé du serveur (true) ou parce que l’élément a été supprimé d’un remplissage auquel ce client est abonné (false). Cet indicateur renvoie false si la propriété serverObject n’est pas null.



Implémentation
    public function get serverObjectDeleted():Boolean

serverObjectReferencedIds

propriété 
serverObjectReferencedIds:Object  [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

Si l’objet serverObject comporte des propriétés contenant lazy="true", un objet stockant les tableaux referencedId de chaque propriété chargée à la demande est renvoyé, en utilisant le nom de propriété comme valeur de clé de recherche.



Implémentation
    public function get serverObjectReferencedIds():Object
Détails de la méthode

acceptClient

()méthode
public function acceptClient():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 à nouveau en file d’attente les modifications locales actuelles et met à jour les valeurs des propriétés, de sorte que l’appel suivant de la méthode DataService.commit() réussisse et que ces modifications remplacent les modifications précédentes.


Exemple  ( Comment utiliser cet exemple )
         private function conflictHandler(event:DataConflictEvent):void
         {
             if (acceptClientCheck.selected)
             {
                  event.conflict.acceptClient();
             }
             else
             {
                  event.conflict.acceptServer();
             }
         }
      

acceptServer

()méthode 
public function acceptServer():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

Supprime la modification locale à l’origine du conflit et applique à l’élément local les valeurs des propriétés présentes dans la propriété Conflict.serverObject.


Exemple  ( Comment utiliser cet exemple )
         private function conflictHandler(event:DataConflictEvent):void
         {
             if (acceptClientCheck.selected)
             {
                  event.conflict.acceptClient();
             }
             else
             {
                  event.conflict.acceptServer();
             }
         }
      

matches

()méthode 
public function matches(otherConflict:Conflict):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

Vérifie si ce conflit décrit le même élément que celui du conflit donné.

Paramètres

otherConflict:Conflict — l’autre objet de conflit à comparer.

Valeur renvoyée
Boolean — true si les deux objets de conflit font référence au même élément géré.

readExternal

()méthode 
public function readExternal(input:IDataInput):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

Paramètres

input:IDataInput

toString

()méthode 
public function toString():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

Renvoie une représentation de chaîne de cet objet de conflit.

Valeur renvoyée
String — Représentation de chaîne de cet objet de conflit.

writeExternal

()méthode 
public function writeExternal(output:IDataOutput):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

Paramètres

output:IDataOutput

Détails de la constante

NONE

Constante
public static const NONE:String = "none"

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

Constante de mode de conflit représentant une détection de zéro conflit.

OBJECT

Constante 
public static const OBJECT:String = "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

Constante de mode de conflit représentant une détection de conflit au niveau de l’objet.

PROPERTY

Constante 
public static const PROPERTY:String = "property"

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

Constante de mode de conflit représentant une détection de conflit au niveau de la propriété.





[ X ]Pourquoi existe-t-il du contenu en anglais ?
Certaines parties du Guide de référence ActionScript 3.0 sont en anglais

Tout le contenu du Guide de référence ActionScript 3.0 n’a pas été traduit dans toutes les langues. Si un élément de langage n’est pas traduit, il s’affiche en anglais. Par exemple, la classe ga.controls.HelpBox n’est traduite dans aucune langue. Ainsi, dans la version française du guide de référence, la classe ga.controls.HelpBox apparaît en anglais.