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.rpc.http 

Operation  - AS3 Flex

Packagemx.rpc.http
Classepublic class Operation
HéritageOperation Inheritance AbstractOperation Inheritance AbstractOperation Inheritance AbstractInvoker Inheritance EventDispatcher Inheritance Object

Version du langage: ActionScript 3.0
Version du produit: Flex 3
Versions du moteur d’exécution: Flash Player 9, AIR 1.1

Opération utilisée spécifiquement par une classe HTTPMultiService. Une classe Operation est une opération individuelle sur un service correspondant généralement à une seule opération côté serveur. Une opération peut être appelée en invoquant la fonction du même nom sur le service ou en accédant à l’opération en tant que propriété sur le service et en appelant la méthode send(param1, param2). Le service HTTP prend aussi en charge une méthode sendBody qui vous permet de spécifier directement le corps de la réponse HTTP. Si vous utilisez la méthode send(param1, param2), le corps est généralement formé en combinant la propriété argumentNames de l’opération avec les paramètres envoyés. Un objet est créé qui utilise argumentNames[i] comme clé et le paramètre correspondant comme valeur.

La méthode exacte par laquelle les arguments d’opération HTTP sont placés dans le corps HTTP est déterminée par le filtre SerializationFilter utilisé.



Propriétés publiques
 PropriétéDéfini par
 InheritedargumentNames : Array
Liste ordonnée des noms des arguments à transmettre à un appel de méthode.
AbstractOperation
 Inheritedarguments : Object
Arguments à transmettre à l’opération lorsqu’elle est invoquée.
AbstractOperation
  concurrency : String
[override] Valeur indiquant comment traiter plusieurs appels à la même opération de service.
Operation
 Inheritedconstructor : Object
Référence à l’objet de classe ou à la fonction constructeur d’une occurrence donnée d’un objet.
Object
  contentType : String
[override] Type de contenu des demandes de service.
Operation
 Inheritedheaders : Object
En-têtes HTTP personnalisés à envoyer à l’extrémité tierce.
AbstractOperation
 InheritedlastResult : Object
[lecture seule] Résultat de la dernière invocation.
AbstractInvoker
  makeObjectsBindable : Boolean
[override] Lorsque cette valeur est true, les objets anonymes renvoyés sont forcés sur des objets liables.
Operation
  method : String
[override] Méthode HTTP d’envoi de la demande.
Operation
 Inheritedname : String
Nom de cette opération.
AbstractOperation
 InheritedoperationManager : Function
Cette propriété est généralement définie par le code de structure qui désire modifier le comportement d’une invocation de service sans modifier la manière dont le service est appelé en externe.
AbstractInvoker
 Inheritedproperties : Object
Il s’agit d’un crochet permettant essentiellement aux développeurs de structures d’enregistrer d’autres propriétés spécifiées par l’utilisateur pour votre opération.
AbstractOperation
 Inheritedrequest : Object
Objet de paires nom-valeur utilisées en tant que paramètres de l’URL.
AbstractOperation
 InheritedrequestTimeout : int
Fournit un accès au délai d’attente de demande en secondes pour les messages envoyés.
AbstractOperation
 InheritedresultElementType : Class
