HTTPMultiService

Package	mx.rpc.http
Classe	public dynamic class HTTPMultiService
Héritage	HTTPMultiService AbstractService Proxy
Sous-classes	HTTPMultiService

Version du langage:

ActionScript 3.0

Version du produit:

Flex 3

Versions du moteur d’exécution:

Flash Player 9, AIR 1.1

Utilisez la balise <mx:HTTPMultiService> pour représenter une collection d’opérations HTTP. Chacune comporte une URL, une méthode, des paramètres et un type de retour.

Vous pouvez définir des attributs tels que l’URL et la méthode dans la balise HTTPMultiService de manière à ce qu’ils se comportent comme valeurs par défaut pour les ensembles de valeurs définis pour chaque balise d’opération individuelle. L’URL de la classe HTTPMultiService sert d’URL de base (à savoir, le préfixe) pour toute URL relative définie sur les balises d’opération HTTP. Chaque opération HTTP comporte une méthode send(), qui effectue une demande HTTP auprès de l’URL spécifiée et une réponse HTTP est renvoyée.

Vous pouvez transmettre à l’URL spécifiée des paramètres qui sont utilisés pour placer des données dans la demande HTTP. La propriété contentType spécifie un type mime qui est utilisé pour déterminer le format de données en ligne (à savoir, codage de format HTTP ou XML).

Vous pouvez aussi utiliser un filtre de sérialisation pour implémenter un format resultFormat personnalisé tel que JSON. Lorsque vous n’utilisez pas le service proxy de serveur, vous ne pouvez utiliser que les méthodes HTTP GET ou POST. Toutefois, lorsque vous définissez la propriété useProxy sur true et que vous utilisez le service proxy de serveur, vous pouvez aussi utiliser les méthodes HTTP HEAD, OPTIONS, TRACE et DELETE.

Remarque : contrairement à la classe HTTPService, la classe HTTPMultiService ne définit pas une propriété requête.

Remarque : en raison d’une limitation logicielle, tout comme la classe HTTPService, la classe HTTPMultiService ne génère pas de messages d’erreur conviviaux lorsqu’elle utilise GET et n’utilise pas un proxy.

Propriété MXML par défautoperationList

Eléments de l’API associés

mx.rpc.http.HTTPService

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
		baseURL : String Adresse URL que l’objet HTTPService doit utiliser lorsqu’il calcule les URL relatives.	HTTPMultiService
		channelSet : ChannelSet Fournit un accès à la classe ChannelSet utilisée par le service.	AbstractService
		concurrency : String Valeur indiquant comment traiter plusieurs appels à la même opération du service.	HTTPMultiService
		contentType : String = "application/x-www-form-urlencoded" Type de contenu des demandes de service.	HTTPMultiService
		destination : String Destination du service.	AbstractService
		headers : Object En-têtes HTTP personnalisés à envoyer à l’extrémité tierce.	HTTPMultiService
		makeObjectsBindable : Boolean = true Lorsque la valeur est true, les objets renvoyés prennent en charge la liaison de données aux contrôles d’interface utilisateur.	HTTPMultiService
		managers : Array La propriété managers stocke une liste de gestionnaires de données qui modifient le comportement de ce service.	AbstractService
		method : String = "GET" Méthode HTTP d’envoi de la demande si aucune méthode n’est définie explicitement sur l’opération.	HTTPMultiService
		operationList : Array Cela sert de propriété par défaut pour cette instance, de sorte qu’il est possible de définir un ensemble d’opérations comme enfants directs de la balise HTTPMultiService dans MXML.	HTTPMultiService
		operations : Object En général, le tableau Operations n’est défini que par le compilateur MXML si vous créez un service à l’aide d’une balise MXML.	AbstractService
		requestTimeout : int Fournit un accès au délai d’attente de demande en secondes pour les messages envoyés.	AbstractService
		resultFormat : String Valeur indiquant comment vous voulez désérialiser le résultat renvoyé par l’appel HTTP.	HTTPMultiService
		serializationFilter : SerializationFilter Filtre serializationFilter par défaut utilisé par toutes les opérations qui ne définissent aucun filtre explicitement.	HTTPMultiService
		showBusyCursor : Boolean Si true, un curseur occupé s’affiche lors de l’exécution d’un service.	HTTPMultiService
		useProxy : Boolean Indique d’utiliser ou non le service proxy Flex.	HTTPMultiService

Méthodes publiques

Masquer les méthodes publiques héritées

Afficher les méthodes publiques héritées

	Méthode		Défini par
		HTTPMultiService(baseURL:String = null, destination:String = null) Crée une nouvelle classe HTTPService.	HTTPMultiService
		disconnect():void Déconnecte la connexion réseau du service et supprime les répondeurs de demandes en attente.	AbstractService
		getOperation(name:String):AbstractOperation Renvoie une opération du nom donné.	AbstractService
		initialize():void Appelé pour initialiser le service.	AbstractService
		logout():void Déconnecte l’utilisateur de la destination.	AbstractService
		setCredentials(username:String, password:String, charset:String = null):void Définit les informations d’identification pour la destination à laquelle le service accède lors de l’utilisation des services de données côté serveur.	AbstractService
		setRemoteCredentials(remoteUsername:String, remotePassword:String, charset:String = null):void Nom d’utilisateur et mot de passe à utiliser pour authentifier un utilisateur lors de l’accès à une extrémité distante tierce telle qu’un service Web via un proxy ou un objet distant via un adaptateur personnalisé lors de l’utilisation de services de données côté serveur.	AbstractService

