Paket | mx.rpc.remoting |
Klasse | public dynamic class RemoteObject |
Vererbung | RemoteObject AbstractService Proxy |
Unterklassen | 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 | ||
concurrency : String
Wert, der angibt, wie mehrere Aufrufe desselben Dienstes verarbeitet werden sollen. | RemoteObject | ||
convertParametersHandler : Function
Optional; hauptsächlich für Frameworkentwickler bestimmt ist, die eine Funktion benötigen, deren Parameter bei jedem Remoteobjektaufruf aufgerufen werden. | RemoteObject | ||
convertResultHandler : Function
Eine optionale Funktion, die hauptsächlich für Frameworkentwickler bestimmt ist, die einen Hook installieren möchten, um die Ergebnisse eines Vorgangs zu verarbeiten, bevor die Ergebnisprozeduren benachrichtigt werden. | RemoteObject | ||
destination : String
Das Ziel des Dienstes. | AbstractService | ||
endpoint : String
Mithilfe dieser Eigenschaft können Entwickler einen Endpunkt für ein RemoteObject-Ziel angeben, ohne bei der Kompilierung auf eine Dienstkonfigurationsdatei zu verweisen oder programmgesteuert ein ChannelSet zu erstellen. | RemoteObject | ||
makeObjectsBindable : Boolean
Wenn dieser Wert true ist, wird die Umwandlung zurückgegebener anonymer Objekte in bindbare Objekte erzwungen. | RemoteObject | ||
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 | ||
showBusyCursor : Boolean
Wenn die Einstellung „true“ ist, wird ein Aktivitäten-Cursor angezeigt, während ein Dienst ausgeführt wird. | RemoteObject | ||
source : String
Ermöglicht die Angabe des Quellwerts auf dem Client; nicht unterstützt für Ziele, die JavaAdapter verwenden. | RemoteObject |
Methode | Definiert von | ||
---|---|---|---|
RemoteObject(destination:String = null)
Erstellt ein neues RemoteObject. | RemoteObject | ||
Trennt die Netzverbindung des Dienstes und entfernt sämtliche anstehende Anforderungsresponder. | AbstractService | ||
[override]
Gibt einen Vorgang mit dem jeweiligen Namen zurück. | RemoteObject | ||
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 | ||
[override]
Wenn ein Remoteobjekt durch einen externen Dienst wie ColdFusion Component (CFC) verwaltet wird, können ein Benutzername und ein Kennwort für den Authentifizierungsmechanismus des Remotedienstes gesetzt werden. | RemoteObject | ||
Stellt eine RemoteObject-Instanz als String dar, der wichtige Eigenschaften, wie Ziel-ID und zugewiesene Kanäle beschreibt. | RemoteObject |
concurrency | Eigenschaft |
concurrency:String
Sprachversion: | ActionScript 3.0 |
Produktversion: | Flex 3 |
Laufzeitversionen: | Flash Player 9, AIR 1.1 |
Wert, der angibt, wie mehrere Aufrufe desselben Dienstes verarbeitet werden sollen. Der Standardwert lautet „multiple“. Folgende Werte sind zulässig:
- „multiple“ - Existierende Anforderungen werden nicht gelöscht, der Entwickler ist dafür verantwortlich, dass die Kohärenz der Daten sichergestellt ist, indem er den Ereignis-Stream aufmerksam verwaltet. Dies ist die Standardeinstellung.
- „single“ - Es ist jeweils nur eine einzelne Anforderungen für die Methode zulässig; zusätzliche Anforderungen während eine Anforderung ansteht, erzeugen sofort einen Fehler auf dem Client und werden nicht an den Server übermittelt.
- „last“ - Eine Anforderung führt dazu, dass der Client ein Ergebnis oder einen Fehler für jegliche aktuelle anstehenden Anforderungen ignoriert. Nur das Ergebnis oder der Fehler der neuesten Anforderung wird auf dem Client ausgelöst. Dies kann die Ereignisverwaltung in der Clientanwendung vereinfachen, Sie sollten jedoch besonders darauf achten, dass dieser Modus nur dann verwendet wird, wenn Ergebnisse oder Fehler für Anforderungen gefahrlos ignoriert werden können.
Implementierung
public function get concurrency():String
public function set concurrency(value:String):void
convertParametersHandler | Eigenschaft |
public var convertParametersHandler:Function
Sprachversion: | ActionScript 3.0 |
Produktversion: | Flex 3 |
Laufzeitversionen: | Flash Player 9, AIR 1.1 |
Optional; hauptsächlich für Frameworkentwickler bestimmt ist, die eine Funktion benötigen, deren Parameter bei jedem Remoteobjektaufruf aufgerufen werden. Die Funktion verwendet ein Parameter-Array und gibt das möglicherweise geänderte Array zurück. Die Funktion sollte wie folgt definiert werden: function myParametersFunction(parameters:Array):Array
convertResultHandler | Eigenschaft |
public var convertResultHandler:Function
Sprachversion: | ActionScript 3.0 |
Produktversion: | Flex 3 |
Laufzeitversionen: | Flash Player 9, AIR 1.1 |
Eine optionale Funktion, die hauptsächlich für Frameworkentwickler bestimmt ist, die einen Hook installieren möchten, um die Ergebnisse eines Vorgangs zu verarbeiten, bevor die Ergebnisprozeduren benachrichtigt werden. Die Funktion sollte wie folgt definiert werden: function myConvertResultsFunction(result: operation:AbstractOperation):
Das Ergebnis wird gleich nach der makeObjectsBindable-Konvertierung übergeben, aber bevor das Ergebnisereignis erstellt wird.
endpoint | Eigenschaft |
endpoint:String
Sprachversion: | ActionScript 3.0 |
Produktversion: | Flex 3 |
Laufzeitversionen: | Flash Player 9, AIR 1.1 |
Mithilfe dieser Eigenschaft können Entwickler einen Endpunkt für ein RemoteObject-Ziel angeben, ohne bei der Kompilierung auf eine Dienstkonfigurationsdatei zu verweisen oder programmgesteuert ein ChannelSet zu erstellen. Sie überschreibt auch den existierenden ChannelSet, wenn eines für den RemoteObject-Dienst gesetzt wurde.
Wenn die Endpunkt-URL mit „https“ beginnt, wird ein SecureAMFChannel verwendet, anderenfalls ein AMFChannel. Zwei Spezial-Token, {server.name} und {server.port}, können in der Endpunkt-URL eingesetzt werden, wenn der Kanal den gleichen Servernamen und Port verwenden soll wie beim Laden des SWF.
Hinweis: Diese Eigenschaft ist beim Erstellen von AIR-Anwendungen erforderlich.
Implementierung
public function get endpoint():String
public function set endpoint(value:String):void
makeObjectsBindable | Eigenschaft |
makeObjectsBindable:Boolean
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
public function get makeObjectsBindable():Boolean
public function set makeObjectsBindable(value:Boolean):void
showBusyCursor | Eigenschaft |
showBusyCursor:Boolean
Sprachversion: | ActionScript 3.0 |
Produktversion: | Flex 3 |
Laufzeitversionen: | Flash Player 9, AIR 1.1 |
Wenn die Einstellung true
ist, wird ein Aktivitäten-Cursor angezeigt, während ein Dienst ausgeführt wird. Der Standardwert ist false
.
Implementierung
public function get showBusyCursor():Boolean
public function set showBusyCursor(value:Boolean):void
source | Eigenschaft |
source:String
Sprachversion: | ActionScript 3.0 |
Produktversion: | Flex 3 |
Laufzeitversionen: | Flash Player 9, AIR 1.1 |
Ermöglicht die Angabe des Quellwerts auf dem Client; nicht unterstützt für Ziele, die JavaAdapter verwenden. So können Sie mehrere Quellen angeben, auf die von einem einzelnen Ziel auf dem Server zugegriffen werden können.
Implementierung
public function get source():String
public function set source(value:String):void
RemoteObject | () | Konstruktor |
public function RemoteObject(destination:String = null)
Sprachversion: | ActionScript 3.0 |
Produktversion: | Flex 3 |
Laufzeitversionen: | Flash Player 9, AIR 1.1 |
Erstellt ein neues RemoteObject.
Parameterdestination:String (default = null ) — [optional] Ziel des RemoteObject; es sollte mit einem Zielnamen in der services-config.xml-Datei übereinstimmen.
|
getOperation | () | Methode |
override 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, wird während dieses Aufrufs ein neuer mx.rpc.remoting.Operation
erstellt. 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.
|
setRemoteCredentials | () | Methode |
override 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 |
Wenn ein Remoteobjekt durch einen externen Dienst wie ColdFusion Component (CFC) verwaltet wird, können ein Benutzername und ein Kennwort für den Authentifizierungsmechanismus des Remotedienstes gesetzt werden.
Parameter
remoteUsername:String — der Benutzername für den Zugriff auf den Remoteendpunkt
| |
remotePassword:String — das Kennwort für den Zugriff auf den Remoteendpunkt
| |
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“.
|
toString | () | Methode |
public function toString():String
Sprachversion: | ActionScript 3.0 |
Produktversion: | Flex 3 |
Laufzeitversionen: | Flash Player 9, AIR 1.1 |
Stellt eine RemoteObject-Instanz als String dar, der wichtige Eigenschaften, wie Ziel-ID und zugewiesene Kanäle beschreibt.
RückgabewerteString — Gibt eine Stringdarstellung einer RemoteObject-Instanz zurück.
|
Tue Jun 12 2018, 10:04 AM Z