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 

AbstractOperation  - AS3 Flex

Paketmx.rpc.http
Klassepublic class AbstractOperation
VererbungAbstractOperation Inheritance AbstractOperation Inheritance AbstractInvoker Inheritance EventDispatcher Inheritance Object
Unterklassen Operation

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

Ein Vorgang, der speziell von einem HTTPService verwendet wird. Ein Vorgang ist ein einzelner Vorgang in einem Dienst, der normalerweise einem einzelnen serverseitigen Vorgang entspricht. Ein Vorgang kann entweder durch Aufrufen der gleichnamigen Funktion im Dienst oder durch Zugriff auf den Vorgang als eine Eigenschaft im Dienst und durch Aufruf der 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.



Öffentliche Eigenschaften
 EigenschaftDefiniert von
  argumentNames : Array
Eine geordnete Liste von Argumentnamen zur Übergabe an einen Methodenaufruf.
AbstractOperation
 Inheritedarguments : 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
 Inheritedconstructor : 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
 InheritedlastResult : Object
[schreibgeschützt] Das Ergebnis des letzten Aufrufs.
AbstractInvoker
 InheritedmakeObjectsBindable : 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
 Inheritedname : String
Der Name des Vorgangs.
AbstractOperation
 InheritedoperationManager : Function
Diese Eigenschaft wird in der Regel vom Frameworkcode gesetzt, der das Verhalten eines Dienstaufrufs modifizieren will, damit der Dienst extern aufgerufen wird.
AbstractInvoker
 Inheritedproperties : 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
 InheritedresultElementType : 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
 InheritedresultType : 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
 Inheritedservice : 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
Öffentliche Methoden
 MethodeDefiniert von
  
AbstractOperation(service:AbstractService = null, name:String = null)
Erstellt einen neuen Vorgang.
AbstractOperation
 Inherited
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
 Inherited
Bricht den letzten Dienstaufruf oder einen Aufruf mit der angegebenen ID ab.
AbstractInvoker
 Inherited
clearResult(fireBindingEvent:Boolean = true):void
Setzt die Ergebniseigenschaft der aufrufenden Instanz auf null.
AbstractInvoker
 Inherited
Sendet ein Ereignis in den Ereignisablauf.
EventDispatcher
 Inherited
Überprüft, ob das EventDispatcher-Objekt Listener für einen bestimmten Ereignistyp registriert hat.
EventDispatcher
 Inherited
Gibt an, ob für ein Objekt eine bestimmte Eigenschaft definiert wurde.
Object
 Inherited
Gibt an, ob eine Instanz der Object-Klasse in der Prototypkette des Objekts vorhanden ist, das als Parameter angegeben wurde.
Object
 Inherited
Gibt an, ob die angegebene Eigenschaft vorhanden ist und durchlaufen werden kann.
Object
 Inherited
removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void
Entfernt einen Listener aus dem EventDispatcher-Objekt.
EventDispatcher
 Inherited
Führt die Methode aus.
AbstractOperation
  
AbstractOperation
 Inherited
Legt die Verfügbarkeit einer dynamischen Eigenschaft für Schleifenoperationen fest.
Object
 Inherited
Dieser Hook ist stellt die Aktualisierung der lastResult-Eigenschaft bereit.
AbstractInvoker
 Inherited
Gibt die Stringdarstellung dieses Objekts zurück, formatiert entsprechend den Konventionen des Gebietsschemas.
Object
 Inherited
Gibt das angegebene Objekt als String zurück.
Object
 Inherited
Gibt den Grundwert des angegebenen Objekts zurück.
Object
 Inherited
Überprüft, ob bei diesem EventDispatcher-Objekt oder bei einem seiner Vorgänger ein Ereignis-Listener für einen bestimmten Ereignistyp registriert ist.
EventDispatcher
Geschützte Methoden
 MethodeDefiniert von
  
Gibt die Header der HTTP-Anforderung zurück.
AbstractOperation
  
Gibt den Serialisierungsfilter zurück.
AbstractOperation
Ereignisse
 Ereignis Übersicht Definiert von
 Inherited[broadcast event] Wird ausgelöst, wenn Flash Player oder eine AIR-Anwendung den Betriebssystemfokus erhält und aktiv wird.EventDispatcher
 Inherited[broadcast event] Wird ausgelöst, wenn Flash Player- oder die AIR-Anwendung den Fokus verliert und inaktiv wird.EventDispatcher
 InheritedWird ausgelöst, wenn ein Vorgangsaufruf fehlschlägt.AbstractOperation
 InheritedWird ausgelöst, wenn ein Vorgangsaufruf erfolgreich zurückgegeben wird.AbstractOperation
Eigenschaftendetails

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:

  • 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

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.

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

Das nachstehende Beispiel zeigt ein <mx:HTTPService>-Tag, das eine xmlDecode-Funktion spezifiziert:
   <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("");
}

Konstruktordetails

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.

Parameter
service:AbstractService (default = null) — Das Objekt, das den Diensttyp, beispielsweise HTTPMultiService, WebService oder RemoteObject definiert.
 
name:String (default = null) — Der Name des Dienstes.
Methodendetails

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ückgabewerte
Object — Die Header der HTTP-Anforderung.

getSerializationFilter

()Methode 
protected function getSerializationFilter():SerializationFilter

Gibt den Serialisierungsfilter zurück. Unterklassen können diese Methode überschreiben, um das Abrufen von Headern der HTTP-Anforderung zu steuern.

Rückgabewerte
SerializationFilter — Der Serialisierungsfilter.

sendBody

()Methode 
public function sendBody(parameters:Object):mx.rpc:AsyncToken

Parameter

parameters:Object

Rückgabewerte
mx.rpc:AsyncToken




[ 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.