RemoteObject

Package	mx.rpc.remoting.mxml
Classe	public dynamic class RemoteObject
Héritage	RemoteObject RemoteObject AbstractService Proxy
Implémente	IMXMLSupport, IMXMLObject

Version du langage:

ActionScript 3.0

Version du produit:

Flex 3

Versions du moteur d’exécution:

Flash Player 9, AIR 1.1

Utilisez la balise <mx:RemoteObject> pour représenter un objet HTTPService dans un fichier MXML. Cette balise permet d’accéder aux méthodes des objets Java à l’aide du codage AMF (Action Message Format).

Syntaxe MXML expanded

Masquer la syntaxe MXML

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.

Consulter les exemples

Propriétés publiques

Masquer les propriétés publiques héritées

Afficher les propriétés publiques héritées

	Propriété		Défini par
		channelSet : ChannelSet Fournit un accès à la classe ChannelSet utilisée par le service.	AbstractService
		concurrency : String Valeur indiquant comment traiter plusieurs appels au même service.	RemoteObject
		convertParametersHandler : Function Fonction facultative, destinée essentiellement aux développeurs de structure qui doivent installer une fonction devant être appelée avec les paramètres transmis à chaque invocation d’objet distant.	RemoteObject
		convertResultHandler : Function Fonction facultative, destinée essentiellement aux développeurs de structure qui doivent installer un crochet pour traiter les résultats d’une opération avant de notifier les gestionnaires de résultats.	RemoteObject
		destination : String Destination du service.	AbstractService
		endpoint : String Cette propriété permet au développeur de spécifier rapidement une extrémité pour une destination d’objet distant sans se référer à un fichier de configuration de services lors de la compilation ou créer par programmation une classe ChannelSet.	RemoteObject
		makeObjectsBindable : Boolean Lorsque cette valeur est true, les objets anonymes renvoyés sont forcés sur des objets liables.	RemoteObject
		managers : Array La propriété managers stocke une liste de gestionnaires de données qui modifient le comportement de ce service.	AbstractService
		operations : Object En général, le tableau Operations n’est défini que par le compilateur MXML si vous créez un service à l’aide d’une balise MXML.	AbstractService
		requestTimeout : int Fournit un accès au délai d’attente de demande en secondes pour les messages envoyés.	AbstractService
		showBusyCursor : Boolean Si true, un curseur occupé s’affiche lors de l’exécution d’un service.	RemoteObject
		source : String Vous permet de spécifier une valeur source sur le client ; non pris en charge pour les destinations utilisant l’adaptateur Java.	RemoteObject

Méthodes publiques

Masquer les méthodes publiques héritées

Afficher les méthodes publiques héritées

	Méthode		Défini par
		RemoteObject(destination:String = null) Crée une nouvelle classe RemoteObject.	RemoteObject
		disconnect():void Déconnecte la connexion réseau du service et supprime les répondeurs de demandes en attente.	AbstractService
		getOperation(name:String):AbstractOperation [override] Renvoie une opération du nom donné.	RemoteObject
		initialize():void Appelé pour initialiser le service.	AbstractService
		initialized(document:Object, id:String):void Appelé automatiquement par le compilateur MXML lorsque la classe RemoteObject est configurée à l’aide d’une balise.	RemoteObject
		logout():void Déconnecte l’utilisateur de la destination.	AbstractService
		setCredentials(username:String, password:String, charset:String = null):void Définit les informations d’identification pour la destination à laquelle le service accède lors de l’utilisation des services de données côté serveur.	AbstractService
		setRemoteCredentials(remoteUsername:String, remotePassword:String, charset:String = null):void [override] Si un objet distant est géré par un service externe (par exemple, un composant CFC (ColdFusion Component)), un nom d’utilisateur et un mot de passe peuvent être définis pour le mécanisme d’authentification de ce service distant.	RemoteObject
		toString():String Représente une instance de la classe RemoteObject en tant que chaîne et décrit des propriétés importantes telles que l’ID de destination et le jeu de canaux assigné.	RemoteObject

Evénements

Cliquez pour plus d’informations sur les événements

Masquer les événements hérités

Afficher les événements hérités

	Synthèse	Défini par
fault	L’événement fault est distribué lorsqu’un appel de service échoue et n’est pas traité par l’opération elle-même.	AbstractService
invoke	L’événement invoke est déclenché lorsqu’une opération de service est invoquée à condition qu’une erreur ne soit pas générée avant que le canal ne tente d’envoyer le message.	AbstractService
result	L’événement result est distribué lorsqu’un appel de service réussit et n’est pas traité par l’opération elle-même.	AbstractService

Détails du constructeur

()

Constructeur

public function RemoteObject(destination:String = null)

Version du langage:

ActionScript 3.0

Version du produit:

Flex 3

Versions du moteur d’exécution:

Flash Player 9, AIR 1.1

Crée une nouvelle classe RemoteObject.

Paramètres

destination:String (default = null) — la destination de la classe RemoteObject doit correspondre à un nom de destination dans le fichier services-config.xml.

Détails de la méthode

getOperation

()

méthode

override public function getOperation(name:String):AbstractOperation

Version du langage:

ActionScript 3.0

Version du produit:

Flex 3

Versions du moteur d’exécution:

Flash Player 9, AIR 1.1

Renvoie une opération du nom donné. Si l’opération n’a pas été créée auparavant, une nouvelle opération mx.rpc.remoting.mxml.Operation est créée lors de cet appel. Pour accéder aux opérations, il suffit en général simplement de les nommer après la variable de service (myService.someOperation), mais si le nom de votre opération correspond à une méthode définie sur le service (par exemple, setCredentials), vous pouvez utiliser cette méthode pour obtenir l’opération à la place.

Paramètres

name:String — Nom affichable de l’opération.

Valeur renvoyée

AbstractOperation — Opération qui s’exécute pour ce nom.

initialized

()

méthode

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

Version du langage:

ActionScript 3.0

Version du produit:

Flex 3

Versions du moteur d’exécution:

Flash Player 9, AIR 1.1

Appelé automatiquement par le compilateur MXML lorsque la classe RemoteObject est configurée à l’aide d’une balise. Si vous créez la classe RemoteObject via ActionScript, vous pouvez appeler cette méthode vous-même car elle est utile pour valider des arguments.

Paramètres

	`document:Object` — document MXML dans lequel cette classe RemoteObject réside.

	`id:String` — ID de cette classe RemoteObject au sein de ce document.

Exemples Comment utiliser cet exemple

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>

Informations juridiques | Politique de confidentialité en ligne

RemoteObject - AS3 Flex

Packagesx

Eléments du langage

Annexes

Package mx.rpc.remoting.mxml

RemoteObject

getOperation

initialized