mx.rpc.remoting.mxml.RemoteObject (Flex™ 2 リファレンスガイド)

(Flex Data Services のみ)

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

<mx:RemoteObject> タグにより、Action Message Format (AMF) エンコーディングを使用する Java オブジェクトのメソッドにアクセスできます。

MXML シンタックス expanded

MXML シンタックスの非表示

<mx:RemoteObject> タグでは、以下のタグ属性が使用できます。

 <mx:RemoteObject プロパティ concurrency="multiple|single|last" destination="デフォルト値なし" id="デフォルト値なし" endpoint="デフォルト値なし" showBusyCursor="false|true" source="デフォルト値なし" (現在、Macromedia ColdFusion のみ) makeObjectsBindable="false|true"
  
イベント fault="デフォルト値なし" result="デフォルト値なし" />

<mx:RemoteObject> は、複数の <mx:method> タグを持つことができます。このタグには、以下のタグ属性があります。

 <mx:method プロパティ concurrency="multiple|single|last" name="デフォルト値なし、必須" makeObjectsBindable="false|true"
         
イベント fault="デフォルト値なし" result="デフォルト値なし" />

単一の <mx:arguments> 子タグを持つことができます。これは、順番に渡されるオブジェクトの配列です。

関連項目

パブリックプロパティ

	プロパティ		定義
		channelSet : ChannelSet サービスが使用する ChannelSet へのアクセスを提供します。	AbstractService
		concurrency : String 同一サービスに対する複数の呼び出しの処理方法を示す値です。	RemoteObject
		constructor : Object 特定のオブジェクトインスタンスのクラスオブジェクトまたはコンストラクタ関数への参照です。	Object
		destination : String サービスの宛先です。	AbstractService
		endpoint : String このプロパティを使用すると、開発者はコンパイル時にサービス設定ファイルを参照したり、プログラムで ChannelSet を作成することなしに、RemoteObject 宛先のエンドポイントを簡単に指定できます。	RemoteObject
		makeObjectsBindable : Boolean この値が true の場合、返された匿名オブジェクトは強制的にバインド可能オブジェクトにされます。	RemoteObject
		operations : Object 通常、Operations 配列は MXML タグを使ってサービスを作成した場合に、MXML コンパイラによってのみ設定されます。	AbstractService
		prototype : Object [static] クラスまたは関数オブジェクトのプロトタイプオブジェクトへの参照です。	Object
		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 を返します。	AbstractService
		hasOwnProperty(name:String):Boolean オブジェクトに指定されたプロパティが定義されているかどうかを示します。	Object
		initialized(document:Object, id:String):void RemoteObject がタグを使用して設定されている場合、MXML コンパイラによって自動的に呼び出されます。	RemoteObject
		isPrototypeOf(theClass:Object):Boolean Object クラスのインスタンスが、パラメータとして指定されたオブジェクトのプロトタイプチェーン内にあるかどうかを示します。	Object
		logout():void ユーザーを宛先からログアウトします。	AbstractService
		propertyIsEnumerable(name:String):Boolean 指定されたプロパティが存在し、列挙可能かどうかを示します。	Object
		setCredentials(username:String, password:String):void サービスがアクセスする宛先の証明書を設定します。	AbstractService
		setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void ループ処理に対するダイナミックプロパティの可用性を設定します。	Object
		setRemoteCredentials(remoteUsername:String, remotePassword:String):void リモートオブジェクトが ColdFusion Component (CFC) などの外部サービスで管理されている場合、そのリモートサービスの認証メカニズムに対するユーザー名とパスワードを設定することができます。	RemoteObject
		toString():String RemoteObject のインスタンスを、宛先 ID や割り当てられたチャンネルのセットなどの重要なプロパティを記述するストリングとして表します。	RemoteObject
		valueOf():Object 指定されたオブジェクトのプリミティブ値を返します。	Object

Protectedメソッド

