AbstractService

Paket	mx.rpc
Klasse	public dynamic class AbstractService
Vererbung	AbstractService Proxy
Implementiert	IEventDispatcher
Unterklassen	AbstractWebService, HTTPMultiService, ManagedRemoteService, RemoteObject

Sprachversion:

ActionScript 3.0

Produktversion:

Flex 3

Laufzeitversionen:

Flash Player 9, AIR 1.1

Die AbstractService-Klasse ist eine Basisklasse für HTTPMultiService-, WebService- und RemoteObject-Klassen. Diese Klasse erstellt die Vorgänge, welche die tatsächliche Ausführung der Remoteprozeduraufrufe vornehmen.

Öffentliche Eigenschaften

	Eigenschaft		Definiert von
		channelSet : ChannelSet Gibt Zugriff auf den vom Dienst verwendeten ChannelSet.	AbstractService
		destination : String Das Ziel des Dienstes.	AbstractService
		managers : Array In der Managereigenschaft wird eine Liste der Datenmanager gespeichert, die das Verhalten dieses Dienstes modifizieren.	AbstractService
		operations : Object Das Array von Vorgängen wird in der Regel nur vom MXML-Compiler gesetzt, wenn Sie einen Dienst mithilfe eines MXML-Tags erstellen.	AbstractService
		requestTimeout : int Gibt Zugriff auf die Zeitüberschreitung der Anforderung für übermittelte Meldungen.	AbstractService

Öffentliche Methoden

	Methode		Definiert von
		AbstractService(destination:String = null) Konstruktor.	AbstractService
		disconnect():void Trennt die Netzverbindung des Dienstes und entfernt sämtliche anstehende Anforderungsresponder.	AbstractService
		getOperation(name:String):AbstractOperation Gibt einen Vorgang mit dem jeweiligen Namen zurück.	AbstractService
		initialize():void Aufgerufen, um den Dienst zu initialisieren.	AbstractService
		logout():void Meldet den Benutzer vom Ziel ab.	AbstractService
		setCredentials(username:String, password:String, charset:String = null):void Setzt die Benutzerdaten für den Zielpfad, auf den über den Dienst zugegriffen wird, wenn serverseitige Datendienste verwendet werden.	AbstractService
		setRemoteCredentials(remoteUsername:String, remotePassword:String, charset:String = null):void Der Benutzername und das Kennwort für die Authentifizierung eines Benutzers beim Zugriff auf einen Remoteendpunkt einer Drittpartei wie zum Beispiel ein Webdienst über einen Proxy oder ein Remoteobjekt über einen benutzerdefinierten Adapter, wenn serverseitige Datendienste verwendet werden.	AbstractService

Ereignisse

Klicken Sie, um weitere Informationen zu Ereignissen zu erhalten.

	Übersicht	Definiert von
fault	Das Fehlerereignis wird ausgelöst, wenn ein Dienstaufruf fehlschlägt und nicht vom Vorgang selbst verarbeitet wird.	AbstractService
invoke	Das Aufrufereignis wird ausgelöst, wenn ein Dienstvorgang aufgerufen wird, es sei denn es wird ein Fehler ausgegeben, bevor der Kanal versucht, die Meldung zu schicken.	AbstractService
result	Das Ergebnisereignis wird ausgelöst, wenn ein Dienstaufruf erfolgreich ist und nicht vom Vorgang selbst verarbeitet wird.	AbstractService

Eigenschaftendetails

channelSet

Eigenschaft

channelSet:ChannelSet

Sprachversion:

ActionScript 3.0

Produktversion:

Flex 3

Laufzeitversionen:

Flash Player 9, AIR 1.1

Stellt einen Zugriff auf das vom Dienst verwendete ChannelSet bereit. Der ChannelSet kann manuell erstellt und zugewiesen werden oder wird dynamisch erstellt, wobei er die konfigurierten Kanäle als destination dieses Dienstes verwendet

Implementierung
public function get channelSet():ChannelSet
public function set channelSet(value:ChannelSet):void

destination

Eigenschaft

destination:String

Sprachversion:

ActionScript 3.0

Produktversion:

