| 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
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 | ||
| 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):voidconcurrency | 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:
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 |
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):voiddestination | 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):voidheaders | 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):voidlastResult | 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():ObjectmakeObjectsBindable | 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):voidmethod | 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):voidrequest | 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):voidrequestTimeout | 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):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):voidrootURL | 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):voidserializationFilter | 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):voidshowBusyCursor | 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):voidurl | 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):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):voidxmlDecode | 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):voidxmlEncode | 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):voidHTTPService | () | 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) | |
destination:String (default = null) |
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) |
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)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) |
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) |
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) |
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 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.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 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.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 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