| 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 |
<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
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éthode | Défini par | ||
|---|---|---|---|
Crée une nouvelle classe HTTPService. | HTTPMultiService | ||
|
Déconnecte la connexion réseau du service et supprime les répondeurs de demandes en attente. | AbstractService | |
|
Renvoie une opération du nom donné. | AbstractService | |
|
Appelé pour initialiser le service. | AbstractService | |
|
Déconnecte l’utilisateur de la destination. | AbstractService | |
|
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 | |
|
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énement | Synthèse | Défini par | ||
|---|---|---|---|---|
| Distribué lorsqu’un appel HTTPMultiService échoue. | HTTPMultiService | |||
| 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 | |||
| Distribué lorsqu’un appel HTTPMultiService réussit. | HTTPMultiService | |||
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 :
multipleLes 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.singleUne seule demande à la fois est autorisée sur l’opération ; les demandes multiples génèrent une erreur.lastEffectuer une demande annule toute demande existante.
Implémentation
public function get concurrency():String public function set concurrency(value:String):voidcontentType | 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):voidresultFormat | 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 :
objectLa 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.arrayLa 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.xmlLa valeur renvoyée est XML et est renvoyée en tant qu’XML littéral dans un objet ActionScript XMLnode.flashvarsLa valeur renvoyée constitue du texte contenant des paires nom=valeur séparées par une esperluette, analysée en un objet ActionScript.textLa valeur renvoyée constitue du texte et est située dans une colonne gauche.e4xLa 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):voidserializationFilter | propriété |
public var serializationFilter:SerializationFilterFiltre 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):voiduseProxy | 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):voidHTTPMultiService | () | 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).
baseURL:String (default = null) | |
destination:String (default = null) |
fault | Evénement |
mx.rpc.events.FaultEventproprié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 |
mx.rpc.events.InvokeEventproprié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 |
mx.rpc.events.ResultEventproprié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. |
Tue Jun 12 2018, 09:30 AM Z