HTTPService

Package	mx.rpc.http.mxml
Classe	public class HTTPService
Héritage	HTTPService HTTPService AbstractInvoker EventDispatcher Object
Implémente	IMXMLSupport, IMXMLObject

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:HTTPService> pour représenter un objet HTTPService dans un fichier MXML. Lorsque vous appelez la méthode 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.

Syntaxe MXML expanded

Masquer la syntaxe MXML

The <mx:HTTPService> tag accepts the following tag attributes:

 <mx:HTTPService
 Properties
 concurrency="multiple|single|last"
 contentType="application/x-www-form-urlencoded|application/xml"
 destination="DefaultHTTP"
 id="No default."
 method="GET|POST|HEAD|OPTIONS|PUT|TRACE|DELETE"
 resultFormat="object|array|xml|e4x|flashvars|text"
 showBusyCursor="false|true"
 makeObjectsBindable="false|true"
 url="No default."
 useProxy="false|true"
 xmlEncode="No default."
 xmlDecode="No default."
 
 Events
 fault="No default."
 result="No default."
 />

The <mx:HTTPService> tag can have a single <mx:request> tag under which the parameters can be specified.

Consulter les exemples

Eléments de l’API associés

mx.rpc.http.HTTPService
mx.validators.Validator
mx.managers.CursorManager

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
		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éthodes publiques

Masquer les méthodes publiques héritées

Afficher les méthodes publiques héritées

	Méthode		Défini par
		HTTPService(rootURL:String = null, destination:String = null) 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
		cancel(id:String = null):mx.rpc:AsyncToken [override] Annule la dernière invocation de service ou une invocation comportant l’ID spécifié.	HTTPService
		clearResult(fireBindingEvent:Boolean = true):void [override] Définit la propriété result de l’invocateur sur null.	HTTPService
		disconnect():void Interrompt la connexion réseau du service.	HTTPService
		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
		initialized(document:Object, id:String):void Appelé une fois que l’objet d’implémentation a été créé et que toutes les propriétés de composants spécifiées sur la balise MXML ont été initialisées.	HTTPService
		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
		logout():void Déconnecte l’utilisateur de la destination.	HTTPService
		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(parameters:Object = null):mx.rpc:AsyncToken Exécute une demande HTTPService.	HTTPService
		setCredentials(username:String, password:String, charset:String = null):void Définit les informations d’identification pour la destination à laquelle le service accède.	HTTPService
		setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void Définit la disponibilité d’une propriété dynamique pour les opérations en boucle.	Object
		setRemoteCredentials(remoteUsername:String, remotePassword:String, charset:String = null):void Nom d’utilisateur et mot de passe utilisés pour authentifier un utilisateur lors de l’accès à l’URL HTTP.	HTTPService
		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

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’un appel HTTPService échoue.	HTTPService
invoke	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
result	Distribué lorsqu’un appel HTTPService réussit.	HTTPService

Constantes publiques

Masquer les constantes publiques héritées

Afficher les constantes publiques héritées

	Constante		Défini par

Détails du constructeur

()

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. Ce constructeur est généralement appelé par le code généré d’un document MXML. Vous utilisez en général la classe mx.rpc.http.HTTPService pour créer une classe HTTPService dans ActionScript.

Paramètres

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

	`destination:String` (default = `null`) — Nom de destination HTTPService dans le fichier service-config.xml file.

Détails de la méthode

initialized

()

méthode

public function initialized(document:Object, id:String):void

Version du langage:

ActionScript 3.0

Version du produit:

Flex 3

Versions du moteur d’exécution:

Flash Player 9, AIR 1.1

Appelé une fois que l’objet d’implémentation a été créé et que toutes les propriétés de composants spécifiées sur la balise MXML ont été initialisées. Si vous créez cette classe dans ActionScript et voulez qu’elle fonctionne avec la validation, vous devez appeler cette méthode et transmettre l’id du document MXML et de la classe HTTPService.

Paramètres

	`document:Object` — Document MXML ayant créé cet objet.

	`id:String` — Identifiant utilisé par le `document` pour se référer à cet objet. Si l’objet est une propriété profonde dans le document, la valeur `id` est null.

Exemples Comment utiliser cet exemple

HTTPServiceExample.mxml

<?xml version="1.0" encoding="utf-8"?>
<!-- Simple example to demonstrate the HTTPService tag. -->
<s:Application xmlns:fx="http://ns.adobe.com/mxml/2009" 
     xmlns:s="library://ns.adobe.com/flex/spark" 
     xmlns:mx="library://ns.adobe.com/flex/mx"
    creationComplete="feedRequest.send();">
        
        <!-- The url property specifies the location of the requested file, 
        in this case the RSS 2.0 feed of Matt Chotin's blog. 
        As of this writing, the URL was still valid, but you should 
        check to make sure it hasn't changed. 
        You should use the latest RSS 2.0 URL listed on the right side of 
        the blog at http://www.adobe.com/go/mchotinblog. -->
        
    
    <fx:Declarations>
        <mx:HTTPService 
            id="feedRequest" 
            url="http://weblogs.macromedia.com/mchotin/index.xml" 
            useProxy="false" />
    </fx:Declarations>
        
    <mx:Panel title="HTTPService Example" height="75%" width="75%" 
        paddingTop="10" paddingBottom="10" paddingLeft="10" paddingRight="10">
            
        <mx:DataGrid id="dgPosts" height="50%" width="75%" 
            dataProvider="{feedRequest.lastResult.rss.channel.item}">
            <mx:columns>
                <mx:DataGridColumn headerText="Posts" dataField="title"/>
                <mx:DataGridColumn headerText="Date" dataField="pubDate"/>
            </mx:columns>
        </mx:DataGrid>
            
        <mx:TextArea height="50%" width="75%" htmlText="{dgPosts.selectedItem.description}"/>
    </mx:Panel>    
</s:Application>

Informations juridiques | Politique de confidentialité en ligne

HTTPService - AS3 Flex

Classes x

HTTPService

initialized