Paket | mx.rpc.http |
Klasse | public class HTTPService |
Vererbung | HTTPService AbstractInvoker EventDispatcher Object |
Unterklassen | HTTPService |
Sprachversion: | ActionScript 3.0 |
Produktversion: | Flex 3 |
Laufzeitversionen: | Flash Player 9, AIR 1.1 |
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.
Verwandte API-Elemente
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 |
Methode | Definiert von | ||
---|---|---|---|
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 | ||
[override]
Bricht den letzten Dienstaufruf oder einen Aufruf mit der angegebenen ID ab. | HTTPService | ||
[override]
Setzt die Ergebniseigenschaft der aufrufenden Instanz auf null. | HTTPService | ||
Trennt die Netzverbindung des Dienstes. | HTTPService | ||
Sendet ein Ereignis in den Ereignisablauf. | EventDispatcher | ||
Überprüft, ob das EventDispatcher-Objekt Listener für einen bestimmten Ereignistyp registriert hat. | EventDispatcher | ||
Gibt an, ob für ein Objekt eine bestimmte Eigenschaft definiert wurde. | Object | ||
Gibt an, ob eine Instanz der Object-Klasse in der Prototypkette des Objekts vorhanden ist, das als Parameter angegeben wurde. | Object | ||
Meldet den Benutzer vom Ziel ab. | HTTPService | ||
Gibt an, ob die angegebene Eigenschaft vorhanden ist und durchlaufen werden kann. | Object | ||
Entfernt einen Listener aus dem EventDispatcher-Objekt. | EventDispatcher | ||
Führt eine HTTPService-Anforderung aus. | HTTPService | ||
Setzt die Benutzerdaten für das Ziel, auf das über den Dienst zugegriffen wird. | HTTPService | ||
Legt die Verfügbarkeit einer dynamischen Eigenschaft für Schleifenoperationen fest. | Object | ||
Der Benutzername und das Kennwort für die Authentifizierung eines Benutzers für den Zugriff auf die HTTP-URL. | HTTPService | ||
Dieser Hook ist stellt die Aktualisierung der lastResult-Eigenschaft bereit. | AbstractInvoker | ||
Gibt die Stringdarstellung dieses Objekts zurück, formatiert entsprechend den Konventionen des Gebietsschemas. | Object | ||
Gibt das angegebene Objekt als String zurück. | Object | ||
Gibt den Grundwert des angegebenen Objekts zurück. | Object | ||
Überprüft, ob bei diesem EventDispatcher-Objekt oder bei einem seiner Vorgänger ein Ereignis-Listener für einen bestimmten Ereignistyp registriert ist. | EventDispatcher |
Ereignis | Übersicht | Definiert von | ||
---|---|---|---|---|
[broadcast event] Wird ausgelöst, wenn Flash Player oder eine AIR-Anwendung den Betriebssystemfokus erhält und aktiv wird. | EventDispatcher | |||
[broadcast event] Wird ausgelöst, wenn Flash Player- oder die AIR-Anwendung den Fokus verliert und inaktiv wird. | EventDispatcher | |||
Wird ausgelöst, wenn ein HTTPService-Aufruf fehlschlägt. | HTTPService | |||
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 | |||
Wird ausgelöst, wenn ein HTTPService-Aufruf erfolgreich zurückgegeben wird. | HTTPService |
Konstante | Definiert von | ||
---|---|---|---|
CONTENT_TYPE_FORM : String = "application/x-www-form-urlencoded" [statisch]
Gibt an, dass durch den HTTP-Dienst übermittelte Daten als application/x-www-form-urlencoded kodiert sind. | HTTPService | ||
CONTENT_TYPE_XML : String = "application/xml" [statisch]
Gibt an, dass durch den HTTP-Dienst übermittelte Daten als application/xml kodiert sind. | HTTPService | ||
DEFAULT_DESTINATION_HTTP : String = "DefaultHTTP" [statisch]
Gibt an, dass das HTTPService-Objekt das DefaultHTTP-Ziel verwendet. | HTTPService | ||
DEFAULT_DESTINATION_HTTPS : String = "DefaultHTTPS" [statisch]
Gibt an, dass das HTTPService-Objekt das DefaultHTTPS-Ziel verwendet. | HTTPService | ||
ERROR_DECODING : String = "Client.CouldNotDecode" [statisch]
Gibt an, dass ein XML-formatiertes Ergebnis nicht als XML-Instanz geparst oder als Objekt dekodiert werden konnte. | HTTPService | ||
ERROR_ENCODING : String = "Client.CouldNotEncode" [statisch]
Gibt an, dass ein Eingabeparameter nicht als XML kodiert werden konnten. | HTTPService | ||
ERROR_URL_REQUIRED : String = "Client.URLRequired" [statisch]
Gibt an, dass die useProxy-Eigenschaft auf „false“ eingestellt, jedoch keine URL angegeben wurde. | HTTPService | ||
RESULT_FORMAT_ARRAY : String = "array" [statisch]
Das Ergebnisformat „array“ ist ähnlich dem Ergebnisformat „object“; der zurückgegebene Wert ist jedoch immer ein Array. Wenn das vom Ergebnisformat „object“ zurückgegebene Ergebnis nicht bereits ein Array ist, bildet es das erste Element eines neuen Array. | HTTPService | ||
RESULT_FORMAT_E4X : String = "e4x" [statisch]
Das Ergebnisformat „e4x“ legt fest, dass der zurückgegebene Wert eine XML-Instanz ist, auf die unter Verwendung von ECMAScript for XML (E4X)-Ausdrücke zugegriffen werden kann. | HTTPService | ||
RESULT_FORMAT_FLASHVARS : String = "flashvars" [statisch]
Das Ergebnisformat „flashvars“ legt fest, dass der zurückgegebene Wert Text ist, der durch kaufmännische Und-Zeichen getrennte Name=Wertpaare enthält und in ein ActionScript-Objekt geparst wird. | HTTPService | ||
RESULT_FORMAT_OBJECT : String = "object" [statisch]
Das Ergebnisformat „object“ legt fest, dass der zurückgegebene Wert XML ist, aber als Baum von ActionScript-Objekten geparst wird. | HTTPService | ||
RESULT_FORMAT_TEXT : String = "text" [statisch]
Das Ergebnisformat „text“ legt fest, dass der HTTPService-Ergebnistext ein unverarbeiteter String sein soll. | HTTPService | ||
RESULT_FORMAT_XML : String = "xml" [statisch]
Das Ergebnisformat „xml“ legt fest, dass Ergebnisse als flash.xml.XMLNode-Instanz zurückgegeben werden sollen, die auf das erste untergeordnete Element des übergeordneten flash.xml.XMLDocument weist. | HTTPService |
channelSet | Eigenschaft |
channelSet:ChannelSet
Sprachversion: | ActionScript 3.0 |
Produktversion: | Flex 3 |
Laufzeitversionen: | Flash Player 9, AIR 1.1 |
Stellt einen Zugriff auf das vom Dienst verwendete ChannelSet bereit. Der ChannelSet kann manuell erstellt und zugewiesen werden oder wird dynamisch erstellt, wobei er die konfigurierten Kanäle als destination
dieses Dienstes verwendet
Implementierung
public function get channelSet():ChannelSet
public function set channelSet(value:ChannelSet):void
concurrency | Eigenschaft |
concurrency:String
Sprachversion: | ActionScript 3.0 |
Produktversion: | Flex 3 |
Laufzeitversionen: | Flash Player 9, AIR 1.1 |
Wert, der angibt, wie mehrere Aufrufe desselben Dienstes verarbeitet werden sollen. 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 |
contentType:String
Sprachversion: | ActionScript 3.0 |
Produktversion: | Flex 3 |
Laufzeitversionen: | Flash Player 9, AIR 1.1 |
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.
Implementierung
public function get contentType():String
public function set contentType(value:String):void
destination | Eigenschaft |
destination:String
Sprachversion: | ActionScript 3.0 |
Produktversion: | Flex 3 |
Laufzeitversionen: | Flash Player 9, AIR 1.1 |
Ein HTTPService-Zielname in der services-config.xml-Datei. Mangels einer Angabe verwendet Flex das DefaultHTTP
-Ziel. Wenn Sie die url
-Eigenschaft verwenden, jedoch möchten, dass die Anforderungen den Proxy über HTTPS erreichen, geben Sie DefaultHTTPS
an.
Implementierung
public function get destination():String
public function set destination(value:String):void
headers | Eigenschaft |
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.
Implementierung
public function get headers():Object
public function set headers(value:Object):void
lastResult | Eigenschaft |
lastResult:Object
[schreibgeschützt] [override] Sprachversion: | ActionScript 3.0 |
Produktversion: | Flex 3 |
Laufzeitversionen: | Flash Player 9, AIR 1.1 |
Das Ergebnis des letzten Aufrufs.
Diese Eigenschaft kann als Quelle für die Datenbindung verwendet werden. Beim Ändern dieser Eigenschaft wird das resultForBinding
-Ereignis ausgelöst.
Implementierung
override public function get lastResult():Object
makeObjectsBindable | Eigenschaft |
makeObjectsBindable:Boolean
[override] Sprachversion: | ActionScript 3.0 |
Produktversion: | Flex 3 |
Laufzeitversionen: | Flash Player 9, AIR 1.1 |
Wenn dieser Wert true ist, wird die Umwandlung zurückgegebener anonymer Objekte in bindbare Objekte erzwungen.
Implementierung
override public function get makeObjectsBindable():Boolean
override public function set makeObjectsBindable(value:Boolean):void
method | Eigenschaft |
method:String
Sprachversion: | ActionScript 3.0 |
Produktversion: | Flex 3 |
Laufzeitversionen: | Flash Player 9, AIR 1.1 |
HTTP-Methode zum Senden der Anforderung. Zulässige Werte sind GET
, POST
, HEAD
, OPTIONS
, PUT
, TRACE
und DELETE
. Kleinbuchstaben werden in Großbuchstaben umgewandelt. Der Standardwert ist GET
.
Implementierung
public function get method():String
public function set method(value:String):void
request | Eigenschaft |
request:Object
Sprachversion: | ActionScript 3.0 |
Produktversion: | Flex 3 |
Laufzeitversionen: | Flash Player 9, AIR 1.1 |
Objekt aus Namen-/Wertpaaren, die als Parameter der URL verwendet werden. Wenn die contentType
-Eigenschaft auf application/xml
eingestellt ist, sollte es ein XML-Dokument sein.
Implementierung
public function get request():Object
public function set request(value:Object):void
requestTimeout | Eigenschaft |
requestTimeout:int
Sprachversion: | ActionScript 3.0 |
Produktversion: | Flex 3 |
Laufzeitversionen: | Flash Player 9, AIR 1.1 |
Gibt Zugriff auf die Zeitüberschreitung der Anforderung für übermittelte Meldungen. Ein Wert, der kleiner oder gleich null ist, verhindert die Zeitüberschreitung der Anforderung.
Implementierung
public function get requestTimeout():int
public function set requestTimeout(value:int):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
rootURL | Eigenschaft |
rootURL: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 Eigenschaft wird nur bei Verwendung eines Proxys verwendet. Wenn die useProxy
-Eigenschaft auf false
eingestellt ist, wird die relative URL automatisch aufgrund der Position der SWF-Datei berechnet, die diese Anwendung ausführt. Wenn nicht ausdrücklich ausgewählt, wird rootURL
automatisch auf die URL der mx.messaging.config.LoaderConfig.url eingestellt.
Implementierung
public function get rootURL():String
public function set rootURL(value:String):void
serializationFilter | Eigenschaft |
serializationFilter:SerializationFilter
Sprachversion: | ActionScript 3.0 |
Produktversion: | Flex 3 |
Laufzeitversionen: | Flash Player 9, AIR 1.1 |
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. Diese Einstellung kann auch indirekt erfolgen, indem das resultFormat durch die Registrierung eines SerializationFilter mithilfe der statischen Methode eingestellt wird: SerializationFilter.registerFilterForResultFormat("formatName", filter)
Implementierung
public function get serializationFilter():SerializationFilter
public function set serializationFilter(value:SerializationFilter):void
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
url | Eigenschaft |
url:String
Sprachversion: | ActionScript 3.0 |
Produktversion: | Flex 3 |
Laufzeitversionen: | Flash Player 9, AIR 1.1 |
Position des Dienstes. Wenn Sie die URL
und ein nicht standardmäßiges Ziel angeben, muss das Ziel in der services-config.xml-Datei die angegebene URL zulassen.
Implementierung
public function get url():String
public function set url(value:String):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
xmlDecode | Eigenschaft |
xmlDecode:Function
Sprachversion: | ActionScript 3.0 |
Produktversion: | Flex 3 |
Laufzeitversionen: | Flash Player 9, AIR 1.1 |
ActionScript-Funktion, die zum Dekodieren eines Dienstergebnisses aus XML verwendet wird. Wenn das resultFormat
ein Objekt ist und die xmlDecode
-Eigenschaft gesetzt ist, erstellt Flex mithilfe der vom HTTPService zurückgegebenen XML-Datei ein Objekt. Bei fehlender Definition wird dafür der Standard-XMLDecoder verwendet.
Die Funktion, auf die die xmlDecode
-Eigenschaft verweist, muss ein flash.xml.XMLNode-Objekt als Parameter übernehmen und ein Objekt zurückgeben. Sie kann jede Art von Objekt zurückgeben. Wichtig ist, dass etwas zurückgeben wird: Die Rückgabe von null
oder undefined
erzeugt einen Fehler.
<mx:HTTPService id="hs" xmlDecode="xmlDecoder" url="myURL" resultFormat="object" contentType="application/xml"> <mx:request><source/> <obj>{RequestObject}</obj> </mx:request> </mx:HTTPService>Das nachstehende Beispiel zeigt eine xmlDecoder-Funktion:
function xmlDecoder (myXML) { // Simplified decoding logic. var myObj = {}; myObj.name = myXML.firstChild.nodeValue; myObj.honorific = myXML.firstChild.attributes.honorific; return myObj; }
Implementierung
public function get xmlDecode():Function
public function set xmlDecode(value:Function):void
xmlEncode | Eigenschaft |
xmlEncode:Function
Sprachversion: | ActionScript 3.0 |
Produktversion: | Flex 3 |
Laufzeitversionen: | Flash Player 9, AIR 1.1 |
ActionScript-Funktion, die zum Dekodieren einer Dienstanforderung als XML verwendet wird. Wenn die contentType
einer Anforderung application/xml
und das übergebene Anforderungsobjekt ein Objekt ist, versucht Flex, dieses mithilfe der in der xmlEncode
-Eigenschaft angegebenen Funktion in ein flash.xml.XMLNode-Objekt umzuwandeln. Wenn die xmlEncode
-Eigenschaft nicht gesetzt ist, verwendet Flex den Standard-XMLEncoder zur Umwandlung des Objektdiagramms in ein flash.xml.XMLNode-Objekt.
Die xmlEncode
-Eigenschaft verwendet ein Objekt und muss ein flash.xml.XMLNode-Objekt zurückgeben. In diesem Fall kann das XMLNode-Objekt ein flash.xml.XML-Objekt sein, das eine Unterklasse von XMLNode bzw. das erste untergeordnete Element des flash.xml.XML-Objekts ist, also das Ergebnis eines <mx:XML>
-Tags. Bei Rückgabe des falschen Objekttyps wird ein Fehler erzeugt. Das nachstehende Beispiel zeigt ein <mx:HTTPService>-Tag, das eine xmlEncode-Funktion angibt:
<mx:HTTPService id="hs" xmlEncode="xmlEncoder" url="myURL" resultFormat="object" contentType="application/xml"> <mx:request><source/> <obj>{RequestObject}</obj> </mx:request> </mx:HTTPService>Das nachstehende Beispiel zeigt eine xmlEncoder-Funktion:
function xmlEncoder (myObj) { return new XML(""); }
Implementierung
public function get xmlEncode():Function
public function set xmlEncode(value:Function):void
HTTPService | () | 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. Wenn der Dienst beim Senden relative URLs verwenden soll, können Sie die rootURL
angeben, die als Basis für die Bestimmung der vollständigen URL verwendet wird (z. B.:Application.application.url
).
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.
|
cancel | () | Methode |
override public function cancel(id:String = null):mx.rpc:AsyncToken
Sprachversion: | ActionScript 3.0 |
Produktversion: | Flex 3 |
Laufzeitversionen: | Flash Player 9, AIR 1.1 |
Bricht den letzten Dienstaufruf oder einen Aufruf mit der angegebenen ID ab. Auch wenn der Netzvorgang noch weiterläuft, wird kein Ergebnis oder Fehlerereignis ausgelöst.
Parameter
id:String (default = null ) — Die messageID des Aufrufs, der abgebrochen werden soll. Optional. Bei Nichtverwendung wird der letzte Dienstaufruf abgebrochen.
|
mx.rpc:AsyncToken — Das mit dem Aufruf verknüpfte AsyncToken, das abgebrochen wurde oder null ist, wenn kein Aufruf abgebrochen wurde.
|
clearResult | () | Methode |
override public function clearResult(fireBindingEvent:Boolean = true):void
Sprachversion: | ActionScript 3.0 |
Produktversion: | Flex 3 |
Laufzeitversionen: | Flash Player 9, AIR 1.1 |
Setzt die result
-Eigenschaft der aufrufenden Instanz auf null
. Dies ist nützlich, wenn das Ergebnis ein großes Objekt ist, das nicht mehr verwendet wird.
Parameter
fireBindingEvent:Boolean (default = true ) — Setzen Sie diesen Parameter auf true , wenn Sie alle mit dem Ergebnis verbundenen Elemente aktualisieren möchten. Andernfalls stellen Sie diesen Parameter auf false . Der Standardwert ist true
|
disconnect | () | Methode |
public function disconnect():void
Sprachversion: | ActionScript 3.0 |
Produktversion: | Flex 3 |
Laufzeitversionen: | Flash Player 9, AIR 1.1 |
Trennt die Netzverbindung des Dienstes. Diese Methode wartet nicht, bis anstehende Netzwerkvorgänge abgeschlossen sind.
logout | () | Methode |
public function logout():void
Sprachversion: | ActionScript 3.0 |
Produktversion: | Flex 3 |
Laufzeitversionen: | Flash Player 9, AIR 1.1 |
Meldet den Benutzer vom Ziel ab. Die Abmeldung von einem Ziel gilt für sämtliche verbundenen Elemente, die denselben, in der Serverkonfiguration festgelegten Kanal verwenden. Wenn Sie z. B. über den my-rtmp-Kanal verbunden sind und sich über eine der RPC-Komponenten abmelden, werden alle über my-rtmp verbundenen Elemente abgemeldet.
Hinweis: Adobe empfiehlt, statt dieser Methode die mx.messaging.ChannelSet.logout()-Methode zu verwenden.
Verwandte API-Elemente
send | () | Methode |
public function send(parameters:Object = null):mx.rpc:AsyncToken
Sprachversion: | ActionScript 3.0 |
Produktversion: | Flex 3 |
Laufzeitversionen: | Flash Player 9, AIR 1.1 |
Führt eine HTTPService-Anforderung aus. Die Parameter sind optional, doch wenn sie verwendet werden, sollten sie ein Objekt mit Namen-/Wertpaaren oder ein XML-Objekt sein, je nach contentType
.
Parameter
parameters:Object (default = null ) — Ein Objekt, das Namen-/Wertpaare oder ein XML-Objekt enthält, je nach der Art des Inhalts für die Dienstanforderungen.
|
mx.rpc:AsyncToken — Ein Objekt, welches das asynchrone Abschluss-Token darstellt. Es ist dasselbe Objekt, das bei den result - oder fault -Ereignissen in der token -Eigenschaft zur Verfügung steht.
|
setCredentials | () | Methode |
public function setCredentials(username:String, password:String, charset:String = null):void
Sprachversion: | ActionScript 3.0 |
Produktversion: | Flex 3 |
Laufzeitversionen: | Flash Player 9, AIR 1.1 |
Setzt die Benutzerdaten für das Ziel, auf das über den Dienst zugegriffen wird. Die Benutzerdaten werden für alle Dienste angewandt, die über denselben ChannelSet verbunden sind. Dienste, die einen Proxy für ein Remoteziel verwenden, müssen stattdessen die setRemoteCredentials()
-Methode aufrufen.
Parameter
username:String — den Benutzernamen für das Ziel.
| |
password:String — Das Kennwort für das Ziel.
| |
charset:String (default = null ) — Die zu verwendende Zeichensatzkodierung für die Kodierung der Daten. Der Standardwert ist null, d. h. dass der ältere Zeichensatz ISO Lateinisch-1 unterstützt wird. Der einzige unterstützte Zeichensatz ist „UTF-8“.
|
setRemoteCredentials | () | Methode |
public function setRemoteCredentials(remoteUsername:String, remotePassword:String, charset:String = null):void
Sprachversion: | ActionScript 3.0 |
Produktversion: | Flex 3 |
Laufzeitversionen: | Flash Player 9, AIR 1.1 |
Der Benutzername und das Kennwort für die Authentifizierung eines Benutzers für den Zugriff auf die HTTP-URL. Diese werden vom Proxy als Bestandteil des HTTP-Berechtigungs-Headers dem Endpunkt übergeben. Wenn die useProxy
-Eigenschaft auf „false“ eingestellt ist, wird diese Eigenschaft ignoriert.
Parameter
remoteUsername:String — der Benutzername für den Zugriff auf den Remote-Endpunkt.
| |
remotePassword:String — das Kennwort für den Zugriff auf den Remote-Endpunkt.
| |
charset:String (default = null ) — Die für die Kodierung der Remotedaten zu verwendende Zeichensatzkodierung. Der Standardwert ist null, d. h. dass der ältere Zeichensatz ISO Lateinisch-1 unterstützt wird. Der einzige unterstützte Zeichensatz ist „UTF-8“.
|
fault | Ereignis |
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 HTTPService-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.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 HTTPService-Aufruf ausgelöst, es sei denn, es wird ein Fehler ausgelöst, 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.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 HTTPService-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. |
CONTENT_TYPE_FORM | Konstante |
public static const CONTENT_TYPE_FORM:String = "application/x-www-form-urlencoded"
Sprachversion: | ActionScript 3.0 |
Produktversion: | Flex 3 |
Laufzeitversionen: | Flash Player 9, AIR 1.1 |
Gibt an, dass durch den HTTP-Dienst übermittelte Daten als application/x-www-form-urlencoded kodiert sind.
CONTENT_TYPE_XML | Konstante |
public static const CONTENT_TYPE_XML:String = "application/xml"
Sprachversion: | ActionScript 3.0 |
Produktversion: | Flex 3 |
Laufzeitversionen: | Flash Player 9, AIR 1.1 |
Gibt an, dass durch den HTTP-Dienst übermittelte Daten als application/xml kodiert sind.
DEFAULT_DESTINATION_HTTP | Konstante |
public static const DEFAULT_DESTINATION_HTTP:String = "DefaultHTTP"
Sprachversion: | ActionScript 3.0 |
Produktversion: | Flex 3 |
Laufzeitversionen: | Flash Player 9, AIR 1.1 |
Gibt an, dass das HTTPService-Objekt das DefaultHTTP-Ziel verwendet.
DEFAULT_DESTINATION_HTTPS | Konstante |
public static const DEFAULT_DESTINATION_HTTPS:String = "DefaultHTTPS"
Sprachversion: | ActionScript 3.0 |
Produktversion: | Flex 3 |
Laufzeitversionen: | Flash Player 9, AIR 1.1 |
Gibt an, dass das HTTPService-Objekt das DefaultHTTPS-Ziel verwendet.
ERROR_DECODING | Konstante |
public static const ERROR_DECODING:String = "Client.CouldNotDecode"
Sprachversion: | ActionScript 3.0 |
Produktversion: | Flex 3 |
Laufzeitversionen: | Flash Player 9, AIR 1.1 |
Gibt an, dass ein XML-formatiertes Ergebnis nicht als XML-Instanz geparst oder als Objekt dekodiert werden konnte.
ERROR_ENCODING | Konstante |
public static const ERROR_ENCODING:String = "Client.CouldNotEncode"
Sprachversion: | ActionScript 3.0 |
Produktversion: | Flex 3 |
Laufzeitversionen: | Flash Player 9, AIR 1.1 |
Gibt an, dass ein Eingabeparameter nicht als XML kodiert werden konnten.
ERROR_URL_REQUIRED | Konstante |
public static const ERROR_URL_REQUIRED:String = "Client.URLRequired"
Sprachversion: | ActionScript 3.0 |
Produktversion: | Flex 3 |
Laufzeitversionen: | Flash Player 9, AIR 1.1 |
Gibt an, dass die useProxy-Eigenschaft auf „false“ eingestellt, jedoch keine URL angegeben wurde.
RESULT_FORMAT_ARRAY | Konstante |
public static const RESULT_FORMAT_ARRAY:String = "array"
Sprachversion: | ActionScript 3.0 |
Produktversion: | Flex 3 |
Laufzeitversionen: | Flash Player 9, AIR 1.1 |
Das Ergebnisformat „array“ ist ähnlich dem Ergebnisformat „object“; der zurückgegebene Wert ist jedoch immer ein Array. Wenn das vom Ergebnisformat „object“ zurückgegebene Ergebnis nicht bereits ein Array ist, bildet es das erste Element eines neuen Array.
RESULT_FORMAT_E4X | Konstante |
public static const RESULT_FORMAT_E4X:String = "e4x"
Sprachversion: | ActionScript 3.0 |
Produktversion: | Flex 3 |
Laufzeitversionen: | Flash Player 9, AIR 1.1 |
Das Ergebnisformat „e4x“ legt fest, dass der zurückgegebene Wert eine XML-Instanz ist, auf die unter Verwendung von ECMAScript for XML (E4X)-Ausdrücke zugegriffen werden kann.
RESULT_FORMAT_FLASHVARS | Konstante |
public static const RESULT_FORMAT_FLASHVARS:String = "flashvars"
Sprachversion: | ActionScript 3.0 |
Produktversion: | Flex 3 |
Laufzeitversionen: | Flash Player 9, AIR 1.1 |
Das Ergebnisformat „flashvars“ legt fest, dass der zurückgegebene Wert Text ist, der durch kaufmännische Und-Zeichen getrennte Name=Wertpaare enthält und in ein ActionScript-Objekt geparst wird.
RESULT_FORMAT_OBJECT | Konstante |
public static const RESULT_FORMAT_OBJECT:String = "object"
Sprachversion: | ActionScript 3.0 |
Produktversion: | Flex 3 |
Laufzeitversionen: | Flash Player 9, AIR 1.1 |
Das Ergebnisformat „object“ legt fest, dass der zurückgegebene Wert XML ist, aber als Baum von ActionScript-Objekten geparst wird. Dies ist die Standardeinstellung.
RESULT_FORMAT_TEXT | Konstante |
public static const RESULT_FORMAT_TEXT:String = "text"
Sprachversion: | ActionScript 3.0 |
Produktversion: | Flex 3 |
Laufzeitversionen: | Flash Player 9, AIR 1.1 |
Das Ergebnisformat „text“ legt fest, dass der HTTPService-Ergebnistext ein unverarbeiteter String sein soll.
RESULT_FORMAT_XML | Konstante |
public static const RESULT_FORMAT_XML:String = "xml"
Sprachversion: | ActionScript 3.0 |
Produktversion: | Flex 3 |
Laufzeitversionen: | Flash Player 9, AIR 1.1 |
Das Ergebnisformat „xml“ legt fest, dass Ergebnisse als flash.xml.XMLNode-Instanz zurückgegeben werden sollen, die auf das erste untergeordnete Element des übergeordneten flash.xml.XMLDocument weist.
Tue Jun 12 2018, 10:04 AM Z