AbstractOperation

Package	mx.rpc.http
Classe	public class AbstractOperation
Héritage	AbstractOperation AbstractOperation AbstractInvoker EventDispatcher Object
Sous-classes	Operation

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 HTTPService ou 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

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

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

	Propriété		Défini par
		argumentNames : Array Liste ordonnée des noms des arguments à transmettre à un appel de méthode.	AbstractOperation
		arguments : Object Arguments à transmettre à l’opération lorsqu’elle est invoquée.	AbstractOperation
		concurrency : String Valeur indiquant comment traiter plusieurs appels au même service.	AbstractOperation
		constructor : Object Référence à l’objet de classe ou à la fonction constructeur d’une occurrence donnée d’un objet.	Object
		contentType : String Type de contenu des demandes de service.	AbstractOperation
		headers : Object En-têtes HTTP personnalisés à envoyer à l’extrémité tierce.	AbstractOperation
		lastResult : Object [lecture seule] Résultat de la dernière invocation.	AbstractInvoker
		makeObjectsBindable : Boolean Lorsque cette valeur est true, les objets anonymes renvoyés sont forcés sur des objets liables.	AbstractInvoker
		method : String Méthode HTTP d’envoi de la demande.	AbstractOperation
		name : String Nom de cette opération.	AbstractOperation
		operationManager : 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
		properties : 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
		request : Object Objet de paires nom-valeur utilisées en tant que paramètres de l’URL.	AbstractOperation
		requestTimeout : int Fournit un accès au délai d’attente de demande en secondes pour les messages envoyés.	AbstractOperation
		resultElementType : 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 Valeur indiquant comment vous voulez désérialiser le résultat renvoyé par l’appel HTTP.	AbstractOperation
		resultType : Class Spécifie un type de retour facultatif pour l’opération.	AbstractInvoker
		rootURL : String Adresse URL que l’objet HTTPService doit utiliser lorsqu’il calcule les URL relatives.	AbstractOperation
		serializationFilter : 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
		service : AbstractService [lecture seule] Fournit un accès pratique au service sur lequel l’opération est invoquée.	AbstractOperation
		showBusyCursor : Boolean Si true, un curseur occupé s’affiche lors de l’exécution d’un service.	AbstractOperation
		url : String Emplacement du service.	AbstractOperation
		useProxy : Boolean Indique d’utiliser ou non le service proxy Flex.	AbstractOperation
		xmlDecode : Function Fonction ActionScript utilisée pour décoder un résultat de service de XML.	AbstractOperation
		xmlEncode : Function Fonction ActionScript utilisée pour coder une demande de service en tant que XML.	AbstractOperation

Méthodes publiques

Masquer les méthodes publiques héritées

Afficher les méthodes publiques héritées

	Méthode		Défini par
		AbstractOperation(service:AbstractService = null, name:String = null) Crée une nouvelle opération.	AbstractOperation
		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
		cancel(id:String = null):mx.rpc:AsyncToken Annule la dernière invocation de service ou une invocation comportant l’ID spécifié.	AbstractInvoker
		clearResult(fireBindingEvent:Boolean = true):void Définit la propriété result de l’invocateur sur null.	AbstractInvoker
		dispatchEvent(event:Event):Boolean Distribue un événement dans le flux d’événements.	EventDispatcher
		hasEventListener(type:String):Boolean Vérifie si des écouteurs sont enregistrés auprès de l’objet EventDispatcher pour un type spécifique d’événement.	EventDispatcher
		hasOwnProperty(name:String):Boolean Indique si la propriété spécifiée d’un objet est définie.	Object
		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
		propertyIsEnumerable(name:String):Boolean Indique si la propriété spécifiée existe et est énumérable.	Object
		removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void Supprime un écouteur de l’objet EventDispatcher.	EventDispatcher
		send(... args):mx.rpc:AsyncToken Exécute la méthode.	AbstractOperation
		sendBody(parameters:Object):mx.rpc:AsyncToken	AbstractOperation
		setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void Définit la disponibilité d’une propriété dynamique pour les opérations en boucle.	Object
		setResult(result:Object):void Ce crochet est exposé pour mettre à jour la propriété lastResult.	AbstractInvoker
		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
		valueOf():Object Renvoie la valeur primitive de l’objet spécifié.	Object
		willTrigger(type:String):Boolean 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éthode		Défini par
		getHeaders():Object Renvoie les en-têtes de requête HTTP.	AbstractOperation
		getSerializationFilter():SerializationFilter Renvoie le filtre de sérialisation.	AbstractOperation

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
activate	[Evénement de diffusion] Distribué lorsque l’application Flash Player obtient le focus du système d’exploitation et devient active.	EventDispatcher
deactivate	[Evénement de diffusion] Distribué lorsque l’application Flash Player ou AIR perd le focus du système d’exploitation et devient inactive.	EventDispatcher
fault	Distribué lorsqu’une opération échoue.	AbstractOperation
result	Distribué lorsqu’une invocation d’opération réussit.	AbstractOperation

