| Package | mx.rpc.http |
| Classe | public class HTTPService |
| Héritage | HTTPService  AbstractInvoker EventDispatcher Object |
| Sous-classes | HTTPService |
| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 3 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
send() de l’objet HTTPService, elle effectue une demande HTTP auprès de l’URL spécifiée et une réponse HTTP est renvoyée. Si vous le souhaitez, vous pouvez transmettre des paramètres à l’URL spécifiée. 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 : en raison d’une limitation logicielle, la classe HTTPService ne génère pas de messages d’erreur conviviaux lorsqu’elle utilise GET.
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 | ||
|---|---|---|---|
| channelSet : ChannelSet
Fournit un accès à la classe ChannelSet utilisée par le service. | HTTPService | ||
| concurrency : String
Valeur indiquant comment traiter plusieurs appels au même service. | HTTPService | ||
 | 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. | HTTPService | ||
| destination : String
Nom de destination HTTPService dans le fichier services-config.xml. | HTTPService | ||
| headers : Object
En-têtes HTTP personnalisés à envoyer à l’extrémité tierce. | HTTPService | ||
| lastResult : Object [override] [lecture seule]
Résultat de la dernière invocation. | HTTPService | ||
| makeObjectsBindable : Boolean [override]
Lorsque cette valeur est true, les objets anonymes renvoyés sont forcés sur des objets liables. | HTTPService | ||
| method : String
Méthode HTTP d’envoi de la demande. | HTTPService | ||
| 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 | |
| request : Object
Objet de paires nom-valeur utilisées en tant que paramètres de l’URL. | HTTPService | ||
| requestTimeout : int
Fournit un accès au délai d’attente de demande en secondes pour les messages envoyés. | HTTPService | ||
| 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. | HTTPService | ||
| 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. | HTTPService | ||
| serializationFilter : SerializationFilter
Fournit un adaptateur qui contrôle le processus de conversion du corps de la réponse HTTP en objets ActionScript et/ou de conversion des paramètres ou du corps vers le type contentType, l’URL et le corps de publication de la demande HTTP. | HTTPService | ||
| showBusyCursor : Boolean
Si true, un curseur occupé s’affiche lors de l’exécution d’un service. | HTTPService | ||
| url : String
Emplacement du service. | HTTPService | ||
| useProxy : Boolean
Indique d’utiliser ou non le service proxy Flex. | HTTPService | ||
| xmlDecode : Function
Fonction ActionScript utilisée pour décoder un résultat de service de XML. | HTTPService | ||
| xmlEncode : Function
Fonction ActionScript utilisée pour coder une demande de service en tant que XML. | HTTPService | ||
| Méthode | Défini par | ||
|---|---|---|---|
Crée une nouvelle classe HTTPService. | HTTPService | ||
| 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 | |
[override]
Annule la dernière invocation de service ou une invocation comportant l’ID spécifié. | HTTPService | ||
[override]
Définit la propriété result de l’invocateur sur null. | HTTPService | ||
Interrompt la connexion réseau du service. | HTTPService | ||
|
Distribue un événement dans le flux d’événements. | EventDispatcher | |
|
Vérifie si des écouteurs sont enregistrés auprès de l’objet EventDispatcher pour un type spécifique d’événement. | EventDispatcher | |
|
Indique si la propriété spécifiée d’un objet est définie. | Object | |
|
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 | |
Déconnecte l’utilisateur de la destination. | HTTPService | ||
|
Indique si la propriété spécifiée existe et est énumérable. | Object | |
|
Supprime un écouteur de l’objet EventDispatcher. | EventDispatcher | |
Exécute une demande HTTPService. | HTTPService | ||
Définit les informations d’identification pour la destination à laquelle le service accède. | HTTPService | ||
|
Définit la disponibilité d’une propriété dynamique pour les opérations en boucle. | Object | |
Nom d’utilisateur et mot de passe utilisés pour authentifier un utilisateur lors de l’accès à l’URL HTTP. | HTTPService | ||
|
Ce crochet est exposé pour mettre à jour la propriété lastResult. | AbstractInvoker | |
|
Renvoie la représentation de chaîne de cet objet, formatée selon les paramètres régionaux en vigueur. | Object | |
|
Renvoie la représentation sous forme de chaîne de l’objet spécifié. | Object | |
|
Renvoie la valeur primitive de l’objet spécifié. | Object | |
|
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 | |
| Evénement | Synthèse | Défini par | ||
|---|---|---|---|---|
| [Evénement de diffusion] Distribué lorsque l’application Flash Player obtient le focus du système d’exploitation et devient active. | EventDispatcher | ||
| [Evénement de diffusion] Distribué lorsque l’application Flash Player ou AIR perd le focus du système d’exploitation et devient inactive. | EventDispatcher | ||
| Distribué lorsqu’un appel HTTPService échoue. | HTTPService | |||
| L’événement invoke est déclenché lorsqu’un appel HTTPService est invoqué à condition qu’une erreur ne soit pas générée avant que le canal ne tente d’envoyer le message. | HTTPService | |||
| Distribué lorsqu’un appel HTTPService réussit. | HTTPService | |||
| Constante | Défini par | ||
|---|---|---|---|
| CONTENT_TYPE_FORM : String = "application/x-www-form-urlencoded" [statique]
Indique que les données envoyées par le service HTTP sont codées au format application/x-www-form-urlencoded. | HTTPService | ||
| CONTENT_TYPE_XML : String = "application/xml" [statique]
Indique que les données envoyées par le service HTTP sont codées au format application/xml. | HTTPService | ||
| DEFAULT_DESTINATION_HTTP : String = "DefaultHTTP" [statique]
Indique que l’objet HTTPService utilise la destination DefaultHTTP. | HTTPService | ||
| DEFAULT_DESTINATION_HTTPS : String = "DefaultHTTPS" [statique]
Indique que l’objet HTTPService utilise la destination DefaultHTTP. | HTTPService | ||
| ERROR_DECODING : String = "Client.CouldNotDecode" [statique]
Indique qu’un résultat formaté XML n’a pas pu être analysé en une instance XML ou décodé en un objet. | HTTPService | ||
| ERROR_ENCODING : String = "Client.CouldNotEncode" [statique]
Indique qu’un paramètre d’entrée n’a pas pu être codé en tant qu’XML. | HTTPService | ||
| ERROR_URL_REQUIRED : String = "Client.URLRequired" [statique]
Indique que la propriété useProxy a été définie sur false mais qu’aucune URL n’a été fournie. | HTTPService | ||
| RESULT_FORMAT_ARRAY : String = "array" [statique]
Le format de résultat « array » est similaire à « object », mais la valeur renvoyée est toujours un tableau, de sorte que si le résultat renvoyé du format de résultat « object » n’est pas déjà un tableau, l’élément est ajouté à un nouveau tableau comme étant le premier élément. | HTTPService | ||
| RESULT_FORMAT_E4X : String = "e4x" [statique]
Le format de résultat « e4x » spécifie que la valeur renvoyée est une instance XML, qui est accessible à l’aide d’expressions ECMAScript pour XML (E4X). | HTTPService | ||
| RESULT_FORMAT_FLASHVARS : String = "flashvars" [statique]
Le format de résultat « flashvars » spécifie que la valeur renvoyée constitue du texte contenant des paires nom=valeur séparées par une esperluette, analysée en un objet ActionScript. | HTTPService | ||
| RESULT_FORMAT_OBJECT : String = "object" [statique]
Le format de résultat « object » spécifie que la valeur renvoyée est XML mais est analysée en tant qu’arborescence d’objets ActionScript. | HTTPService | ||
| RESULT_FORMAT_TEXT : String = "text" [statique]
Le format de résultat « text » spécifie que le texte de résultat HTTPService doit être une chaîne non traitée. | HTTPService | ||
| RESULT_FORMAT_XML : String = "xml" [statique]
Le format de résultat « xml » spécifie que les résultats doivent être renvoyés en tant qu’instance flash.xml.XMLNode pointant vers le premier enfant du document flash.xml.XMLDocument parent. | HTTPService | ||
channelSet | propriété |
channelSet:ChannelSet| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 3 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Permet d’accéder à l’instance ChannelSet utilisée par le service. La classe ChannelSet peut être manuellement construite et assignée, ou elle sera dynamiquement créée afin d’utiliser les canaux configurés pour la destination de ce service.
Implémentation
public function get channelSet():ChannelSet public function set channelSet(value:ChannelSet):voidconcurrency | 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 :
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é |
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):voiddestination | propriété |
destination:String| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 3 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Nom de destination HTTPService dans le fichier services-config.xml. Si la destination n’est pas spécifiée, Flex utilise la destination DefaultHTTP. Si vous utilisez la propriété url mais voulez que les demandes atteignent le proxy via HTTPS, spécifiez DefaultHTTPS.
Implémentation
public function get destination():String public function set destination(value:String):voidheaders | propriété |
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.
Implémentation
public function get headers():Object public function set headers(value:Object):voidlastResult | propriété |
lastResult:Object [lecture seule] [override] | Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 3 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Résultat de la dernière invocation.
Cette propriété peut être utilisée comme source de la liaison de données. Lorsque cette propriété est modifiée, elle distribue l’événement resultForBinding .
Implémentation
override public function get lastResult():ObjectmakeObjectsBindable | 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):voidmethod | 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):voidrequest | propriété |
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.
Implémentation
public function get request():Object public function set request(value:Object):voidrequestTimeout | propriété |
requestTimeout:int| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 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. 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):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):voidrootURL | 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):voidserializationFilter | propriété |
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 |
Fournit un adaptateur qui contrôle le processus de conversion du corps de la réponse HTTP en objets ActionScript et/ou de conversion des paramètres ou du corps vers le type contentType, l’URL et le corps de publication de la demande HTTP. Cela peut aussi être défini indirectement en définissant le format resultFormat en enregistrant un filtre SerializationFilter à l’aide de la méthode statique : SerializationFilter.registerFilterForResultFormat("formatName", filter)
Implémentation
public function get serializationFilter():SerializationFilter public function set serializationFilter(value:SerializationFilter):voidshowBusyCursor | 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):voidurl | 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):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):voidxmlDecode | propriété |
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.
<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;
}
Implémentation
public function get xmlDecode():Function public function set xmlDecode(value:Function):voidxmlEncode | propriété |
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("");
}
Implémentation
public function get xmlEncode():Function public function set xmlEncode(value:Function):voidHTTPService | () | Constructeur |
public function HTTPService(rootURL: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 rootURL allant servir de base pour déterminer l’URL entière (par exemple, Application.application.url).
rootURL:String (default = null) | |
destination:String (default = null) |
cancel | () | méthode |
override public function cancel(id:String = null):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 |
Annule la dernière invocation de service ou une invocation comportant l’ID spécifié. Même s’il se peut que l’opération de réseau se poursuive, aucun événement de résultat ou d’erreur n’est distribué.
Paramètres
id:String (default = null) |
mx.rpc:AsyncToken — Classe AsyncToken associée à l’appel qui est annulé ou null si aucun appel n’a été annulé.
|
clearResult | () | méthode |
override public function clearResult(fireBindingEvent:Boolean = true):void| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 3 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Définit la propriété result de l’invocateur sur null. Cela est utile lorsque le résultat est un objet de grande taille qui n’est plus utilisé.
Paramètres
fireBindingEvent:Boolean (default = true)true si vous voulez que les éléments liés aux résultats soient mis à jour. Dans le cas contraire, défini sur false. La valeur par défaut est true
|
disconnect | () | méthode |
public function disconnect():void| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 3 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Interrompt la connexion réseau du service. Cette méthode n’attend pas que les opérations de réseau en attente se terminent.
logout | () | méthode |
public function logout():void| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 3 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Déconnecte l’utilisateur de la destination. La déconnexion d’une destination s’applique à tous les éléments connectés à l’aide du même canal tel que spécifié dans la configuration de serveur. Par exemple, si vous êtes connecté via le canal my-rtmp et que vous vous déconnectez à l’aide de l’un de vos composants RPC, tous les éléments qui étaient connectés via my-rtmp sont déconnectés.
Remarque : Adobe vous recommande d’utiliser la méthode mx.messaging.ChannelSet.logout() au lieu de cette méthode.
Eléments de l’API associés
send | () | méthode |
public function send(parameters:Object = null):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 une demande HTTPService. Les paramètres sont facultatifs, mais s’ils sont spécifiés, ils doivent être un objet contenant des paires nom-valeur ou un objet XML, selon la valeur contentType.
Paramètres
parameters:Object (default = null) |
mx.rpc:AsyncToken — Objet représentant le modèle de jeton d’achèvement asynchrone. Il s’agit du même objet disponible dans la propriété token de l’événement result ou fault.
|
setCredentials | () | méthode |
public function setCredentials(username:String, password:String, charset:String = null):void| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 3 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Définit les informations d’identification pour la destination à laquelle le service accède. Les informations d’identification sont appliquées à tous les services connectés via la même classe ChannelSet. Les services utilisant un proxy sur une destination distante devront appeler la méthode setRemoteCredentials() à la place.
Paramètres
username:String — Nom d’utilisateur pour la destination.
| |
password:String — Mot de passe pour la destination.
| |
charset:String (default = null) |
setRemoteCredentials | () | méthode |
public function setRemoteCredentials(remoteUsername:String, remotePassword:String, charset:String = null):void| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 3 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Nom d’utilisateur et mot de passe utilisés pour authentifier un utilisateur lors de l’accès à l’URL HTTP. Ces données sont transmises dans le cadre de l’en-tête d’autorisation HTTP du proxy vers l’extrémité. Si la propriété useProxy est définie sur false, cette propriété est ignorée.
Paramètres
remoteUsername:String — Nom d’utilisateur à transmettre à l’extrémité distante.
| |
remotePassword:String — Mot de passe à transmettre à l’extrémité distante.
| |
charset: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 HTTPService é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 HTTPService 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 HTTPService 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. |
CONTENT_TYPE_FORM | Constante |
public static const CONTENT_TYPE_FORM:String = "application/x-www-form-urlencoded"| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 3 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Indique que les données envoyées par le service HTTP sont codées au format application/x-www-form-urlencoded.
CONTENT_TYPE_XML | Constante |
public static const CONTENT_TYPE_XML:String = "application/xml"| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 3 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Indique que les données envoyées par le service HTTP sont codées au format application/xml.
DEFAULT_DESTINATION_HTTP | Constante |
public static const DEFAULT_DESTINATION_HTTP:String = "DefaultHTTP"| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 3 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Indique que l’objet HTTPService utilise la destination DefaultHTTP.
DEFAULT_DESTINATION_HTTPS | Constante |
public static const DEFAULT_DESTINATION_HTTPS:String = "DefaultHTTPS"| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 3 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Indique que l’objet HTTPService utilise la destination DefaultHTTP.
ERROR_DECODING | Constante |
public static const ERROR_DECODING:String = "Client.CouldNotDecode"| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 3 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Indique qu’un résultat formaté XML n’a pas pu être analysé en une instance XML ou décodé en un objet.
ERROR_ENCODING | Constante |
public static const ERROR_ENCODING:String = "Client.CouldNotEncode"| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 3 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Indique qu’un paramètre d’entrée n’a pas pu être codé en tant qu’XML.
ERROR_URL_REQUIRED | Constante |
public static const ERROR_URL_REQUIRED:String = "Client.URLRequired"| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 3 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Indique que la propriété useProxy a été définie sur false mais qu’aucune URL n’a été fournie.
RESULT_FORMAT_ARRAY | Constante |
public static const RESULT_FORMAT_ARRAY:String = "array"| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 3 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Le format de résultat « array » est similaire à « object », mais la valeur renvoyée est toujours un tableau, de sorte que si le résultat renvoyé du format de résultat « object » n’est pas déjà un tableau, l’élément est ajouté à un nouveau tableau comme étant le premier élément.
RESULT_FORMAT_E4X | Constante |
public static const RESULT_FORMAT_E4X:String = "e4x"| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 3 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Le format de résultat « e4x » spécifie que la valeur renvoyée est une instance XML, qui est accessible à l’aide d’expressions ECMAScript pour XML (E4X).
RESULT_FORMAT_FLASHVARS | Constante |
public static const RESULT_FORMAT_FLASHVARS:String = "flashvars"| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 3 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Le format de résultat « flashvars » spécifie que la valeur renvoyée constitue du texte contenant des paires nom=valeur séparées par une esperluette, analysée en un objet ActionScript.
RESULT_FORMAT_OBJECT | Constante |
public static const RESULT_FORMAT_OBJECT:String = "object"| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 3 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Le format de résultat « object » spécifie que 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.
RESULT_FORMAT_TEXT | Constante |
public static const RESULT_FORMAT_TEXT:String = "text"| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 3 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Le format de résultat « text » spécifie que le texte de résultat HTTPService doit être une chaîne non traitée.
RESULT_FORMAT_XML | Constante |
public static const RESULT_FORMAT_XML:String = "xml"| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 3 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Le format de résultat « xml » spécifie que les résultats doivent être renvoyés en tant qu’instance flash.xml.XMLNode pointant vers le premier enfant du document flash.xml.XMLDocument parent.
Tue Jun 12 2018, 09:30 AM Z