CallResponder - Adobe ActionScript® 3 (AS3 Flex) API-Referenz

Paket	mx.rpc
Klasse	public class CallResponder
Vererbung	CallResponder EventDispatcher Object
Implementiert	IResponder

Sprachversion:

ActionScript 3.0

Produktversion:

Flex 3

Laufzeitversionen:

Flash Player 9, AIR 1.1

Mithilfe dieser Komponente können die Ergebnisse für asynchrone Aufrufe verwaltet werden, die durch RPC-basierte Dienste, normalerweise MXML-Komponenten, erfolgen. Während jeder einzelne Dienst und Vorgang Ergebnis- und Fehlerereignisse auslöst, wird derselbe Vorgang oft in verschiedenen Teilen der Anwendung benötigt. Die Verwendung eines Ereignis-Listeners oder lastResult-Werts in der gesamten Anwendung kann mühsam sein. Anstatt zwei Dienstkomponenten zu erstellen, die auf denselben Dienst verweisen, können Sie einen einfachen CallResponder verwenden, um Ereignis-Listener und lastResult-Wert für einen bestimmten Aufruf eines Dienstes zu verwalten.

Sie setzen die Token-Eigenschaft dieser Komponente auf das AsyncToken, das vom Dienst zurückgegeben wurde. Sie können dann Ereignis-Listener zu dieser Komponente hinzufügen, anstatt sie jedem zurückgegebenen AsyncToken hinzuzufügen müssen. Diese Komponente behält auch die lastResult-Eigenschaft bei, die eine Kopie des Werts ist, der vom letzten erfolgreichen Ergebnisereignis durch ein Token zurückgegeben wurde, das von diesem Dienst überwacht wird. Obwohl Sie entweder callResponder.token.result oder callResponder.lastResult binden können, wird Letzteres beibehalten, während ein zweiter Aufruf desselben Dienstes erfolgt und der erste rückgestellt wird, sobald ein neuer Dienstaufruf gestartet wird.

Öffentliche Eigenschaften

Vererbte öffentliche Eigenschaften ausblenden

Vererbte öffentliche Eigenschaften anzeigen

	Eigenschaft		Definiert von
		constructor : Object Ein Verweis auf das Klassenobjekt oder die Konstruktorfunktion für eine angegebene Objektinstanz.	Object
		lastResult : * In dieser Eigenschaft wird die Ergebniseigenschaft des Tokens immer dann gespeichert, wenn es ein erfolgreiches Ergebnis liefert.	CallResponder
		token : mx.rpc:AsyncToken Jeder CallResponder löst Ergebnis- und Fehlerereignisse aus, die von einem einzelnen Token empfangen werden.	CallResponder

Öffentliche Methoden

Vererbte öffentliche Methoden ausblenden

Vererbte öffentliche Methoden anzeigen

	Methode		Definiert von
		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
		dispatchEvent(event:Event):Boolean Sendet ein Ereignis in den Ereignisablauf.	EventDispatcher
		fault(data:Object):void Diese Methode wird durch das AsyncToken aufgerufen, wenn es dem CallResponder ein FaultEvent liefern will.	CallResponder
		hasEventListener(type:String):Boolean Überprüft, ob das EventDispatcher-Objekt Listener für einen bestimmten Ereignistyp registriert hat.	EventDispatcher
		hasOwnProperty(name:String):Boolean Gibt an, ob für ein Objekt eine bestimmte Eigenschaft definiert wurde.	Object
		isPrototypeOf(theClass:Object):Boolean Gibt an, ob eine Instanz der Object-Klasse in der Prototypkette des Objekts vorhanden ist, das als Parameter angegeben wurde.	Object
		propertyIsEnumerable(name:String):Boolean Gibt an, ob die angegebene Eigenschaft vorhanden ist und durchlaufen werden kann.	Object
		removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void Entfernt einen Listener aus dem EventDispatcher-Objekt.	EventDispatcher
		result(data:Object):void Diese Methode wird durch das AsyncToken aufgerufen, wenn es dem CallResponder ein ResultEvent liefern will.	CallResponder
		setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void Legt die Verfügbarkeit einer dynamischen Eigenschaft für Schleifenoperationen fest.	Object
		toLocaleString():String Gibt die Stringdarstellung dieses Objekts zurück, formatiert entsprechend den Konventionen des Gebietsschemas.	Object
		toString():String Gibt das angegebene Objekt als String zurück.	Object
		valueOf():Object Gibt den Grundwert des angegebenen Objekts zurück.	Object
		willTrigger(type:String):Boolean Ü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