Détails de la propriété

argumentNames

propriété

public var argumentNames:Array

Version du langage:

ActionScript 3.0

Version du produit:

Flex 3

Versions du moteur d’exécution:

Flash Player 9, AIR 1.1

Liste ordonnée des noms des arguments à transmettre à un appel de méthode. L’objet d’argument étant une table de hachage sans ordre garanti, ce tableau aide à rassembler tous les éléments correctement. Il sera automatiquement défini par le compilateur MXML, si nécessaire, lorsque l’opération est utilisée dans un format de balise.

concurrency

propriété

concurrency:String

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 au même 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
public function get concurrency():String
public function set concurrency(value:String):void

contentType

propriété

contentType:String

Version du langage:

ActionScript 3.0

Version du produit:

Flex 3

Versions du moteur d’exécution:

Flash Player 9, AIR 1.1

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
public function get contentType():String
public function set contentType(value:String):void

headers

propriété

public var headers:Object

Version du langage:

ActionScript 3.0

Version du produit:

Flex 3

Versions du moteur d’exécution:

Flash Player 9, AIR 1.1

En-têtes HTTP personnalisés à envoyer à l’extrémité tierce. Si plusieurs en-têtes doivent être envoyés avec le même nom, la valeur doit être spécifiée en tant que tableau.

method

propriété

method:String

Version du langage:

ActionScript 3.0

Version du produit:

Flex 3

Versions du moteur d’exécution:

Flash Player 9, AIR 1.1

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
public function get method():String
public function set method(value:String):void

request

propriété

public var request:Object

Version du langage:

ActionScript 3.0

Version du produit:

Flex 3

Versions du moteur d’exécution:

Flash Player 9, AIR 1.1

Objet de paires nom-valeur utilisées en tant que paramètres de l’URL. Si la propriété contentType est définie sur application/xml, elle doit être un document XML.

requestTimeout

propriété

requestTimeout:int

Version du langage:

ActionScript 3.0

Versions du produit:

BlazeDS 4, Adobe Digital Enterprise Platform Data Services for Java EE 3

Versions du moteur d’exécution:

Flash Player 9, AIR 1.1

Fournit un accès au délai d’attente de demande en secondes pour les messages envoyés. Si, avant expiration du délai, la destination distante ne reçoit pas d’accusé, de réponse ou d’erreur, le message génère une erreur sur le client. Une valeur égale ou inférieure à zéro empêche les délais d’attente de demande.

Implémentation
public function get requestTimeout():int
public function set requestTimeout(value:int):void

resultFormat

propriété

resultFormat:String

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 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
public function get resultFormat():String
public function set resultFormat(value:String):void

rootURL

propriété

rootURL:String

Version du langage:

ActionScript 3.0

Version du produit:

Flex 3

Versions du moteur d’exécution:

Flash Player 9, AIR 1.1

Adresse URL que l’objet HTTPService doit utiliser lorsqu’il calcule les URL relatives. Cette propriété n’est utilisée que si elle traverse le proxy. Lorsque la propriété useProxy est définie sur false, l’adresse URL relative est calculée automatiquement selon l’emplacement du SWF exécutant cette application. Si la propriété rootURL n’est pas définie explicitement, elle est automatiquement définie sur l’adresse URL de mx.messaging.config.LoaderConfig.url.

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

serializationFilter

propriété

public var serializationFilter:SerializationFilter

Version du langage:

ActionScript 3.0

Version du produit:

Flex 3

Versions du moteur d’exécution:

Flash Player 9, AIR 1.1

Un filtre SerializationFilter peut contrôler la manière dont les arguments sont formatés pour former le contenu de la demande HTTP. Elle contrôle aussi la manière dont les résultats sont convertis en objets ActionScript. Elle peut être définie explicitement à l’aide de cette propriété ou indirectement à l’aide de la propriété resultFormat.

showBusyCursor

propriété

showBusyCursor:Boolean

Version du langage:

ActionScript 3.0

Version du produit:

Flex 3

Versions du moteur d’exécution:

Flash Player 9, AIR 1.1

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

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

url

propriété

url:String

Version du langage:

ActionScript 3.0

Version du produit:

Flex 3

Versions du moteur d’exécution:

Flash Player 9, AIR 1.1

Emplacement du service. Si vous spécifiez l’url et une destination non par défaut, votre destination dans le fichier services-config.xml doit autoriser l’URL spécifiée.

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

useProxy

propriété

useProxy:Boolean

Version du langage:

ActionScript 3.0