Flex 3

Laufzeitversionen:

Flash Player 9, AIR 1.1

Das Ziel des Dienstes. Dieser Wert sollte mit einem Zielnamen in der services-config.xml-Datei übereinstimmen.

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

managers

Eigenschaft

managers:Array

Sprachversion:

ActionScript 3.0

Produktversion:

Flex 3

Laufzeitversionen:

Flash Player 9, AIR 1.1

In der Managereigenschaft wird eine Liste der Datenmanager gespeichert, die das Verhalten dieses Dienstes modifizieren. Sie können diesen Hook verwenden, um eine oder mehr Managerkomponenten mit diesem Dienst zu verknüpfen. Wenn diese Eigenschaft gesetzt ist und die Manager eine Eigenschaft namens „service“ haben, erhält diese Eigenschaft den Wert dieses Dienstes. Wenn dieser Dienst initialisiert wird, wird auch die Initialisierungsmethode für sämtliche Managerkomponenten aufgerufen.

Implementierung
public function get managers():Array
public function set managers(value:Array):void

operations

Eigenschaft

operations:Object

Sprachversion:

ActionScript 3.0

Produktversion:

Flex 3

Laufzeitversionen:

Flash Player 9, AIR 1.1

Das Array von Vorgängen wird in der Regel nur vom MXML-Compiler gesetzt, wenn Sie einen Dienst mithilfe eines MXML-Tags erstellen.

Implementierung
public function get operations():Object
public function set operations(value:Object):void

requestTimeout

Eigenschaft

requestTimeout:int

Sprachversion:

ActionScript 3.0

Produktversion:

Flex 3

Laufzeitversionen:

Flash Player 9, AIR 1.1

Gibt Zugriff auf die Zeitüberschreitung der Anforderung für übermittelte Meldungen. 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

Konstruktordetails

()

Konstruktor

public function AbstractService(destination:String = null)

Sprachversion:

ActionScript 3.0

Produktversion:

Flex 3

Laufzeitversionen:

Flash Player 9, AIR 1.1

Konstruktor.

Parameter

destination:String (default = null) — Das Ziel des Dienstes.

Methodendetails

disconnect

()

Methode

public function disconnect():void

Sprachversion:

ActionScript 3.0

Produktversion:

Flex 3

Laufzeitversionen:

Flash Player 9, AIR 1.1

Trennt die Netzverbindung des Dienstes und entfernt sämtliche anstehende Anforderungsresponder. Diese Methode wartet nicht, bis anstehende Netzwerkvorgänge abgeschlossen sind.

getOperation

()

Methode

public function getOperation(name:String):AbstractOperation

Sprachversion:

ActionScript 3.0

Produktversion:

Flex 3

Laufzeitversionen:

Flash Player 9, AIR 1.1

Gibt einen Vorgang mit dem jeweiligen Namen zurück. Wenn der Vorgang nicht vorher erstellt wurde, sind Unterklassen für die Erstellung während dieses Aufrufs zuständig. Sie können in der Regel auf Vorgänge zugreifen, indem Sie sie einfach nach der Dienstvariable (mx.rpc.soap.mxml.Operation) benennen, doch wenn der Vorgangsname mit einer definierten Methode im Dienst übereinstimmt (z. B. setCredentials), können Sie diese Methode für den Zugriff auf den Vorgang verwenden.

Parameter

name:String — Name des Vorgangs.

Rückgabewerte

AbstractOperation — Für diesen Namen ausgeführter Vorgang.

initialize

()

Methode

public function initialize():void

Sprachversion:

ActionScript 3.0

Produktversion:

Flex 3

Laufzeitversionen:

Flash Player 9, AIR 1.1

Aufgerufen, um den Dienst zu initialisieren.

logout

()

Methode

public function logout():void

Sprachversion:

ActionScript 3.0

Produktversion:

Flex 3

Laufzeitversionen:

Flash Player 9, AIR 1.1