Evénements

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

	Synthèse	Défini par
fault	Distribué lorsqu’un appel HTTPMultiService échoue.	HTTPMultiService
invoke	L’événement invoke est déclenché lorsqu’un appel HTTPMultiService est invoqué à condition qu’une erreur ne soit pas générée avant que le canal ne tente d’envoyer le message.	HTTPMultiService
result	Distribué lorsqu’un appel HTTPMultiService réussit.	HTTPMultiService

Détails de la propriété

baseURL

propriété

public var baseURL: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. Cela contient un préfixe qui est ajouté devant n’importe quelle URL lorsqu’il est défini. Il reçoit la valeur null, auquel cas l’URL du SWF est utilisée pour calculer les URL relatives.

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 à la même opération du service. Le paramètre d’accès simultané défini ici est utilisé pour les opérations qui ne spécifient pas l’accès simultané. Certaines opérations, dont le paramètre d’accès simultané est défini directement, ignoreront la valeur définie ici. 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é

public var contentType:String = "application/x-www-form-urlencoded"

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.

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. Ces en-têtes sont envoyés à toutes les opérations. Vous pouvez aussi définir des en-têtes au niveau de l’opération.

makeObjectsBindable

propriété

public var makeObjectsBindable:Boolean = true

Version du langage:

ActionScript 3.0

Version du produit:

Flex 3

Versions du moteur d’exécution:

Flash Player 9, AIR 1.1

Lorsque la valeur est true, les objets renvoyés prennent en charge la liaison de données aux contrôles d’interface utilisateur. Cela signifie qu’ils envoyent des événements PropertyChangeEvents lorsque les valeurs de leurs propriétés sont modifiées. Il s’agit de la valeur par défaut pour toute opération dont la propriété makeObjectsBindable n’est pas définie explicitement.

method

propriété

public var method:String = "GET"

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 si aucune méthode n’est définie explicitement sur l’opération. 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.

operationList

propriété

operationList:Array

Version du langage:

ActionScript 3.0

Version du produit:

Flex 3

Versions du moteur d’exécution:

Flash Player 9, AIR 1.1

Cela sert de propriété par défaut pour cette instance, de sorte qu’il est possible de définir un ensemble d’opérations comme enfants directs de la balise HTTPMultiService dans MXML.

Implémentation
public function get operationList():Array
public function set operationList(value:Array):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

serializationFilter

propriété

public var serializationFilter:SerializationFilter

Filtre serializationFilter par défaut utilisé par toutes les opérations qui ne définissent aucun filtre explicitement.

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

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

Détails du constructeur

()

Constructeur

public function HTTPMultiService(baseURL:String = null, destination:String = null)

Version du langage:

ActionScript 3.0

Version du produit:

Flex 3

Versions du moteur d’exécution:

Flash Player 9, AIR 1.1

Crée une nouvelle classe HTTPService. Si vous vous attendez à ce que le service effectue l’envoi à l’aide d’URL relatives, vous pouvez spécifier l’URL baseURL allant servir de base pour déterminer l’URL entière (par exemple, Application.application.url).

Paramètres

	`baseURL:String` (default = `null`) — Adresse URL que la classe HTTPService doit utiliser lorsqu’elle calcule des adresses URL relatives.

	`destination:String` (default = `null`)

Détails de l’événement

fault

Evénement

Type d’objet d’événement: mx.rpc.events.FaultEvent
propriété FaultEvent.type = mx.rpc.events.FaultEvent.FAULT

Version du langage:

ActionScript 3.0

Version du produit:

Flex 3

Versions du moteur d’exécution:

Flash Player 9, AIR 1.1

Distribué lorsqu’un appel HTTPMultiService échoue.

Type d’é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 d’erreur contenant les détails relatifs à l’élément ayant provoqué l’événement.
`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`.
`token`	Jeton représentant l’appel à la méthode. Utilisé dans le modèle de jeton d’achèvement asynchrone.

invoke

Evénement

Type d’objet d’événement: mx.rpc.events.InvokeEvent
propriété InvokeEvent.type = mx.rpc.events.InvokeEvent.INVOKE

Version du langage:

ActionScript 3.0

Version du produit:

Flex 3

Versions du moteur d’exécution:

Flash Player 9, AIR 1.1

L’événement invoke est déclenché lorsqu’un appel HTTPMultiService est invoqué à condition qu’une erreur ne soit pas générée avant que le canal ne tente d’envoyer le message.

Type d’événement INVOKE.

Les valeurs des propriétés de l’objet d’événement sont les suivantes :

Propriété	Valeur
`bubbles`	false
`token`	Jeton représentant l’appel individuel à la méthode. Utilisé dans le modèle de jeton d’achèvement asynchrone.
`cancelable`	true
`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 de demande 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

Evénement

Type d’objet d’événement: mx.rpc.events.ResultEvent
propriété ResultEvent.type = mx.rpc.events.ResultEvent.RESULT

Version du langage:

ActionScript 3.0

Version du produit:

Flex 3

Versions du moteur d’exécution:

Flash Player 9, AIR 1.1

Distribué lorsqu’un appel HTTPMultiService réussit.

Type d’événement RESULT.

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.

Informations juridiques | Politique de confidentialité en ligne

HTTPMultiService - AS3 Flex

Packagesx

Eléments du langage

Annexes

Package mx.rpc.http

baseURL

concurrency

contentType

headers

makeObjectsBindable

method

operationList

resultFormat

serializationFilter

showBusyCursor

useProxy