Version du produit:

Flex 3

Versions du moteur d’exécution:

Flash Player 9, AIR 1.1

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.

La valeur par défaut est false.

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

xmlDecode

propriété

public var xmlDecode:Function

Version du langage:

ActionScript 3.0

Version du produit:

Flex 3

Versions du moteur d’exécution:

Flash Player 9, AIR 1.1

Fonction ActionScript utilisée pour décoder un résultat de service de XML. Lorsque le format resultFormat est un objet et que la propriété xmlDecode est définie, Flex utilise les données XML que le service HTTPService renvoie pour créer un objet. S’il n’est pas défini, le décodeur XMLDecoder par défaut est utilisé pour effectuer l’opération.

La fonction référencée par la propriété xmlDecode doit prendre un objet flash.xml.XMLNode comme paramètre et renvoyer un objet. Elle peut renvoyer n’importe quel type d’objet, mais elle doit renvoyer quelque chose. Renvoyer null ou undefined provoque une erreur.

L’exemple suivant présente une balise <mx:HTTPService> qui spécifie une fonction xmlDecode :

   <mx:HTTPService id="hs" xmlDecode="xmlDecoder" url="myURL" resultFormat="object" contentType="application/xml">
        <mx:request><source/>
            <obj>{RequestObject}</obj>
        </mx:request>
   </mx:HTTPService>

L’exemple suivant présente une fonction xmlDecoder :

function xmlDecoder (myXML)
{
 // Simplified decoding logic.
 var myObj = {};
 myObj.name = myXML.firstChild.nodeValue;
 myObj.honorific = myXML.firstChild.attributes.honorific;
 return myObj;
}

xmlEncode

propriété

public var xmlEncode:Function

Version du langage:

ActionScript 3.0

Version du produit:

Flex 3

Versions du moteur d’exécution:

Flash Player 9, AIR 1.1

Fonction ActionScript utilisée pour coder une demande de service en tant que XML. Lorsque le type contentType d’une demande est application/xml et que l’objet de demande transmis est un objet, Flex tente d’utiliser la fonction spécifiée par la propriété xmlEncode pour le convertir en un objet flash.xml.XMLNode. Si la propriété xmlEncode n’est pas définie, Flex utilise le codeur XMLEncoder par défaut pour convertir le graphique d’objet en un objet flash.xml.XMLNode.

La propriété xmlEncode prend un objet et doit renvoyer un objet flash.xml.XMLNode. Dans ce cas, l’objet XMLNode peut être un objet flash.xml.XML, qui est une sous-classe de XMLNode, ou le premier enfant de l’objet flash.xml.XML, qui est l’élément obtenu d’une balise <mx:XML>. Renvoyer le type d’objet incorrect provoque une erreur. L’exemple suivant présente une balise <mx:HTTPService> qui spécifie une fonction xmlEncode :

  <mx:HTTPService id="hs" xmlEncode="xmlEncoder" url="myURL" resultFormat="object" contentType="application/xml">
        <mx:request><source/>
            <obj>{RequestObject}</obj>
        </mx:request>
   </mx:HTTPService>

L’exemple suivant présente une fonction xmlEncoder :

function xmlEncoder (myObj)
{
  return new XML("");
}

Détails du constructeur

()

Constructeur

public function AbstractOperation(service:AbstractService = 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:AbstractService` (default = `null`) — Objet qui définit le type de service, telles que HTTPMultiService, WebService ou RemoteObject.

	`name:String` (default = `null`) — Nom du service.

Détails de la méthode

getHeaders

()

méthode

protected function getHeaders():Object

Version du langage:

ActionScript 3.0

Version du produit:

Flex 3

Versions du moteur d’exécution:

Flash Player 9, AIR 1.1

Renvoie les en-têtes de requête HTTP. Les sous-classes peuvent remplacer cette méthode pour contrôler la récupération des en-têtes de requête HTTP.

Valeur renvoyée

Object — En-têtes de requête HTTP.

getSerializationFilter

()

méthode

protected function getSerializationFilter():SerializationFilter

Renvoie le filtre de sérialisation. Les sous-classes peuvent remplacer cette méthode pour contrôler la récupération des en-têtes de requête HTTP.

Valeur renvoyée

SerializationFilter — Filtre de sérialisation.

sendBody

()

méthode

public function sendBody(parameters:Object):mx.rpc:AsyncToken

Paramètres

parameters:Object

Valeur renvoyée

mx.rpc:AsyncToken

Informations juridiques | Politique de confidentialité en ligne

AbstractOperation - AS3 Flex

Classes x

argumentNames

concurrency

contentType

headers

method

request

requestTimeout

resultFormat

rootURL

serializationFilter

showBusyCursor

url

useProxy

xmlDecode

xmlEncode