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 

AbstractOperation  - AS3 Flex

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

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

Die AbstractOperation-Klasse stellt eine einzelne Methode in einem Dienst dar. Ein Vorgang kann entweder durch Aufrufen der Funktion mit demselben Namen im Dienst aufgerufen werden, oder durch den Zugriff auf den Vorgang als Eigenschaft im Dienst und durch Aufruf der send()-Methode.

Verwandte API-Elemente



Öffentliche Eigenschaften
 EigenschaftDefiniert von
  arguments : Object
Die Argumente, die dem aufgerufenen Vorgang übergeben werden müssen.
AbstractOperation
 Inheritedconstructor : Object
Ein Verweis auf das Klassenobjekt oder die Konstruktorfunktion für eine angegebene Objektinstanz.
Object
 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
  name : 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
  properties : Object
Dieser Hook ist hauptsächlich für Frameworkentwickler zum Registrieren von zusätzlichen benutzerdefinierten Eigenschaften für den Vorgang gedacht.
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
 InheritedresultType : Class
Gibt einen optionalen Rückgabetyp für den Vorgang an.
AbstractInvoker
  service : AbstractService
[schreibgeschützt] Bietet praktischen Zugriff auf den Dienst, in dem der Vorgang aufgerufen 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
  
Führt die Methode aus.
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
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
  Wird ausgelöst, wenn ein Vorgangsaufruf fehlschlägt.AbstractOperation
  Wird ausgelöst, wenn ein Vorgangsaufruf erfolgreich zurückgegeben wird.AbstractOperation
Eigenschaftendetails

arguments

Eigenschaft
public var arguments:Object

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

Die Argumente, die dem aufgerufenen Vorgang übergeben werden müssen. Wenn Sie die send()-Methode ohne Parameter aufrufen, wird ein auf diesem Objekt basierendes Array gesendet. Wenn Sie die send()-Methode mit Parametern aufrufen (oder die Funktion direkt im Dienst aufrufen), werden diese Parameter verwendet anstatt was auch immer in dieser Eigenschaft gespeichert ist. Für RemoteObject-Vorgänge bestimmt das verknüpfte argumentNames-Array die Reihenfolge der übergebenen Argumente.

name

Eigenschaft 
name:String

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

Der Name des Vorgangs. So wird auf den Vorgang außerhalb des Dienstes zugegriffen. Die Einstellung kann nur einmal erfolgen.



Implementierung
    public function get name():String
    public function set name(value:String):void

properties

Eigenschaft 
public var properties:Object

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

Dieser Hook ist hauptsächlich für Frameworkentwickler zum Registrieren von zusätzlichen benutzerdefinierten Eigenschaften für den Vorgang gedacht.

service

Eigenschaft 
service:AbstractService  [schreibgeschützt]

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

Bietet praktischen Zugriff auf den Dienst, in dem der Vorgang aufgerufen wird. Beachten Sie, dass der Dienst nach dem Erstellen des Vorgangs nicht geändert werden kann.



Implementierung
    public function get service():AbstractService
Konstruktordetails

AbstractOperation

()Konstruktor
public function AbstractOperation(service:AbstractService = null, name:String = null)

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

Erstellt einen neuen Vorgang. Dies erfolgt in der Regel direkt durch den MXML-Compiler oder automatisch durch den Dienst, wenn auf einen unbekannten Vorgang zugegriffen wurde. Es ist für Entwickler nicht ratsam, diesen Konstruktor direkt zu verwenden.

Parameter
service:AbstractService (default = null) — Der Dienst, in dem der Vorgang aufgerufen wird.
 
name:String (default = null) — Der Name des neuen Vorgangs.
Methodendetails

send

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

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

Führt die Methode aus. Jegliche übergebene Argumente, werden als Bestandteil des Methodenaufrufs übergeben. Wenn keine Argumente übergeben wurden, wird das Argumentobjekt als Quelle der Parameter verwendet.

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-Objekt. Dasselbe Objekt steht in den result- und fault-Ereignissen der token-Eigenschaft zur Verfügung.
Ereignisdetails

fault

Ereignis
Ereignisobjekttyp: 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 Vorgangsaufruf fehlschlägt.

Der FAULT-Ereignistyp.

Die Eigenschaften des Ereignisobjekts haben die folgenden Werte:

EigenschaftWert
bubblesfalse
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.
currentTargetDas 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.
faultDas Fault-Objekt, das die Details über den Auslöser dieses Ereignisses enthält.
messageDie mit diesem Ereignis verknüpfte Meldung.
targetDas 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.
tokenDas Token, das den Aufruf der Methode darstellt. Wird im asynchronen Abschluss-Token-Muster verwendet.

result

Ereignis  
Ereignisobjekttyp: 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 Vorgangsaufruf erfolgreich zurückgegeben wird.

Der RESULT-Ereignistyp.

Die Eigenschaften des Ereignisobjekts haben die folgenden Werte:

EigenschaftWert
bubblesfalse
cancelabletrue, preventDefault() aus der verknüpften responder.result-Methode des Token verhindert, dass der Dienst oder der Vorgang dieses Ereignis auslöst.
currentTargetDas 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.
targetDas 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.
resultVom RPC-Aufruf zurückgegebenes Ergebnis.
tokenToken, das den einzelnen Aufruf der Methode darstellt. Wird im asynchronen Abschluss-Token-Muster verwendet.




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