| Paket | mx.rpc.http |
| Klasse | public dynamic class HTTPMultiService |
| Vererbung | HTTPMultiService  AbstractService Proxy |
| Unterklassen | HTTPMultiService |
| Sprachversion: | ActionScript 3.0 |
| Produktversion: | Flex 3 |
| Laufzeitversionen: | Flash Player 9, AIR 1.1 |
<mx:HTTPMultiService>-Tag wird für die Darstellung einer Gruppe von http-Vorgängen verwendet. Jedes hat eine URL, eine Methode, Parameter und einen Rückgabetyp.
Sie können Attribute, wie URL und Methode für das HTTPMultiService-Tag festlegen, die als Standardeinstellungen für Werte der einzelnen Vorgangs-Tags gesetzt werden. Die URL des HTTPMultiService dient als Basis-URL (d. h. Präfix) für alle relativen URL, die in den HTTP-Vorgangs-Tags gesetzt werden. Jeder HTTP-Vorgang hat eine send()-Methode, die eine HTTP-Anforderung an die angegebene URL sendet, worauf eine HTTP-Antwort erfolgt.
Sie können der angegebenen URL Parameter übergeben, mit deren Hilfe Daten in die HTTP-Anforderung eingegeben werden. Die contentType-Eigenschaft gibt einen MIME-Type zur Bestimmung des Datenformats für die Datensendung (z. B. HTTP-Kodierung oder XML) an.
Sie können auch einen Serialisierungsfilter verwenden, um ein personalisiertes resultFormat, wie zum Beispiel JSON zu implementieren. 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: Im Unterschied zur HTTPService-Klasse definiert die HTTPMultiService-Klasse keine request-Eigenschaft.
Hinweis: Aufgrund einer Softwareeinschränkung wie bei HTTPService generiert der HTTPMultiService keine benutzerfreundlichen Fehlermeldungen, wenn Sie GET ohne einen Proxy verwenden.
Standard-MXML-EigenschaftoperationList
Verwandte API-Elemente
Vererbte öffentliche Eigenschaften ausblenden
Vererbte öffentliche Eigenschaften anzeigen| Eigenschaft | Definiert von | ||
|---|---|---|---|
| baseURL : String
Die URL, die der HTTPService bei der Berechnung relativer URLs verwenden soll. | HTTPMultiService | ||
 | channelSet : ChannelSet