Comme resultType, utilisé pour définir la classe ActionScript utilisée par une opération donnée, bien que cette propriété ne s’applique qu’aux opérations qui renvoient un résultat à plusieurs valeurs (par exemple,
AbstractInvoker
  resultFormat : String
[override] Valeur indiquant comment vous voulez désérialiser le résultat renvoyé par l’appel HTTP.
Operation
 InheritedresultType : Class
Spécifie un type de retour facultatif pour l’opération.
AbstractInvoker
  rootURL : String
[override] L’URL rootURL est utilisée pour calculer l’URL d’une opération de service HTTP lorsqu’une URL relative est spécifiée pour l’opération.
Operation
 InheritedserializationFilter : SerializationFilter
Un filtre SerializationFilter peut contrôler la manière dont les arguments sont formatés pour former le contenu de la demande HTTP.
AbstractOperation
 Inheritedservice : AbstractService
[lecture seule] Fournit un accès pratique au service sur lequel l’opération est invoquée.
AbstractOperation
  showBusyCursor : Boolean
[override] Si true, un curseur occupé s’affiche lors de l’exécution d’un service.
Operation
 Inheritedurl : String
Emplacement du service.
AbstractOperation
  useProxy : Boolean
[override] Indique d’utiliser ou non le service proxy Flex.
Operation
 InheritedxmlDecode : Function
Fonction ActionScript utilisée pour décoder un résultat de service de XML.
AbstractOperation
 InheritedxmlEncode : Function
Fonction ActionScript utilisée pour coder une demande de service en tant que XML.
AbstractOperation
Méthodes publiques
 MéthodeDéfini par
  
Operation(service:mx.rpc.http:HTTPMultiService = null, name:String = null)
Crée une nouvelle opération.
Operation
 Inherited
addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
Enregistre un objet écouteur d’événement auprès d’un objet EventDispatcher afin que l’écouteur soit averti d’un événement.
EventDispatcher
 Inherited
Annule la dernière invocation de service ou une invocation comportant l’ID spécifié.
AbstractInvoker
 Inherited
clearResult(fireBindingEvent:Boolean = true):void
Définit la propriété result de l’invocateur sur null.
AbstractInvoker
 Inherited
Distribue un événement dans le flux d’événements.
EventDispatcher
 Inherited
Vérifie si des écouteurs sont enregistrés auprès de l’objet EventDispatcher pour un type spécifique d’événement.
EventDispatcher
 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
 Inherited
Indique si la propriété spécifiée existe et est énumérable.
Object
 Inherited
removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void
Supprime un écouteur de l’objet EventDispatcher.
EventDispatcher
  
[override] Exécute l’opération HTTP.
Operation
 Inherited
AbstractOperation
 Inherited
Définit la disponibilité d’une propriété dynamique pour les opérations en boucle.
Object
 Inherited
Ce crochet est exposé pour mettre à jour la propriété lastResult.
AbstractInvoker
 Inherited
Renvoie la représentation de chaîne de cet objet, formatée selon les paramètres régionaux en vigueur.
Object
 Inherited
Renvoie la représentation sous forme de chaîne de l’objet spécifié.
Object
 Inherited
Renvoie la valeur primitive de l’objet spécifié.
Object
 Inherited
Vérifie si un écouteur d’événement est enregistré auprès de cet objet EventDispatcher ou de ses ancêtres pour le type d’événement spécifié.
EventDispatcher
Méthodes protégées
 MéthodeDéfini par
 Inherited
Renvoie les en-têtes de requête HTTP.
AbstractOperation
 Inherited
Renvoie le filtre de sérialisation.
AbstractOperation
Evénements
 Evénement Synthèse Défini par
 Inherited[Evénement de diffusion] Distribué lorsque l’application Flash Player obtient le focus du système d’exploitation et devient active.EventDispatcher
 Inherited[Evénement de diffusion] Distribué lorsque l’application Flash Player ou AIR perd le focus du système d’exploitation et devient inactive.EventDispatcher
 InheritedDistribué lorsqu’une opération échoue.AbstractOperation
 InheritedDistribué lorsqu’une invocation d’opération réussit.AbstractOperation
Détails de la propriété

concurrency

propriété
concurrency:String[override]

Version du langage: ActionScript 3.0
Version du produit: Flex 3
Versions du moteur d’exécution: Flash Player 9, AIR 1.1

Valeur indiquant comment traiter plusieurs appels à la même opération de service. La valeur par défaut est multiple. Les valeurs suivantes sont autorisées :

  • multiple Les demandes existantes ne sont pas annulées et il incombe au développeur de vérifier la cohérence des données renvoyées en gérant avec soin le flux d’événements. Il s’agit de la valeur par défaut.
  • single Une seule demande à la fois est autorisée sur l’opération ; les demandes multiples génèrent une erreur.
  • last Effectuer une demande annule toute demande existante.



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

contentType

propriété 
contentType:String[override]

Type de contenu des demandes de service. La valeur par défaut est application/x-www-form-urlencoded, qui envoie des demandes comme un envoi HTTP POST normal avec des paires nom-valeur. application/xml envoie les demandes en tant qu’XML.



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

makeObjectsBindable

propriété 
makeObjectsBindable:Boolean[override]

Version du langage: ActionScript 3.0
Version du produit: Flex 3
Versions du moteur d’exécution: Flash Player 9, AIR 1.1

Lorsque cette valeur est true, les objets anonymes renvoyés sont forcés sur des objets liables.



Implémentation
    override public function get makeObjectsBindable():Boolean
    override public function set makeObjectsBindable(value:Boolean):void

method

propriété 
method:String[override]

Méthode HTTP d’envoi de la demande. Les valeurs autorisées sont GET, POST, HEAD, OPTIONS, PUT, TRACE et DELETE. Les lettres minuscules sont converties en lettres majuscules. La valeur par défaut est GET.



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

resultFormat

propriété 
resultFormat:String[override]

Valeur indiquant comment vous voulez désérialiser le résultat renvoyé par l’appel HTTP. La valeur de cette propriété est basée sur les éléments suivants :

  • Si vous renvoyez ou non des données XML ou des paires nom-valeur.
  • La manière dont vous voulez accéder aux résultats ; vous pouvez accéder aux résultats en tant qu’objet, texte ou XML.

La valeur par défaut est object. Les valeurs suivantes sont autorisées :

  • object La valeur renvoyée est XML mais est analysée en tant qu’arborescence d’objets ActionScript. Il s’agit de la valeur par défaut.
  • array La valeur renvoyée est XML et est analysée en tant qu’arborescence d’objets ActionScript. Cependant, si l’objet de niveau supérieur n’est pas un tableau, un nouveau tableau est créé et le résultat est défini comme constituant le premier élément. Si makeObjectsBindable est true, le tableau est enveloppé dans une classe ArrayCollection.
  • xml La valeur renvoyée est XML et est renvoyée en tant qu’XML littéral dans un objet ActionScript XMLnode.
  • flashvars La valeur renvoyée constitue du texte contenant des paires nom=valeur séparées par une esperluette, analysée en un objet ActionScript.
  • text La valeur renvoyée constitue du texte et est située dans une colonne gauche.
  • e4x La valeur renvoyée constitue des données XML et est renvoyée en tant qu’XML littéral dans un objet XML ActionScript, accessible via des expressions ECMAScript pour XML (E4X).



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

rootURL

propriété 
rootURL:String[override]

Version du langage: ActionScript 3.0
Version du produit: Flex 3
Versions du moteur d’exécution: Flash Player 9, AIR 1.1

L’URL rootURL est utilisée pour calculer l’URL d’une opération de service HTTP lorsqu’une URL relative est spécifiée pour l’opération. Le nom de répertoire de l’URL rootURL est ajouté devant les URL relatives pour l’opération. Il est généralement plus pratique de définir l’URL baseURL car elle spécifie directement le nom du répertoire tandis que l’URL rootURL spécifie le nom d’un fichier dont le nom de répertoire est ajouté. Si ni l’URL rootURL ni l’URL baseURL ne sont définies explicitement, le nom de répertoire du fichier .swf est ajouté devant les chemins relatifs.



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

showBusyCursor

propriété 
showBusyCursor:Boolean[override]

Si true, un curseur occupé s’affiche lors de l’exécution d’un service. La valeur par défaut est false.



Implémentation
    override public function get showBusyCursor():Boolean
    override public function set showBusyCursor(value:Boolean):void

useProxy

propriété 
useProxy:Boolean[override]

Indique d’utiliser ou non le service proxy Flex. La valeur par défaut est false. Si vous ne spécifiez pas true pour les requêtes proxy via le serveur Flex, assurez-vous que Flash Player peut accéder à l’URL cible. Vous ne pouvez pas non plus utiliser les destinations définies dans le fichier services-config.xml si la propriété useProxy est définie sur false.



Implémentation
    override public function get useProxy():Boolean
    override public function set useProxy(value:Boolean):void
Détails du constructeur

Operation

()Constructeur
public function Operation(service:mx.rpc.http:HTTPMultiService = null, name:String = null)

Version du langage: ActionScript 3.0
Version du produit: Flex 3 Creates a new Operation.
Versions du moteur d’exécution: Flash Player 9, AIR 1.1

Crée une nouvelle opération.

Paramètres
service:mx.rpc.http:HTTPMultiService (default = null) — Objet HTTPMultiService définissant le service.
 
name:String (default = null) — Nom du service.
Détails de la méthode

send

()méthode
override public function send(... args):mx.rpc:AsyncToken

Version du langage: ActionScript 3.0
Version du produit: Flex 3
Versions du moteur d’exécution: Flash Player 9, AIR 1.1

Exécute l’opération HTTP. Les arguments transmis le sont dans le cadre de l’appel d’opération. Si aucun argument n’est transmis, la propriété d’arguments de classe est utilisée comme source de paramètres. Les opérations HTTP utilisent généralement des paramètres nommés, et non pas des paramètres de position. Pour fournir les noms de ces paramètres, vous pouvez aussi définir la propriété argumentNames sur un tableau des noms de propriétés.

Paramètres

... args — Arguments facultatifs transmis dans le cadre de l’appel de méthode. Si aucun argument n’est transmis, l’objet d’argument est utilisé comme source de paramètres.

Valeur renvoyée
mx.rpc:AsyncToken — Appel AsyncToken utilisant le modèle de jeton d’achèvement asynchrone. Le même objet est disponible dans les événements result et fault de la propriété token.




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