RemoteObject

パッケージ	mx.rpc.remoting.mxml
クラス	public dynamic class RemoteObject
継承	RemoteObject RemoteObject AbstractService Proxy
実装	IMXMLSupport, IMXMLObject

言語バージョン:

ActionScript 3.0

製品バージョン:

Flex 3

ランタイムバージョン:

Flash Player 9, AIR 1.1

<mx:RemoteObject> タグは、MXML ファイル内で HTTPService オブジェクトを表すために使用します。このタグを使用すると、Action Message Format（AMF）エンコーディングを使用する Java オブジェクトのメソッドにアクセスできます。

MXML シンタックス expanded

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.

例を表示

パブリックプロパティ

継承されるパブリックプロパティを隠す

継承されるパブリックプロパティを表示

	プロパティ		定義元
		channelSet : ChannelSet サービスが使用する ChannelSet へのアクセスを提供します。	AbstractService
		concurrency : String 同一サービスに対する複数の呼び出しの処理方法を示す値です。	RemoteObject
		convertParametersHandler : Function フレームワーク開発者には、各リモートオブジェクト起動で渡すパラメーターを指定して呼び出す関数をインストールする必要がある場合があります。そのような開発者を主な対象としたオプション関数です。	RemoteObject
		convertResultHandler : Function フレームワーク開発者には、操作の結果を処理するフックをインストールしてから結果ハンドラーを通知する必要がある場合があります。そのような開発者を主な対象としたオプション関数です。	RemoteObject
		destination : String サービスの宛先です。	AbstractService
		endpoint : String このプロパティを使用すると、開発者はコンパイル時にサービス設定ファイルを参照したり、プログラムで ChannelSet を作成したりすることなしに、RemoteObject 宛先のエンドポイントを簡単に指定できます。	RemoteObject
		makeObjectsBindable : Boolean この値が true の場合、返された匿名オブジェクトは強制的にバインド可能オブジェクトにされます。	RemoteObject
		managers : Array マネージャープロパティは、このサービスの動作を修正するデータマネージャーのリストを格納します。	AbstractService
		operations : Object 通常、Operations 配列は MXML タグを使ってサービスを作成した場合に、MXML コンパイラーによってのみ設定されます。	AbstractService
		requestTimeout : int 送信メッセージの要求タイムアウト時間（秒単位）に対するアクセスを提供します。	AbstractService
		showBusyCursor : Boolean true の場合、サービスの実行中にビジーカーソルが表示されます。	RemoteObject
		source : String クライアント上のソース値を指定することができます。JavaAdapter を使用する宛先にはサポートされていません。	RemoteObject

パブリックメソッド

継承されるパブリックメソッドを隠す

継承されるパブリックメソッドを表示

	メソッド		定義元
		RemoteObject(destination:String = null) 新しい RemoteObject を作成します。	RemoteObject
		disconnect():void サービスのネットワーク接続を切断して、保留されている要求のすべての応答側を削除します。	AbstractService
		getOperation(name:String):AbstractOperation [オーバーライド] 指定された名前の Operation を返します。	RemoteObject
		initialize():void サービスを初期化するために呼び出されます。	AbstractService
		initialized(document:Object, id:String):void RemoteObject がタグを使用して設定されている場合、MXML コンパイラーによって自動的に呼び出されます。	RemoteObject
		logout():void ユーザーを宛先からログアウトします。	AbstractService
		setCredentials(username:String, password:String, charset:String = null):void サーバー側で Data Services を使用している場合にサービスがアクセスする宛先の資格情報を設定します。	AbstractService
		setRemoteCredentials(remoteUsername:String, remotePassword:String, charset:String = null):void [オーバーライド] リモートオブジェクトが ColdFusion Component（CFC）などの外部サービスで管理されている場合、そのリモートサービスの認証メカニズムに対するユーザー名とパスワードを設定することができます。	RemoteObject
		toString():String RemoteObject のインスタンスを、宛先 ID や割り当てられたチャネルのセットなどの重要なプロパティを記述するストリングとして表します。	RemoteObject

イベント

イベントの詳細についてはここをクリックしてください

継承されるイベントを隠す

継承されるイベントを表示

	概要	定義元
fault	fault イベントは、サービス呼び出しが失敗した場合に送出されます。操作自体は、このイベントを処理しません。	AbstractService
invoke	チャネルがメッセージの送信を試行する前にエラーがスローされない限り、サービスの操作が呼び出されたときに、invoke イベントが送出されます。	AbstractService
result	result イベントは、サービス呼び出しから制御が正常に戻された場合に送出されます。操作自体は、このイベントを処理しません。	AbstractService

コンストラクターの詳細

()

コンストラクター

public function RemoteObject(destination:String = null)

言語バージョン:

ActionScript 3.0

製品バージョン:

Flex 3

ランタイムバージョン:

Flash Player 9, AIR 1.1

新しい RemoteObject を作成します。

パラメーター

destination:String (default = null) — RemoteObject の宛先。services-config.xml ファイル内の宛先名と一致する必要があります。

メソッドの詳細

getOperation

()

メソッド

override public function getOperation(name:String):AbstractOperation

言語バージョン:

ActionScript 3.0

製品バージョン:

Flex 3

ランタイムバージョン:

Flash Player 9, AIR 1.1

指定された名前の Operation を返します。Operation が事前に作成されなかった場合、新しい mx.rpc.remoting.mxml.Operation がこの呼び出し中に作成されます。 Operation は通常、その名前をサービス変数（myService.someOperation）の後に指定するだけでアクセスすることができますが、Operation 名がサービスに対して定義されているメソッドと一致している場合（例えば setCredentials）、代わりにこのメソッドを使って Operation を取得することができます。

パラメーター

name:String — Operation の名前です。

戻り値

AbstractOperation — この名前に対して実行される Operation です。

initialized

()

メソッド

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

言語バージョン:

ActionScript 3.0

製品バージョン:

Flex 3

ランタイムバージョン:

Flash Player 9, AIR 1.1

RemoteObject がタグを使用して設定されている場合、MXML コンパイラーによって自動的に呼び出されます。 ActionScript によって RemoteObject を作成する場合、このメソッドはすべてのパラメーターを検証する際に役立つため、このメソッドを呼び出すことをお勧めします。

パラメーター

	`document:Object` — この RemoteObject が存在する MXML ドキュメントです。

	`id:String` — ドキュメント内部でのこの RemoteObject の ID です。

例この例の使用方法

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>

法律上の注意 | プライバシーポリシー

RemoteObject - AS3 Flex

パッケージx

言語エレメント

付録

パッケージ mx.rpc.remoting.mxml

RemoteObject

getOperation

initialized