| 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 |
| 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 | ||
| Methode | Definiert von | ||
|---|---|---|---|
AbstractService(destination:String = null)
Konstruktor. | AbstractService | ||
Trennt die Netzverbindung des Dienstes und entfernt sämtliche anstehende Anforderungsresponder. | AbstractService | ||
Gibt einen Vorgang mit dem jeweiligen Namen zurück. | AbstractService | ||
Aufgerufen, um den Dienst zu initialisieren. | AbstractService | ||
Meldet den Benutzer vom Ziel ab. | AbstractService | ||
Setzt die Benutzerdaten für den Zielpfad, auf den über den Dienst zugegriffen wird, wenn serverseitige Datendienste verwendet werden. | AbstractService | ||
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 | ||
| Ereignis | Übersicht | Definiert von | ||
|---|---|---|---|---|
| Das Fehlerereignis wird ausgelöst, wenn ein Dienstaufruf fehlschlägt und nicht vom Vorgang selbst verarbeitet wird. | AbstractService | |||
| 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 | |||
| Das Ergebnisereignis wird ausgelöst, wenn ein Dienstaufruf erfolgreich ist und nicht vom Vorgang selbst verarbeitet wird. | AbstractService | |||
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):voiddestination | 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):voidmanagers | 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):voidoperations | 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):voidrequestTimeout | 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):voidAbstractService | () | Konstruktor |
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.
|
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
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) |
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) |
fault | Ereignis |
mx.rpc.events.FaultEventEigenschaft 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 |
mx.rpc.events.InvokeEventEigenschaft 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 |
mx.rpc.events.ResultEventEigenschaft 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. |
Tue Jun 12 2018, 10:04 AM Z