Gibt Zugriff auf den vom Dienst verwendeten ChannelSet. | AbstractService | |
| concurrency : String
Wert, der angibt, wie mehrere Aufrufe derselben Methode innerhalb des Dienstes verarbeitet werden sollen. | HTTPMultiService | ||
| contentType : String = "application/x-www-form-urlencoded"
Art des Inhalts für Dienstanforderungen. | HTTPMultiService | ||
| destination : String
Das Ziel des Dienstes. | AbstractService | |
| headers : Object
Benutzerdefinierte HTTP-Header, die an Endpunkte von Drittparteien gesendet werden sollen. | HTTPMultiService | ||
| makeObjectsBindable : Boolean = true
Wenn „true“, unterstützen die zurückgegebenen Objekte Datenbindung für Benutzeroberflächensteuereleme. | HTTPMultiService | ||
| managers : Array
In der Managereigenschaft wird eine Liste der Datenmanager gespeichert, die das Verhalten dieses Dienstes modifizieren. | AbstractService | |
| method : String = "GET"
HTTP-Methode zum Senden der Anforderung, wenn eine Methode nicht ausdrücklich im Vorgang eingestellt ist. | HTTPMultiService | ||
| operationList : Array
Dies ist die Standardeigenschaft dieser Instanz; auf diese Weise können Sie einen Satz von Vorgängen als direkt dem HTTPMultiService-Tag in MXMXL untergeordnete Elemente definieren. | HTTPMultiService | ||
| operations : Object
Das Array von Vorgängen wird in der Regel nur vom MXML-Compiler gesetzt, wenn Sie einen Dienst mithilfe eines MXML-Tags erstellen. | AbstractService | |
| requestTimeout : int
Gibt Zugriff auf die Zeitüberschreitung der Anforderung für übermittelte Meldungen. | AbstractService | |
| resultFormat : String
Wert, der angibt, wie die Serialisierung des vom HTTP-Aufruf zurückgegebene Ergebnisses aufgehoben werden soll. | HTTPMultiService | ||
| serializationFilter : SerializationFilter Standardmäßige serializationFilter, der von allen Vorgängen verwendet wird, die keinen Filter ausdrücklich einstellen | HTTPMultiService | ||
| showBusyCursor : Boolean
Wenn die Einstellung „true“ ist, wird ein Aktivitäten-Cursor angezeigt, während ein Dienst ausgeführt wird. | HTTPMultiService | ||
| useProxy : Boolean
Gibt an, ob der Flex-Proxy-Dienst verwendet werden soll. | HTTPMultiService | ||
| Methode | Definiert von | ||
|---|---|---|---|
Erstellt einen neuen HTTPService. | HTTPMultiService | ||
|
Trennt die Netzverbindung des Dienstes und entfernt sämtliche anstehende Anforderungsresponder. | AbstractService | |
|
Gibt einen Vorgang mit dem jeweiligen Namen zurück. | AbstractService | |
|
Aufgerufen, um den Dienst zu initialisieren. | AbstractService | |
|
Meldet den Benutzer vom Ziel ab. | AbstractService | |
|
Setzt die Benutzerdaten für den Zielpfad, auf den über den Dienst zugegriffen wird, wenn serverseitige Datendienste verwendet werden. | AbstractService | |
|
Der Benutzername und das Kennwort für die Authentifizierung eines Benutzers beim Zugriff auf einen Remoteendpunkt einer Drittpartei wie zum Beispiel ein Webdienst über einen Proxy oder ein Remoteobjekt über einen benutzerdefinierten Adapter, wenn serverseitige Datendienste verwendet werden. | AbstractService | |
| Ereignis | Übersicht | Definiert von | ||
|---|---|---|---|---|
| Wird ausgelöst, wenn ein HTTPMultiService-Aufruf fehlschlägt. | HTTPMultiService | |||
| Das Aufrufereignis wird durch einen HTTPMultiService-Aufruf ausgelöst, es sei denn, es wird ein Fehler ausgegeben, bevor der Kanal versucht, die Meldung zu senden. | HTTPMultiService | |||
| Wird ausgelöst, wenn ein HTTPMultiService-Aufruf erfolgreich zurückgegeben wird. | HTTPMultiService | |||
baseURL | Eigenschaft |
public var baseURL:String| Sprachversion: | ActionScript 3.0 |
| Produktversion: | Flex 3 |
| Laufzeitversionen: | Flash Player 9, AIR 1.1 |
Die URL, die der HTTPService bei der Berechnung relativer URLs verwenden soll. Diese URL enthält ein Präfix, das jeder URL bei ihrer Einstellung vorangestellt wird. Die Standardeinstellung ist „null“, wenn die URL für SWF zur Verarbeitung relativer URLs verwendet wird.
concurrency | Eigenschaft |
concurrency:String| Sprachversion: | ActionScript 3.0 |
| Produktversion: | Flex 3 |
| Laufzeitversionen: | Flash Player 9, AIR 1.1 |
Wert, der angibt, wie mehrere Aufrufe derselben Methode innerhalb des Dienstes verarbeitet werden sollen. Die hier vorgenommene Einstellung für gleichzeitige Vorgänge wird für Methoden verwendet, die keine Gleichzeitigkeit festlegen. Einzelne Methoden, deren Gleichzeitigkeitseinstellung unmittelbar erfolgt, ignorieren den hier festgelegten Wert. Der Standardwert lautet multiple. Folgende Werte sind zulässig:
multipleExistierende Anforderungen werden nicht abgebrochen; der Entwickler muss für die Konsistenz der zurückgegebenen Daten sorgen, indem er den Ereignis-Stream sorgfältig verwaltet. Dies ist der Standardwert.singleEs ist jeweils nur eine einzelne Anforderung für den Vorgang zulässig; mehrere Anforderungen lösen einen Fehler aus.lastJede Anforderung bewirkt, dass alle bereits existierenden Anforderungen abgebrochen werden.
Implementierung
public function get concurrency():String public function set concurrency(value:String):voidcontentType | Eigenschaft |
public var contentType:String = "application/x-www-form-urlencoded"
Art des Inhalts für Dienstanforderungen. Die Standardeinstellung ist application/x-www-form-urlencoded, wobei Anforderungen als normale HTTP POST mit Namen-/Wertpaaren übermittelt werden. application/xml übermittelt Anforderungen als XML.
headers | Eigenschaft |
public var headers:Object| Sprachversion: | ActionScript 3.0 |
| Produktversion: | Flex 3 |
| Laufzeitversionen: | Flash Player 9, AIR 1.1 |
Benutzerdefinierte HTTP-Header, die an Endpunkte von Drittparteien gesendet werden sollen. Wenn mehrere Header mit demselben Namen übermittelt werden sollen, muss der Wert als Array definiert werden. Diese Header werden sämtlichen Vorgängen übermittelt. Sie können Header auch auf Vorgangsebene einstellen.
makeObjectsBindable | Eigenschaft |
public var makeObjectsBindable:Boolean = true| Sprachversion: | ActionScript 3.0 |
| Produktversion: | Flex 3 |
| Laufzeitversionen: | Flash Player 9, AIR 1.1 |
Wenn true, unterstützen die zurückgegebenen Objekte Datenbindung für Benutzeroberflächensteuereleme. Das bedeutet, dass sie PropertyChangeEvents senden, wenn ihre Eigenschaftswerte geändert werden. Dies ist der Standardwert für sämtliche Vorgänge, deren makeObjectsBindable-Eigenschaft nicht ausdrücklich eingestellt wurde.
method | Eigenschaft |
public var method:String = "GET"| Sprachversion: | ActionScript 3.0 |
| Produktversion: | Flex 3 |
| Laufzeitversionen: | Flash Player 9, AIR 1.1 |
HTTP-Methode zum Senden der Anforderung, wenn eine Methode nicht ausdrücklich im Vorgang eingestellt ist. Zulässige Werte sind GET, POST, HEAD, OPTIONS, PUT, TRACE und DELETE. Kleinbuchstaben werden in Großbuchstaben umgewandelt. Der Standardwert ist GET.
operationList | Eigenschaft |
operationList:Array| Sprachversion: | ActionScript 3.0 |
| Produktversion: | Flex 3 |
| Laufzeitversionen: | Flash Player 9, AIR 1.1 |
Dies ist die Standardeigenschaft dieser Instanz; auf diese Weise können Sie einen Satz von Vorgängen als direkt dem HTTPMultiService-Tag in MXMXL untergeordnete Elemente definieren.
Implementierung
public function get operationList():Array public function set operationList(value:Array):voidresultFormat | Eigenschaft |
resultFormat:String| Sprachversion: | ActionScript 3.0 |
| Produktversion: | Flex 3 |
| Laufzeitversionen: | Flash Player 9, AIR 1.1 |
Wert, der angibt, wie die Serialisierung des vom HTTP-Aufruf zurückgegebene Ergebnisses aufgehoben werden soll. Der Wert hängt von folgenden Optionen ab:
- Ob Sie XML oder Namen-/Wertpaare zurückgeben.
- Wie Sie auf Ergebnisse zugreifen möchten: als Objekt, Text oder XML.
Der Standardwert ist object. Folgende Werte sind zulässig:
objectDer zurückgegebene Wert ist XML und wird als Baum von ActionScript-Objekten geparst. Dies ist die Standardeinstellung.arrayDer zurückgegebene Wert ist XML und wird als Baum von ActionScript-Objekten geparst. Wenn jedoch das Objekt auf der höchsten Ebene kein Array ist, wird ein neues Array erstellt, dessen erstes Element das Ergebnis ist. Wenn makeObjectsBindable auf „true“ eingestellt ist, wird das Array in eine ArrayCollection eingebunden.xmlDer zurückgegebene Wert ist XML und wird als literal XML in einem ActionScriptXMLnode-Objekt geparst.flashvarsDer zurückgegebene Wert ist Text mit durch Und-Zeichen getrennten Name-/Wertpaaren, der in ein ActionScript-Objekt geparst wird.textDer zurückgegebene Wert ist Text und wird unformatiert gelassen.e4xDer zurückgegebene Wert ist XML und wird als Literal XML in einem ActionScript-XML-Objekt zurückgegeben, auf das mit ECMAScript für XML (E4X) zugegriffen werden kann.
Implementierung
public function get resultFormat():String public function set resultFormat(value:String):voidserializationFilter | Eigenschaft |
public var serializationFilter:SerializationFilterStandardmäßige serializationFilter, der von allen Vorgängen verwendet wird, die keinen Filter ausdrücklich einstellen
showBusyCursor | Eigenschaft |
showBusyCursor:Boolean| Sprachversion: | ActionScript 3.0 |
| Produktversion: | Flex 3 |
| Laufzeitversionen: | Flash Player 9, AIR 1.1 |
Wenn die Einstellung true ist, wird ein Aktivitäten-Cursor angezeigt, während ein Dienst ausgeführt wird. Der Standardwert ist false.
Implementierung
public function get showBusyCursor():Boolean public function set showBusyCursor(value:Boolean):voiduseProxy | Eigenschaft |
useProxy:Boolean| Sprachversion: | ActionScript 3.0 |
| Produktversion: | Flex 3 |
| Laufzeitversionen: | Flash Player 9, AIR 1.1 |
Gibt an, ob der Flex-Proxy-Dienst verwendet werden soll. Der Standardwert ist false. Wenn Sie nicht true für Proxy-Anforderungen über den Flex-Server angeben, müssen Sie sicherstellen, dass der Player die Ziel-URL erreichen kann. Sie können auch keine in der services-config.xml-Datei definierten Ziele verwenden, wenn die useProxy-Eigenschaft auf false eingestellt ist.
Der Standardwert ist false.
Implementierung
public function get useProxy():Boolean public function set useProxy(value:Boolean):voidHTTPMultiService | () | Konstruktor |
public function HTTPMultiService(baseURL:String = null, destination:String = null)| Sprachversion: | ActionScript 3.0 |
| Produktversion: | Flex 3 |
| Laufzeitversionen: | Flash Player 9, AIR 1.1 |
Erstellt einen neuen HTTPService. Wenn Sie möchten, dass der Dienst beim Senden die relativen URLs verwendet, müssen Sie die baseURL angeben, anhand derer die vollständige URL ermittelt wird (z. B.:Application.application.urgl).
baseURL:String (default = null) | |
destination:String (default = null) |
fault | Ereignis |
mx.rpc.events.FaultEventEigenschaft FaultEvent.type =
mx.rpc.events.FaultEvent.FAULT| Sprachversion: | ActionScript 3.0 |
| Produktversion: | Flex 3 |
| Laufzeitversionen: | Flash Player 9, AIR 1.1 |
Wird ausgelöst, wenn ein HTTPMultiService-Aufruf fehlschlägt.
Der FAULT-Ereignistyp.Die Eigenschaften des Ereignisobjekts haben die folgenden Werte:
| Eigenschaft | Wert |
|---|---|
bubbles | false |
cancelable | „true“; durch Aufrufen von „preventDefault()“ von der responder.fault-Methode des verknüpften Tokens wird das Auslösen dieses Ereignisses durch den Dienst oder den Vorgang verhindert. |
currentTarget | Das Objekt, das den Ereignis-Listener definiert, der das Ereignis übernimmt. Wenn Sie beispielsweise myButton.addEventListener() zur Registrierung eines Ereignis-Listeners verwenden, weist currentTarget den Wert „myButton“ auf. |
fault | Das Fault-Objekt, das die Details über den Auslöser dieses Ereignisses enthält. |
message | Die mit diesem Ereignis verknüpfte Meldung. |
target | Das Objekt, von dem das Ereignis ausgelöst wurde. Dies ist nicht immer das Objekt, das auf das Ereignis wartet. Verwenden Sie die currentTarget-Eigenschaft, damit immer auf das Objekt, das auf das Ereignis wartet, zugegriffen wird. |
token | Das Token, das den Aufruf der Methode darstellt. Wird im asynchronen Abschluss-Token-Muster verwendet. |
invoke | Ereignis |
mx.rpc.events.InvokeEventEigenschaft InvokeEvent.type =
mx.rpc.events.InvokeEvent.INVOKE| Sprachversion: | ActionScript 3.0 |
| Produktversion: | Flex 3 |
| Laufzeitversionen: | Flash Player 9, AIR 1.1 |
Das Aufrufereignis wird durch einen HTTPMultiService-Aufruf ausgelöst, es sei denn, es wird ein Fehler ausgegeben, bevor der Kanal versucht, die Meldung zu senden.
Der INVOKE-Ereignistyp.Die Eigenschaften des Ereignisobjekts haben die folgenden Werte:
| Eigenschaft | Wert |
|---|---|
bubbles | false |
token | Token, das den einzelnen Aufruf der Methode darstellt. Wird im asynchronen Abschluss-Token-Muster verwendet. |
cancelable | true |
currentTarget | Das Objekt, das den Ereignis-Listener definiert, der das Ereignis übernimmt. Wenn Sie beispielsweise myButton.addEventListener() zur Registrierung eines Ereignis-Listeners verwenden, weist currentTarget den Wert „myButton“ auf. |
message | Die mit diesem Ereignis verknüpfte Anforderungsmeldung. |
target | Das Objekt, von dem das Ereignis ausgelöst wurde. Dies ist nicht immer das Objekt, das auf das Ereignis wartet. Verwenden Sie die currentTarget-Eigenschaft, damit immer auf das Objekt, das auf das Ereignis wartet, zugegriffen wird. |
result | Ereignis |
mx.rpc.events.ResultEventEigenschaft ResultEvent.type =
mx.rpc.events.ResultEvent.RESULT| Sprachversion: | ActionScript 3.0 |
| Produktversion: | Flex 3 |
| Laufzeitversionen: | Flash Player 9, AIR 1.1 |
Wird ausgelöst, wenn ein HTTPMultiService-Aufruf erfolgreich zurückgegeben wird.
Der RESULT-Ereignistyp.Die Eigenschaften des Ereignisobjekts haben die folgenden Werte:
| Eigenschaft | Wert |
|---|---|
bubbles | false |
cancelable | true, preventDefault() aus der verknüpften responder.result-Methode des Token verhindert, dass der Dienst oder der Vorgang dieses Ereignis auslöst. |
currentTarget | Das Objekt, das den Ereignis-Listener definiert, der das Ereignis übernimmt. Wenn Sie beispielsweise myButton.addEventListener() zur Registrierung eines Ereignis-Listeners verwenden, weist currentTarget den Wert „myButton“ auf. |
message | Die mit diesem Ereignis verknüpfte Meldung. |
target | Das Objekt, von dem das Ereignis ausgelöst wurde. Dies ist nicht immer das Objekt, das auf das Ereignis wartet. Verwenden Sie die currentTarget-Eigenschaft, damit immer auf das Objekt, das auf das Ereignis wartet, zugegriffen wird. |
result | Vom RPC-Aufruf zurückgegebenes Ergebnis. |
token | Token, das den einzelnen Aufruf der Methode darstellt. Wird im asynchronen Abschluss-Token-Muster verwendet. |
Tue Jun 12 2018, 10:04 AM Z