継承される Protected メソッドの表示

	メソッド		定義
		callProperty(name:, ... rest): 関数として呼び出し可能なオブジェクトプロパティの動作を上書きします。	Proxy
		deleteProperty(name:*):Boolean プロパティを削除する要求を上書きします。	Proxy
		getDescendants(name:): `descendant` 演算子の使用をオーバーライドします。	Proxy
		getProperty(name:): プロパティの値に対する要求を上書きします。	Proxy
		hasProperty(name:*):Boolean オブジェクトが特定のプロパティを持っているかどうかを名前ごとにチェックする要求を上書きします。	Proxy
		isAttribute(name:*):Boolean 指定された QName が属性としてマークされているかどうかを確認します。	Proxy
		nextName(index:int):String インデックス番号を使用して、プロキシになるオブジェクトのプロパティを列挙してプロパティ名を取得できます。	Proxy
		nextNameIndex(index:int):int インデックス番号を使用して、プロキシになるオブジェクトのプロパティを列挙できます。	Proxy
		nextValue(index:int):* インデックス番号を使用して、プロキシになるオブジェクトのプロパティを列挙してプロパティ値を取得できます。	Proxy
		setProperty(name:, value:):void プロパティの値を変更する呼び出しを上書きします。	Proxy

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

プロパティの詳細

concurrency

プロパティ

public var concurrency:String

同一サービスに対する複数の呼び出しの処理方法を示す値です。デフォルト値は multiple です。使用できる値は次のとおりです。

multiple: 既存の要求はキャンセルされません。返されるデータは開発者が責任を持って、イベントストリームを慎重に管理することで整合性を確保する必要があります。これはデフォルトの設定です。
single: 処理では一度に 1 つの要求のみが認められ、複数の要求を送信すると処理が失敗します。
last: 要求を送信すると、既存の要求がすべてキャンセルされます。

endpoint

プロパティ

endpoint:String [read-write]

このプロパティを使用すると、開発者はコンパイル時にサービス設定ファイルを参照したり、プログラムで ChannelSet を作成することなしに、RemoteObject 宛先のエンドポイントを簡単に指定できます。また、既存の ChannelSet が RemoteObject サービスに設定されている場合、このプロパティはその ChannelSet をオーバーライドします。

エンドポイント URL が "https" で始まっている場合、SecureAMFChannel が使用されます。それ以外の場合は、AMFChannel が使用されます。エンドポイント URL で 2 つの特別なトークン、{server.name} と {server.port} を使用すると、SWF のロードに使用されたサーバー名とポートをチャンネルが使用するように指定できます。

実装
public function get endpoint():String
public function set endpoint(value:String):void

showBusyCursor

プロパティ

showBusyCursor:Boolean [read-write]

true の場合、サービスの実行中にビジーカーソルが表示されます。デフォルト値は false です。

実装
public function get showBusyCursor():Boolean
public function set showBusyCursor(value:Boolean):void

コンストラクタの詳細

RemoteObject

()

コンストラクタ

public 関数 RemoteObject(destination:String = null)

新しい RemoteObject を作成します。

パラメータ

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

メソッドの詳細

initialized

()

メソッド

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

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

パラメータ

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

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

例

RemoteObjectExample

<?xml version="1.0"?>
<!-- Simple example to demonstrate the RemoteObject tag. -->
<mx:Application xmlns:mx="http://www.adobe.com/2006/mxml">

<!--  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>
-->

    <mx:Script>
        <![CDATA[
            import mx.controls.Alert;        
        ]]>    
    </mx:Script>

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

    <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>    
</mx:Application>

現在のページ: http://livedocs.adobe.com/flex/2_jp/langref/mx/rpc/remoting/mxml/RemoteObject.html

Adobe^® Flex™ 2 リファレンスガイド		すべてのパッケージ \| すべてのクラス \| 言語エレメント \| 索引 \| 付録 \| 規則 \| フレーム内に表示フレームなしバージョン
Class RemoteObject	プロパティ \| メソッド \| イベント \| 例