HTTPService

Paket	mx.rpc.http.mxml
Klasse	public class HTTPService
Vererbung	HTTPService HTTPService AbstractInvoker EventDispatcher Object
Implementiert	IMXMLSupport, IMXMLObject

Sprachversion:

ActionScript 3.0

Produktversion:

Flex 3

Laufzeitversionen:

Flash Player 9, AIR 1.1

Verwenden Sie das <mx:HTTPService>-Tag, um ein HTTPService-Objekt in einer MXML-Datei darzustellen. Wenn Sie die send()-Methode des HTTPService-Objekts aufrufen, sendet diese eine HTTP-Anforderung an die angegebene URL, worauf eine HTTP-Antwort zurückgegeben wird. Optional können Sie der angegebenen URL auch Parameter übergeben. Wenn Sie nicht den serverbasierten Proxy-Dienst verwenden, stehen Ihnen nur HTTP GET- oder HTTP POST-Methoden zur Verfügung. Wenn Sie jedoch die useProxy-Eigenschaft auf „true“ setzen, und den serverbasierten Proxy-Dienst verwenden, können Sie auch die HTTP HEAD-, -OPTIONS-, -TRACE- und -DELETE-Methoden verwenden.

Hinweis: Aufgrund einer Softwarelimitierung generiert der HTTPService bei Verwendung von GET keine benutzerfreundlichen Fehlermeldungen.

MXML-Syntax expanded

MXML-Syntax ausblenden

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.

Beispiele anzeigen

Verwandte API-Elemente

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

Öffentliche Eigenschaften

Vererbte öffentliche Eigenschaften ausblenden

