RemoteObject

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

Die RemoteObject-Klasse gibt Zugriff auf die Klassen auf einem Remoteanwendungsserver.

Öffentliche Eigenschaften

Vererbte öffentliche Eigenschaften ausblenden

Vererbte öffentliche Eigenschaften anzeigen

	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

Öffentliche Methoden

Vererbte öffentliche Methoden ausblenden

Vererbte öffentliche Methoden anzeigen

	Methode		Definiert von
		RemoteObject(destination:String = null) Erstellt ein neues RemoteObject.	RemoteObject
		disconnect():void Trennt die Netzverbindung des Dienstes und entfernt sämtliche anstehende Anforderungsresponder.	AbstractService
		getOperation(name:String):AbstractOperation [override] Gibt einen Vorgang mit dem jeweiligen Namen zurück.	RemoteObject
		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 [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
		toString():String Stellt eine RemoteObject-Instanz als String dar, der wichtige Eigenschaften, wie Ziel-ID und zugewiesene Kanäle beschreibt.	RemoteObject

Ereignisse

Klicken Sie, um weitere Informationen zu Ereignissen zu erhalten.

Vererbte Ereignisse ausblenden

Vererbte Ereignisse anzeigen

	Ü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

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

Konstruktordetails

()

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.

Parameter

destination:String (default = null) — [optional] Ziel des RemoteObject; es sollte mit einem Zielnamen in der services-config.xml-Datei übereinstimmen.

Methodendetails

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.

Rückgabewerte

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ückgabewerte

String — Gibt eine Stringdarstellung einer RemoteObject-Instanz zurück.

Rechtliche Hinweise | Onlinedatenschutzerklärung

RemoteObject - AS3 Flex

Klassen x

concurrency

convertParametersHandler

convertResultHandler

endpoint

makeObjectsBindable

showBusyCursor

source

RemoteObject

getOperation

setRemoteCredentials

toString