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 

Operation  - AS3 Flex

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

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

Ein Vorgang, der speziell von einem HTTPMultiService 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
 InheritedargumentNames : 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
[override] Wert, der angibt, wie mehrere Aufrufe derselben Dienstmethode verarbeitet werden sollen.
Operation
 Inheritedconstructor : Object
Ein Verweis auf das Klassenobjekt oder die Konstruktorfunktion für eine angegebene Objektinstanz.
Object
  contentType : String
[override] Art des Inhalts für Dienstanforderungen.
Operation
 Inheritedheaders : Object
Benutzerdefinierte HTTP-Header, die an Endpunkte von Drittparteien gesendet werden sollen.
AbstractOperation
 InheritedlastResult : Object
[schreibgeschützt] Das Ergebnis des letzten Aufrufs.
AbstractInvoker
  makeObjectsBindable : Boolean
[override] Wenn dieser Wert true ist, wird die Umwandlung zurückgegebener anonymer Objekte in bindbare Objekte erzwungen.
Operation
  method : String
[override] HTTP-Methode zum Senden der Anforderung.
Operation
 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
 Inheritedrequest : Object
Objekt aus Namen-/Wertpaaren, die als Parameter der URL verwendet werden.
AbstractOperation
 InheritedrequestTimeout : 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
[override] Wert, der angibt, wie die Serialisierung des vom HTTP-Aufruf zurückgegebene Ergebnisses aufgehoben werden soll.
Operation
 InheritedresultType : Class
Gibt einen optionalen Rückgabetyp für den Vorgang an.
AbstractInvoker
  rootURL : String
[override] Die Stamm-URL wird verwendet, um die URL für einen spezifischen HTTP-Dienstvorgang zu berechnen, wenn die relative URL für den Vorgang angegeben wird.
Operation
 InheritedserializationFilter : 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
[override] Wenn die Einstellung „true“ ist, wird ein Aktivitäten-Cursor angezeigt, während ein Dienst ausgeführt wird.
Operation
 Inheritedurl : String
Position des Dienstes.
AbstractOperation
  useProxy : Boolean
[override] Gibt an, ob der Flex-Proxy-Dienst verwendet werden soll.
Operation
 InheritedxmlDecode : Function
ActionScript-Funktion, die zum Dekodieren eines Dienstergebnisses aus XML verwendet wird.
AbstractOperation
 InheritedxmlEncode : Function
ActionScript-Funktion, die zum Dekodieren einer Dienstanforderung als XML verwendet wird.
AbstractOperation
Öffentliche Methoden
 MethodeDefiniert von
  
Operation(service:mx.rpc.http:HTTPMultiService = null, name:String = null)
Erstellt einen neuen Vorgang.
Operation
 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
  
[override] Führt den http-Vorgang aus.
Operation
 Inherited
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
 Inherited
Gibt die Header der HTTP-Anforderung zurück.
AbstractOperation
 Inherited
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

concurrency

Eigenschaft
concurrency:String[override]

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

Wert, der angibt, wie mehrere Aufrufe derselben Dienstmethode 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
    override public function get concurrency():String
    override public function set concurrency(value:String):void

contentType

Eigenschaft 
contentType:String[override]

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
    override public function get contentType():String
    override public function set contentType(value:String):void

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[override]

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
    override public function get method():String
    override public function set method(value:String):void

resultFormat

Eigenschaft 
resultFormat:String[override]

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
    override public function get resultFormat():String
    override public function set resultFormat(value:String):void

rootURL

Eigenschaft 
rootURL:String[override]

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

Die Stamm-URL wird verwendet, um die URL für einen spezifischen HTTP-Dienstvorgang zu berechnen, wenn die relative URL für den Vorgang angegeben wird. Der Name des rootURL-Ordners wird jeder relativen URL für den Vorgang vorangestellt. Es ist in der Regel praktischer, die baseURL zu setzen, da diese den Ordnernamen direkt angibt, während die rootURL den Namen der Datei mit vorangestelltem Ordnernamen angibt. Wenn weder die rootURL noch die baseURL ausdrücklich angegeben sind, wird der Name der SWF-Datei den relativen Pfadnamen vorangestellt.



Implementierung
    override public function get rootURL():String
    override public function set rootURL(value:String):void

showBusyCursor

Eigenschaft 
showBusyCursor:Boolean[override]

Wenn die Einstellung true ist, wird ein Aktivitäten-Cursor angezeigt, während ein Dienst ausgeführt wird. Der Standardwert ist false.



Implementierung
    override public function get showBusyCursor():Boolean
    override public function set showBusyCursor(value:Boolean):void

useProxy

Eigenschaft 
useProxy:Boolean[override]

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.



Implementierung
    override public function get useProxy():Boolean
    override public function set useProxy(value:Boolean):void
Konstruktordetails

Operation

()Konstruktor
public function Operation(service:mx.rpc.http:HTTPMultiService = 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:mx.rpc.http:HTTPMultiService (default = null) — Das HTTPMultiService-Objekt, das diesen Dienst definiert.
 
name:String (default = null) — Der Name des Dienstes.
Methodendetails

send

()Methode
override public function send(... args):mx.rpc:AsyncToken

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

Führt den http-Vorgang aus. Sämtliche übergebenen Argumente werden als Bestandteil des Vorgangsaufrufs übergeben. Wenn keine Argumente übergeben wurden, wird die Argumenteigenschaft der Klasse als Quelle der Parameter verwendet. HTTP-Vorgänge übernehmen normalerweise benannte Parameter, nicht jedoch Positionsparameter. Zur Übergabe der Namen dieser Parameter können Sie auch die argumentNames-Eigenschaft auf ein Array der Eigenschaftsnamen setzen.

Parameter

... args — Optionale Argumente, die als Bestandteil des Methodenaufrufs übergeben werden. Wenn keine Argumente übergeben wurden, wird das Argumentobjekt als Quelle der Parameter verwendet.

Rückgabewerte
mx.rpc:AsyncToken — AsyncToken Call unter Verwendung des asynchronen Abschluss-Token-Musters. Dasselbe Objekt steht in den result- und fault-Ereignissen der token-Eigenschaft zur Verfügung.




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