Vererbte öffentliche Eigenschaften anzeigen

	Eigenschaft		Definiert von
		channelSet : ChannelSet Gibt Zugriff auf den vom Dienst verwendeten ChannelSet.	HTTPService
		concurrency : String Wert, der angibt, wie mehrere Aufrufe desselben Dienstes verarbeitet werden sollen.	HTTPService
		constructor : Object Ein Verweis auf das Klassenobjekt oder die Konstruktorfunktion für eine angegebene Objektinstanz.	Object
		contentType : String Art des Inhalts für Dienstanforderungen.	HTTPService
		destination : String Ein HTTPService-Zielname in der services-config.xml-Datei.	HTTPService
		headers : Object Benutzerdefinierte HTTP-Header, die an Endpunkte von Drittparteien gesendet werden sollen.	HTTPService
		lastResult : Object [override] [schreibgeschützt] Das Ergebnis des letzten Aufrufs.	HTTPService
		makeObjectsBindable : Boolean [override] Wenn dieser Wert true ist, wird die Umwandlung zurückgegebener anonymer Objekte in bindbare Objekte erzwungen.	HTTPService
		method : String HTTP-Methode zum Senden der Anforderung.	HTTPService
		operationManager : Function Diese Eigenschaft wird in der Regel vom Frameworkcode gesetzt, der das Verhalten eines Dienstaufrufs modifizieren will, damit der Dienst extern aufgerufen wird.	AbstractInvoker
		request : Object Objekt aus Namen-/Wertpaaren, die als Parameter der URL verwendet werden.	HTTPService
		requestTimeout : int Gibt Zugriff auf die Zeitüberschreitung der Anforderung für übermittelte Meldungen.	HTTPService
		resultElementType : Class Wie resultType; wird zum Definieren der ActionScript-Klasse verwendet, die von einem bestimmen Vorgang benutzt wird. Jedoch wird diese Eigenschaft nur auf Vorgänge angewandt, die ein mehrwertiges Ergebnis zurückgeben (z. B.	AbstractInvoker
		resultFormat : String Wert, der angibt, wie die Serialisierung des vom HTTP-Aufruf zurückgegebene Ergebnisses aufgehoben werden soll.	HTTPService
		resultType : Class Gibt einen optionalen Rückgabetyp für den Vorgang an.	AbstractInvoker
		rootURL : String Die URL, die der HTTPService bei der Berechnung relativer URLs verwenden soll.	HTTPService
		serializationFilter : SerializationFilter Stellt einen Adapter bereit, der die Umwandlung des Hauptteils der HTTP-Antwort in ActionScript-Objekte und/oder der Parameter bzw. des Hauptteils in contentType, URL und Post-Body der HTTP-Anforderung steuert.	HTTPService
		showBusyCursor : Boolean Wenn die Einstellung „true“ ist, wird ein Aktivitäten-Cursor angezeigt, während ein Dienst ausgeführt wird.	HTTPService
		url : String Position des Dienstes.	HTTPService
		useProxy : Boolean Gibt an, ob der Flex-Proxy-Dienst verwendet werden soll.	HTTPService
		xmlDecode : Function ActionScript-Funktion, die zum Dekodieren eines Dienstergebnisses aus XML verwendet wird.	HTTPService
		xmlEncode : Function ActionScript-Funktion, die zum Dekodieren einer Dienstanforderung als XML verwendet wird.	HTTPService

Öffentliche Methoden

Vererbte öffentliche Methoden ausblenden

Vererbte öffentliche Methoden anzeigen

	Methode		Definiert von
		HTTPService(rootURL:String = null, destination:String = null) Erstellt einen neuen HTTPService.	HTTPService
		addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void Registriert ein Ereignis-Listener-Objekt bei einem EventDispatcher-Objekt, sodass der Listener über ein Ereignis benachrichtigt wird.	EventDispatcher
		cancel(id:String = null):mx.rpc:AsyncToken [override] Bricht den letzten Dienstaufruf oder einen Aufruf mit der angegebenen ID ab.	HTTPService
		clearResult(fireBindingEvent:Boolean = true):void [override] Setzt die Ergebniseigenschaft der aufrufenden Instanz auf null.	HTTPService
		disconnect():void Trennt die Netzverbindung des Dienstes.	HTTPService
		dispatchEvent(event:Event):Boolean Sendet ein Ereignis in den Ereignisablauf.	EventDispatcher
		hasEventListener(type:String):Boolean Überprüft, ob das EventDispatcher-Objekt Listener für einen bestimmten Ereignistyp registriert hat.	EventDispatcher
		hasOwnProperty(name:String):Boolean Gibt an, ob für ein Objekt eine bestimmte Eigenschaft definiert wurde.	Object
		initialized(document:Object, id:String):void Wird aufgerufen, nachdem das Implementierungsobjekt erstellt und sämtliche im MXML-Tag angegebenen Komponenteneigenschaften initialisiert wurden.	HTTPService
		isPrototypeOf(theClass:Object):Boolean Gibt an, ob eine Instanz der Object-Klasse in der Prototypkette des Objekts vorhanden ist, das als Parameter angegeben wurde.	Object
		logout():void Meldet den Benutzer vom Ziel ab.	HTTPService
		propertyIsEnumerable(name:String):Boolean Gibt an, ob die angegebene Eigenschaft vorhanden ist und durchlaufen werden kann.	Object
		removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void Entfernt einen Listener aus dem EventDispatcher-Objekt.	EventDispatcher
		send(parameters:Object = null):mx.rpc:AsyncToken Führt eine HTTPService-Anforderung aus.	HTTPService
		setCredentials(username:String, password:String, charset:String = null):void Setzt die Benutzerdaten für das Ziel, auf das über den Dienst zugegriffen wird.	HTTPService
		setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void Legt die Verfügbarkeit einer dynamischen Eigenschaft für Schleifenoperationen fest.	Object
		setRemoteCredentials(remoteUsername:String, remotePassword:String, charset:String = null):void Der Benutzername und das Kennwort für die Authentifizierung eines Benutzers für den Zugriff auf die HTTP-URL.	HTTPService
		setResult(result:Object):void Dieser Hook ist stellt die Aktualisierung der lastResult-Eigenschaft bereit.	AbstractInvoker
		toLocaleString():String Gibt die Stringdarstellung dieses Objekts zurück, formatiert entsprechend den Konventionen des Gebietsschemas.	Object
		toString():String Gibt das angegebene Objekt als String zurück.	Object
		valueOf():Object Gibt den Grundwert des angegebenen Objekts zurück.	Object
		willTrigger(type:String):Boolean Überprüft, ob bei diesem EventDispatcher-Objekt oder bei einem seiner Vorgänger ein Ereignis-Listener für einen bestimmten Ereignistyp registriert ist.	EventDispatcher

Ereignisse

Klicken Sie, um weitere Informationen zu Ereignissen zu erhalten.

Vererbte Ereignisse ausblenden

Vererbte Ereignisse anzeigen

	Übersicht	Definiert von
activate	[broadcast event] Wird ausgelöst, wenn Flash Player oder eine AIR-Anwendung den Betriebssystemfokus erhält und aktiv wird.	EventDispatcher
deactivate	[broadcast event] Wird ausgelöst, wenn Flash Player- oder die AIR-Anwendung den Fokus verliert und inaktiv wird.	EventDispatcher
fault	Wird ausgelöst, wenn ein HTTPService-Aufruf fehlschlägt.	HTTPService
invoke	Das Aufrufereignis wird durch einen HTTPService-Aufruf ausgelöst, es sei denn, es wird ein Fehler ausgelöst, bevor der Kanal versucht, die Meldung zu senden.	HTTPService
result	Wird ausgelöst, wenn ein HTTPService-Aufruf erfolgreich zurückgegeben wird.	HTTPService

Öffentliche Konstanten

Vererbte öffentliche Konstanten ausblenden

Vererbte öffentliche Konstanten anzeigen

	Konstante		Definiert von

Konstruktordetails

()

Konstruktor

public function HTTPService(rootURL:String = null, destination:String = null)

Sprachversion:

ActionScript 3.0

Produktversion:

Flex 3

Laufzeitversionen:

Flash Player 9, AIR 1.1

Erstellt einen neuen HTTPService. Dieser Konstruktor wird normalerweise vom generierten Code eines XML-Dokuments aufgerufen. Die mx.rpc.http.HTTPService-Klasse wird normalerweise zur Erstellung eines HTTPService in ActionScript verwendet.

Parameter

	`rootURL:String` (default = `null`) — Die URL, die der HTTPService bei der Berechnung relativer URLs verwenden soll.

	`destination:String` (default = `null`) — Ein HTTPService-Zielname in der service-config.xml-Datei.

Methodendetails

initialized

()

Methode

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

Sprachversion:

ActionScript 3.0

Produktversion:

Flex 3

Laufzeitversionen:

Flash Player 9, AIR 1.1

Wird aufgerufen, nachdem das Implementierungsobjekt erstellt und sämtliche im MXML-Tag angegebenen Komponenteneigenschaften initialisiert wurden. Wenn Sie diese Klasse in ActionScript erstellen und sie mit der Überprüfung funktionieren soll, müssen Sie diese Methode aufrufen und das MXML-Dokument und die id des HTTPService übergeben.

Parameter

	`document:Object` — Das MXML-Dokument, das dieses Objekt erstellt hat.

	`id:String` — Der von `document` für den Verweis auf dieses Objekt verwendete Bezeichner. Ist das Objekt eine verschachtelte Eigenschaft des Dokuments, nimmt`id` den Wert Null an.

Beispiele Verwendung dieses Beispiels

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>

Rechtliche Hinweise | Onlinedatenschutzerklärung

HTTPService - AS3 Flex

Paketex

Sprachelemente

Anhänge

Paket mx.rpc.http.mxml

HTTPService

initialized