| Paket | mx.rpc.http |
| Klasse | public class AbstractOperation |
| Vererbung | AbstractOperation AbstractOperation AbstractInvoker EventDispatcher Object |
| Unterklassen | Operation |
| Sprachversion: | ActionScript 3.0 |
| Produktversion: | Flex 3 |
| Laufzeitversionen: | Flash Player 9, AIR 1.1 |
send(param1,param2)-Methode aufgerufen werden. HTTP-Dienste unterstützen auch eine sendBody-Methode, mit der es möglich ist, den Hauptteil der HTTP-Antwort direkt anzugeben. Bei Verwendung der send(param1, param2)-Methode wird der Hauptteil normalerweise aus der Kombination der argumentNames-Eigenschaft des Vorgangs mit den übermittelten Parametern gebildet. Ein Objekt wird erstellt, das die argumentNames[i]-Eigenschaft als Schlüssel und den entsprechenden Parameter als Wert verwendet.
Wie die HTTP-Vorgangsargumente genau in den HTTP-Hauptteil gestellt werden, hängt vom verwendeten serializationFilter ab.
| Eigenschaft | Definiert von | ||
|---|---|---|---|
| argumentNames : Array
Eine geordnete Liste von Argumentnamen zur Übergabe an einen Methodenaufruf. | AbstractOperation | ||
![]() | arguments : Object
Die Argumente, die dem aufgerufenen Vorgang übergeben werden müssen. | AbstractOperation | |
| concurrency : String
Wert, der angibt, wie mehrere Aufrufe desselben Dienstes verarbeitet werden sollen. | AbstractOperation | ||
![]() | constructor : Object
Ein Verweis auf das Klassenobjekt oder die Konstruktorfunktion für eine angegebene Objektinstanz. | Object | |
| contentType : String
Art des Inhalts für Dienstanforderungen. | AbstractOperation | ||
| headers : Object
Benutzerdefinierte HTTP-Header, die an Endpunkte von Drittparteien gesendet werden sollen. | AbstractOperation | ||
![]() | lastResult : Object [schreibgeschützt]
Das Ergebnis des letzten Aufrufs. | AbstractInvoker | |
![]() | makeObjectsBindable : Boolean
Wenn dieser Wert true ist, wird die Umwandlung zurückgegebener anonymer Objekte in bindbare Objekte erzwungen. | AbstractInvoker | |
| method : String
HTTP-Methode zum Senden der Anforderung. | AbstractOperation | ||
![]() | name : String
Der Name des Vorgangs. | AbstractOperation | |
![]() | 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 | |
![]() | properties : Object
Dieser Hook ist hauptsächlich für Frameworkentwickler zum Registrieren von zusätzlichen benutzerdefinierten Eigenschaften für den Vorgang gedacht. | AbstractOperation | |
| request : Object
Objekt aus Namen-/Wertpaaren, die als Parameter der URL verwendet werden. | AbstractOperation | ||
| requestTimeout : int
Gibt Zugriff auf die Zeitüberschreitung der Anforderung für übermittelte Meldungen. | AbstractOperation | ||
![]() | 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. | AbstractOperation | ||
![]() | 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. | AbstractOperation | ||
| serializationFilter : SerializationFilter
Ein SerializationFilter kann steuern, wie die Argumente formatiert werden, um den Inhalt der HTTP-Anforderung zu bilden. | AbstractOperation | ||
![]() | service : AbstractService [schreibgeschützt]
Bietet praktischen Zugriff auf den Dienst, in dem der Vorgang aufgerufen wird. | AbstractOperation | |
| showBusyCursor : Boolean
Wenn die Einstellung „true“ ist, wird ein Aktivitäten-Cursor angezeigt, während ein Dienst ausgeführt wird. | AbstractOperation | ||
| url : String
Position des Dienstes. | AbstractOperation | ||
| useProxy : Boolean
Gibt an, ob der Flex-Proxy-Dienst verwendet werden soll. | AbstractOperation | ||
| xmlDecode : Function
ActionScript-Funktion, die zum Dekodieren eines Dienstergebnisses aus XML verwendet wird. | AbstractOperation | ||
| xmlEncode : Function
ActionScript-Funktion, die zum Dekodieren einer Dienstanforderung als XML verwendet wird. | AbstractOperation | ||
| Methode | Definiert von | ||
|---|---|---|---|
Erstellt einen neuen Vorgang. | AbstractOperation | ||
![]() | 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 | |
![]() |
Bricht den letzten Dienstaufruf oder einen Aufruf mit der angegebenen ID ab. | AbstractInvoker | |
![]() |
Setzt die Ergebniseigenschaft der aufrufenden Instanz auf null. | AbstractInvoker | |
![]() |
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 | |
![]() |
Gibt an, ob die angegebene Eigenschaft vorhanden ist und durchlaufen werden kann. | Object | |
![]() |
Entfernt einen Listener aus dem EventDispatcher-Objekt. | EventDispatcher | |
![]() |
Führt die Methode aus. | AbstractOperation | |
| AbstractOperation | |||
![]() |
Legt die Verfügbarkeit einer dynamischen Eigenschaft für Schleifenoperationen fest. | Object | |
![]() |
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 | |
| Methode | Definiert von | ||
|---|---|---|---|
Gibt die Header der HTTP-Anforderung zurück. | AbstractOperation | ||
Gibt den Serialisierungsfilter zurück. | AbstractOperation | ||
argumentNames | Eigenschaft |
public var argumentNames:Array| Sprachversion: | ActionScript 3.0 |
| Produktversion: | Flex 3 |
| Laufzeitversionen: | Flash Player 9, AIR 1.1 |
Eine geordnete Liste von Argumentnamen zur Übergabe an einen Methodenaufruf. Da das Argumentobjekt eine Hashmap ohne feste Reihenfolge ist, dient dieses Array dazu, alles richtig zu ordnen. Es wird bei Bedarf automatisch vom MXML-Compiler gesetzt, wenn der Vorgang in Tag-Form 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 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):voidheaders | 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.
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):voidrequest | Eigenschaft |
public var 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.
requestTimeout | Eigenschaft |
requestTimeout:int| Sprachversion: | ActionScript 3.0 |
| Produktversionen: | BlazeDS 4, Adobe Digital Enterprise Platform Data Services für Java EE 3 |
| Laufzeitversionen: | Flash Player 9, AIR 1.1 |
Gibt Zugriff auf die Zeitüberschreitung der Anforderung für übermittelte Meldungen. Wenn vor Erreichen der Zeitüberschreitung keine Bestätigung, keine Antwort oder kein Fehler von einem Remote-Ziel erhalten wurde, gilt die Meldung am Client als fehlgeschlagen. 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 |
public var serializationFilter:SerializationFilter| Sprachversion: | ActionScript 3.0 |
| Produktversion: | Flex 3 |
| Laufzeitversionen: | Flash Player 9, AIR 1.1 |
Ein SerializationFilter kann steuern, wie die Argumente formatiert werden, um den Inhalt der HTTP-Anforderung zu bilden. Er steuert auch, wie die Ergebnisse in ActionScript-Ergebnisse umgewandelt werden. Sie können den Filter entweder explizit mithilfe dieser Eigenschaft oder indirekt mithilfe der resultFormat-Eigenschaft 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):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 |
public var 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;
}
xmlEncode | Eigenschaft |
public var 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("");
}
AbstractOperation | () | Konstruktor |
public function AbstractOperation(service:AbstractService = null, name:String = null)| Sprachversion: | ActionScript 3.0 |
| Produktversion: | Flex 3 Creates a new Operation. |
| Laufzeitversionen: | Flash Player 9, AIR 1.1 |
Erstellt einen neuen Vorgang.
Parameterservice:AbstractService (default = null) — Das Objekt, das den Diensttyp, beispielsweise HTTPMultiService, WebService oder RemoteObject definiert.
| |
name:String (default = null) — Der Name des Dienstes.
|
getHeaders | () | Methode |
protected function getHeaders():Object| Sprachversion: | ActionScript 3.0 |
| Produktversion: | Flex 3 |
| Laufzeitversionen: | Flash Player 9, AIR 1.1 |
Gibt die Header der HTTP-Anforderung zurück. Unterklassen können diese Methode überschreiben, um das Abrufen von Headern der HTTP-Anforderung zu steuern.
RückgabewerteObject — Die Header der HTTP-Anforderung.
|
getSerializationFilter | () | Methode |
protected function getSerializationFilter():SerializationFilterGibt den Serialisierungsfilter zurück. Unterklassen können diese Methode überschreiben, um das Abrufen von Headern der HTTP-Anforderung zu steuern.
RückgabewerteSerializationFilter — Der Serialisierungsfilter.
|
sendBody | () | Methode |
public function sendBody(parameters:Object):mx.rpc:AsyncTokenParameter
parameters:Object |
mx.rpc:AsyncToken |
Tue Jun 12 2018, 10:04 AM Z
Vererbte öffentliche Eigenschaften ausblenden
Vererbte öffentliche Eigenschaften anzeigen