Klicken Sie, um weitere Informationen zu Ereignissen zu erhalten.

Vererbte Ereignisse ausblenden

Vererbte Ereignisse anzeigen

	Übersicht	Definiert von
activate	[broadcast event] Wird ausgelöst, wenn Flash Player oder eine AIR-Anwendung den Betriebssystemfokus erhält und aktiv wird.	EventDispatcher
deactivate	[broadcast event] Wird ausgelöst, wenn Flash Player- oder die AIR-Anwendung den Fokus verliert und inaktiv wird.	EventDispatcher
fault	Wird ausgelöst, wenn ein Vorgangsaufruf fehlschlägt.	CallResponder
result	Wird ausgelöst, wenn ein Vorgangsaufruf erfolgreich zurückgegeben wird.	CallResponder

Eigenschaftendetails

lastResult

Eigenschaft

lastResult:*

Sprachversion:

ActionScript 3.0

Produktversion:

Flex 3

Laufzeitversionen:

Flash Player 9, AIR 1.1

In dieser Eigenschaft wird die Ergebniseigenschaft des Tokens immer dann gespeichert, wenn es ein erfolgreiches Ergebnis liefert. Sie können für die Bindung und den Zugriff diese Eigenschaft anstatt der token.result-Eigenschaft verwenden, damit Ihr Code nicht bemerkt, dass der Wert des zweiten und darauf folgenden Aufrufs einer bestimmten Dienstmethode gelöscht wird. Wenn ein Fehler auftritt, bleibt dieser Wert auf das letzte erfolgreiche von einem Token zurückgegebene Ergebnis eingestellt, das von diesem CallResponder überwacht wird.

Diese Eigenschaft kann als Quelle für die Datenbindung verwendet werden. Beim Ändern dieser Eigenschaft wird das propertyChange -Ereignis ausgelöst.

Implementierung
public function get lastResult():*
public function set lastResult(value:any):void

token

Eigenschaft

token:mx.rpc:AsyncToken

Sprachversion:

ActionScript 3.0

Produktversion:

Flex 3

Laufzeitversionen:

Flash Player 9, AIR 1.1

Jeder CallResponder löst Ergebnis- und Fehlerereignisse aus, die von einem einzelnen Token empfangen werden. Dieser Eigenschaftswert gibt das Token an. Normalerweise setzen Sie diese Eigenschaft auf das AsyncToken-Objekt, das vom Dienst zurückgegeben wurde.

Diese Eigenschaft kann als Quelle für die Datenbindung verwendet werden. Beim Ändern dieser Eigenschaft wird das propertyChange -Ereignis ausgelöst.

Implementierung
public function get token():mx.rpc:AsyncToken
public function set token(value:mx.rpc:AsyncToken):void

Methodendetails

fault

()

Methode

public function fault(data:Object):void

Sprachversion:

ActionScript 3.0

Produktversion:

Flex 3

Laufzeitversionen:

Flash Player 9, AIR 1.1

Diese Methode wird durch das AsyncToken aufgerufen, wenn es dem CallResponder ein FaultEvent liefern will. Sie rufen diese Methode nicht direkt auf.

Parameter

data:Object — Vom AsyncToken geliefertes FaultEvent

result

()

Methode

public function result(data:Object):void

Sprachversion:

ActionScript 3.0

Produktversion:

Flex 3

Laufzeitversionen:

Flash Player 9, AIR 1.1

Diese Methode wird durch das AsyncToken aufgerufen, wenn es dem CallResponder ein ResultEvent liefern will. Sie rufen diese Methode nicht direkt auf.

Parameter

data:Object — Vom AsyncToken geliefertes ResultEvent

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:

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.

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:

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.

Rechtliche Hinweise | Onlinedatenschutzerklärung

CallResponder - AS3 Flex

Klassen x

lastResult

token

fault

result

fault

result