RemoteObject

Paket	mx.rpc.remoting.mxml
Klasse	public dynamic class RemoteObject
Vererbung	RemoteObject RemoteObject AbstractService Proxy
Implementiert	IMXMLSupport, IMXMLObject

Sprachversion:

ActionScript 3.0

Produktversion:

Flex 3

Laufzeitversionen:

Flash Player 9, AIR 1.1

Verwenden Sie das <mx:RemoteObject>-Tag, um ein HTTPService-Objekt in einer MXML-Datei darzustellen. Dieses Tag gibt Zugriff auf die Methoden von Java-Objekten, die Action Message Format (AMF)-Kodierung verwenden.

MXML-Syntax expanded

MXML-Syntax ausblenden

The <mx:RemoteObject> tag accepts the following tag attributes:

 <mx:RemoteObject
  Properties
  concurrency="multiple|single|last"
  destination="No default."
  id="No default."
  endpoint="No default."
  showBusyCursor="false|true"
  source="No default." (currently, Adobe ColdFusion only)
  makeObjectsBindable="false|true"
  
  Events
  fault="No default."
  result="No default."  
 />

<mx:RemoteObject> can have multiple <mx:method> tags, which have the following tag attributes:

 <mx:method
  Properties
  concurrency="multiple|single|last"
  name="No default, required."
  makeObjectsBindable="false|true"
         
 Events
  fault="No default."
  result="No default."
 />

It then can have a single <mx:arguments> child tag which is an array of objects that is passed in order.

Beispiele anzeigen

Ö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
		initialized(document:Object, id:String):void Automatisch vom MXML-Compiler aufgerufen, wenn das RemoteObject mithilfe eines Tags eingerichtet wird.	RemoteObject
		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

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) — Das Ziel des RemoteObject; es muss 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 eine neue mx.rpc.remoting.mxml.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.

initialized

()

Methode

public function initialized(document:Object, id:String):void

Sprachversion:

ActionScript 3.0

Produktversion:

Flex 3

Laufzeitversionen:

Flash Player 9, AIR 1.1

Automatisch vom MXML-Compiler aufgerufen, wenn das RemoteObject mithilfe eines Tags eingerichtet wird. Wenn Sie ein RemoteObject über ActionScript erstellen, können Sie diese Methode aufrufen, da sie zum Überprüfen von Argumenten nützlich ist.

Parameter

	`document:Object` — das MXML-Dokument, in dem sich das RemoteObject befindet

	`id:String` — die ID des RemoteObject im Dokument

Beispiele Verwendung dieses Beispiels

RemoteObjectExample.mxml

<?xml version="1.0" encoding="utf-8"?>
<!-- Simple example to demonstrate the RemoteObject tag. -->
<s:Application xmlns:fx="http://ns.adobe.com/mxml/2009" 
     xmlns:s="library://ns.adobe.com/flex/spark" 
     xmlns:mx="library://ns.adobe.com/flex/mx">
        
    <!--  Make sure the Flex Data Services proxy-config.xml file contains the following definition.
    The Java class mypackage.stockquote.MyTicker.class must be available on the 
    web application's classpath.
        
    <destination id="MyRemoteObjectDest">
        <properties>
            <source>mypackage.stockquote.MyTicker</source>
            <scope>application</scope>
        </properties>
    </destination>
    -->
        
    <fx:Script>
        <![CDATA[
            import mx.controls.Alert;        
        ]]>    
    </fx:Script>

    <fx:Declarations>
        <mx:RemoteObject id="RO" destination="MyRemoteObjectDest"
            fault="Alert.show(event.fault.faultString), 'Error'">
            
            <mx:method name="GetQuote">
                <mx:arguments>
                    <symbol>{stockSymbol.text}</symbol>
                </mx:arguments>
            </mx:method>
        </mx:RemoteObject>
    </fx:Declarations>
        
    <mx:Panel title="RemoteObject Example" height="75%" width="75%" 
        paddingTop="10" paddingBottom="10" paddingLeft="10" paddingRight="10">
            
        <mx:Label width="100%"  color="blue"
            text="Enter a stock symbol to obtain a quote."/>
            
        <mx:TextInput id="stockSymbol" text="ADBE"/>
        <mx:Button label="Get Quote" click="RO.GetQuote.send()"/>
            
        <mx:Text htmlText="Company: {RO.GetQuote.lastResult.GetQuoteResult.StockQuote.Company}"/>
        <mx:Text htmlText="Current price: ${RO.GetQuote.lastResult.GetQuoteResult.StockQuote.Price}"/>
    </mx:Panel>    
</s:Application>

Rechtliche Hinweise | Onlinedatenschutzerklärung

RemoteObject - AS3 Flex

Klassen x

RemoteObject

getOperation

initialized