Meldet den Benutzer vom Ziel ab. Die Abmeldung von einem Zielpfad wird auf alle verbundenen Elemente angewandt, die denselben ChannelSet verwenden, der in der Serverkonfiguration angegeben ist. Wenn Sie z. B. über den my-rtmp-Kanal verbunden sind und sich über eine der RPC-Komponenten abmelden, werden alle über denselben ChannelSet verbundenen Elemente abgemeldet.

Hinweis: Adobe empfiehlt, statt dieser Methode die mx.messaging.ChannelSet.logout()-Methode zu verwenden.

Verwandte API-Elemente

mx.messaging.ChannelSet.logout()

setCredentials

()

Methode

public function setCredentials(username:String, password:String, charset:String = null):void

Sprachversion:

ActionScript 3.0

Produktversion:

Flex 3

Laufzeitversionen:

Flash Player 9, AIR 1.1

Setzt die Benutzerdaten für den Zielpfad, auf den über den Dienst zugegriffen wird, wenn serverseitige Datendienste verwendet werden. Die Benutzerdaten werden für alle Dienste angewandt, die über denselben ChannelSet verbunden sind. Beachten Sie, dass für Dienste, die einen Proxy oder den Adapter einer Drittpartei für einen Remoteendpunkt verwenden, setRemoteCredentials erforderlich ist.

Parameter

	`username:String` — Der Benutzername für das Ziel.

	`password:String` — Das Kennwort für das Ziel.

	`charset:String` (default = `null`) — Die zu verwendende Zeichensatzkodierung für die Kodierung der Daten. Der Standardwert ist null, d. h. dass der ältere Zeichensatz ISO Lateinisch-1 unterstützt wird. Der einzige unterstützte Zeichensatz ist „UTF-8“.

setRemoteCredentials

()

Methode

public function setRemoteCredentials(remoteUsername:String, remotePassword:String, charset:String = null):void

Sprachversion:

ActionScript 3.0

Produktversion:

Flex 3

Laufzeitversionen:

Flash Player 9, AIR 1.1

Der Benutzername und das Kennwort für die Authentifizierung eines Benutzers beim Zugriff auf einen Remoteendpunkt einer Drittpartei wie zum Beispiel ein Webdienst über einen Proxy oder ein Remoteobjekt über einen benutzerdefinierten Adapter, wenn serverseitige Datendienste verwendet werden.

Parameter

	`remoteUsername:String` — Der dem Remoteendpunkt zu übergebende Benutzername

	`remotePassword:String` — Das dem Remoteendpunkt zu übergebende Kennwort

	`charset:String` (default = `null`) — Die für die Kodierung der Remotedaten zu verwendende Zeichensatzkodierung. Der Standardwert ist null, d. h. dass der ältere Zeichensatz ISO Lateinisch-1 unterstützt wird. Der einzige unterstützte Zeichensatz ist „UTF-8“.

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

Das Fehlerereignis wird ausgelöst, wenn ein Dienstaufruf fehlschlägt und nicht vom Vorgang selbst verarbeitet wird.

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.

invoke

Ereignis

Ereignisobjekttyp: mx.rpc.events.InvokeEvent
Eigenschaft InvokeEvent.type = mx.rpc.events.InvokeEvent.INVOKE

Sprachversion:

ActionScript 3.0

Produktversion:

Flex 3

Laufzeitversionen:

Flash Player 9, AIR 1.1

Das Aufrufereignis wird ausgelöst, wenn ein Dienstvorgang aufgerufen wird, es sei denn es wird ein Fehler ausgegeben, bevor der Kanal versucht, die Meldung zu schicken.

Der INVOKE-Ereignistyp.

Die Eigenschaften des Ereignisobjekts haben die folgenden Werte:

Eigenschaft	Wert
`bubbles`	false
`token`	Token, das den einzelnen Aufruf der Methode darstellt. Wird im asynchronen Abschluss-Token-Muster verwendet.
`cancelable`	true
`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 Anforderungsmeldung.
`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

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

Das Ergebnisereignis wird ausgelöst, wenn ein Dienstaufruf erfolgreich ist und nicht vom Vorgang selbst verarbeitet 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

AbstractService - AS3 Flex

Paketex

Sprachelemente

Anhänge

Paket mx.rpc

channelSet

destination

managers

operations

requestTimeout