ActionScript® 3.0 Referenzhandbuch für die Adobe® Flash®-Plattform
Home  |  Liste der Pakete und Klassen ausblenden |  Pakete  |  Klassen  |  Neue Funktionen  |  Stichwortverzeichnis  |  Anhänge  |  Warum auf Englisch?
Filter: Daten werden vom Server abgerufen...
Daten werden vom Server abgerufen...
mx.rpc.http 

HTTPMultiService  - AS3 Flex

Paketmx.rpc.http
Klassepublic dynamic class HTTPMultiService
VererbungHTTPMultiService Inheritance AbstractService Inheritance Proxy
Unterklassen HTTPMultiService

Sprachversion: ActionScript 3.0
Produktversion: Flex 3
Laufzeitversionen: Flash Player 9, AIR 1.1

Das <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



Öffentliche Eigenschaften
 EigenschaftDefiniert von
  baseURL : String
Die URL, die der HTTPService bei der Berechnung relativer URLs verwenden soll.
HTTPMultiService
 InheritedchannelSet : 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
 Inheriteddestination : 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
 Inheritedmanagers : 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
 Inheritedoperations : 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
 InheritedrequestTimeout : 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
Öffentliche Methoden
 MethodeDefiniert von
  
HTTPMultiService(baseURL:String = null, destination:String = null)
Erstellt einen neuen HTTPService.
HTTPMultiService
 Inherited
Trennt die Netzverbindung des Dienstes und entfernt sämtliche anstehende Anforderungsresponder.
AbstractService
 Inherited
Gibt einen Vorgang mit dem jeweiligen Namen zurück.
AbstractService
 Inherited
Aufgerufen, um den Dienst zu initialisieren.
AbstractService
 Inherited
Meldet den Benutzer vom Ziel ab.
AbstractService
 Inherited
setCredentials(username:String, password:String, charset:String = null):void
Setzt die Benutzerdaten für den Zielpfad, auf den über den Dienst zugegriffen wird, wenn serverseitige Datendienste verwendet werden.
AbstractService
 Inherited
setRemoteCredentials(remoteUsername:String, remotePassword:String, charset:String = null):void
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
Ereignisse
 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
Eigenschaftendetails

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:

  • multiple Existierende 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.
  • single Es ist jeweils nur eine einzelne Anforderung für den Vorgang zulässig; mehrere Anforderungen lösen einen Fehler aus.
  • last Jede Anforderung bewirkt, dass alle bereits existierenden Anforderungen abgebrochen werden.



Implementierung
    public function get concurrency():String
    public function set concurrency(value:String):void

contentType

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):void

resultFormat

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:

  • object Der zurückgegebene Wert ist XML und wird als Baum von ActionScript-Objekten geparst. Dies ist die Standardeinstellung.
  • array Der 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.
  • xml Der zurückgegebene Wert ist XML und wird als literal XML in einem ActionScriptXMLnode-Objekt geparst.
  • flashvars Der zurückgegebene Wert ist Text mit durch Und-Zeichen getrennten Name-/Wertpaaren, der in ein ActionScript-Objekt geparst wird.
  • text Der zurückgegebene Wert ist Text und wird unformatiert gelassen.
  • e4x Der 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):void

serializationFilter

Eigenschaft 
public var serializationFilter:SerializationFilter

Standardmäß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):void

useProxy

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):void
Konstruktordetails

HTTPMultiService

()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).

Parameter
baseURL:String (default = null) — Die URL, die der HTTPService bei der Berechnung relativer URLs verwenden soll.
 
destination:String (default = null)
Ereignisdetails

fault

Ereignis
Ereignisobjekttyp: mx.rpc.events.FaultEvent
Eigenschaft 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:

EigenschaftWert
bubblesfalse
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.
currentTargetDas 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.
faultDas Fault-Objekt, das die Details über den Auslöser dieses Ereignisses enthält.
messageDie mit diesem Ereignis verknüpfte Meldung.
targetDas 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.
tokenDas Token, das den Aufruf der Methode darstellt. Wird im asynchronen Abschluss-Token-Muster verwendet.

invoke

Ereignis  
Ereignisobjekttyp: mx.rpc.events.InvokeEvent
Eigenschaft 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:

EigenschaftWert
bubblesfalse
token Token, das den einzelnen Aufruf der Methode darstellt. Wird im asynchronen Abschluss-Token-Muster verwendet.
cancelabletrue
currentTargetDas 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.
targetDas 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  
Ereignisobjekttyp: mx.rpc.events.ResultEvent
Eigenschaft 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:

EigenschaftWert
bubblesfalse
cancelabletrue, preventDefault() aus der verknüpften responder.result-Methode des Token verhindert, dass der Dienst oder der Vorgang dieses Ereignis auslöst.
currentTargetDas 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.
targetDas 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.
resultVom RPC-Aufruf zurückgegebenes Ergebnis.
tokenToken, das den einzelnen Aufruf der Methode darstellt. Wird im asynchronen Abschluss-Token-Muster verwendet.




[ X ]Warum auf Englisch?
Inhalt des ActionScript 3.0-Referenzhandbuchs wird in englischer Sprache angezeigt

Nicht alle Teile des ActionScript 3.0-Referenzhandbuchs wurden in alle Sprachen übersetzt. Wenn der Text zu einem Sprachelement nicht übersetzt wurde, wird er auf Englisch angezeigt. Zum Beispiel wurden die Informationen zur ga.controls.HelpBox-Klasse nicht in andere Sprachen übersetzt. In der deutschen Version des Referenzhandbuchs erscheint der Abschnitt zur ga.controls.HelpBox-Klasse deshalb auf Englisch.