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

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

MXML のシンタックスexpandedMXML シンタックスを隠す

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.

例を表示


パブリックプロパティ
 プロパティ定義元
 InheritedchannelSet : ChannelSet
サービスが使用する ChannelSet へのアクセスを提供します。
AbstractService
 Inheritedconcurrency : String
同一サービスに対する複数の呼び出しの処理方法を示す値です。
RemoteObject
 Inheritedconstructor : Object
指定されたオブジェクトインスタンスのクラスオブジェクトまたはコンストラクタ関数への参照です。
Object
 InheritedconvertParametersHandler : Function
フレームワーク開発者には、各リモートオブジェクト起動で渡すパラメータを指定して呼び出す関数をインストールする必要がある場合があります。そのような開発者を主な対象としたオプション関数です。
RemoteObject
 InheritedconvertResultHandler : Function
フレームワーク開発者には、操作の結果を処理するフックをインストールしてから結果ハンドラを通知する必要がある場合があります。そのような開発者を主な対象としたオプション関数です。
RemoteObject
 Inheriteddestination : String
サービスの宛先です。
AbstractService
 Inheritedendpoint : String
このプロパティを使用すると、開発者はコンパイル時にサービス設定ファイルを参照したり、プログラムで ChannelSet を作成したりすることなしに、RemoteObject 宛先のエンドポイントを簡単に指定できます。
RemoteObject
 InheritedmakeObjectsBindable : Boolean
この値が true の場合、返された匿名オブジェクトは強制的にバインド可能オブジェクトにされます。
RemoteObject
 Inheritedmanagers : Array
マネージャプロパティは、このサービスの動作を修正するデータマネージャのリストを格納します。
AbstractService
 Inheritedoperations : Object
通常、Operations 配列は MXML タグを使ってサービスを作成した場合に、MXML コンパイラによってのみ設定されます。
AbstractService
 Inheritedprototype : Object
[静的] クラスまたは関数オブジェクトのプロトタイプオブジェクトへの参照です。
Object
 InheritedrequestTimeout : int
送信メッセージの要求タイムアウト時間（秒単位）に対するアクセスを提供します。
AbstractService
 InheritedshowBusyCursor : Boolean
true の場合、サービスの実行中にビジーカーソルが表示されます。
RemoteObject
 Inheritedsource : String
クライアント上のソース値を指定することができます。JavaAdapter を使用する宛先にはサポートされていません。
RemoteObject
パブリックメソッド
 メソッド定義元
  
RemoteObject(destination:String = null)
新しい RemoteObject を作成します。
RemoteObject
 Inherited
disconnect():void
サービスのネットワーク接続を切断して、保留されている要求のすべての応答側を削除します。
AbstractService
  
getOperation(name:String):AbstractOperation
[override] 指定された名前の Operation を返します。
RemoteObject
 Inherited
hasOwnProperty(name:String):Boolean
オブジェクトに指定されたプロパティが定義されているかどうかを示します。
Object
 Inherited
initialize():void
サービスを初期化するために呼び出されます。
AbstractService
  
initialized(document:Object, id:String):void
RemoteObject がタグを使用して設定されている場合、MXML コンパイラによって自動的に呼び出されます。
RemoteObject
 Inherited
isPrototypeOf(theClass:Object):Boolean
Object クラスのインスタンスが、パラメータとして指定されたオブジェクトのプロトタイプチェーン内にあるかどうかを示します。
Object
 Inherited
logout():void
ユーザーを宛先からログアウトします。
AbstractService
 Inherited
propertyIsEnumerable(name:String):Boolean
指定されたプロパティが存在し、列挙できるかどうかを示します。
Object
 Inherited
setCredentials(username:String, password:String, charset:String = null):void
サーバー側で Data Services を使用している場合にサービスがアクセスする宛先の資格情報を設定します。
AbstractService
 Inherited
setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void
ループ処理に対するダイナミックプロパティの可用性を設定します。
Object
 Inherited
setRemoteCredentials(remoteUsername:String, remotePassword:String, charset:String = null):void
[override] リモートオブジェクトが ColdFusion Component（CFC）などの外部サービスで管理されている場合、そのリモートサービスの認証メカニズムに対するユーザー名とパスワードを設定することができます。
RemoteObject
 Inherited
toString():String
RemoteObject のインスタンスを、宛先 ID や割り当てられたチャネルのセットなどの重要なプロパティを記述するストリングとして表します。
RemoteObject
 Inherited
valueOf():Object
指定されたオブジェクトのプリミティブな値を返します。
Object
イベント
 イベント 概要 定義元
 Inherited
fault
fault イベントは、サービス呼び出しが失敗した場合に送出されます。操作自体は、このイベントを処理しません。AbstractService
 Inherited
invoke
チャネルがメッセージの送信を試行する前にエラーがスローされない限り、サービスの操作が呼び出されたときに、invoke イベントが送出されます。AbstractService
 Inherited
result
result イベントは、サービス呼び出しから制御が正常に戻された場合に送出されます。操作自体は、このイベントを処理しません。AbstractService
コンストラクタの詳細
RemoteObject()コンストラクタ
public function RemoteObject(destination:String = null)

新しい RemoteObject を作成します。

パラメータ
destination:String (default = null) — RemoteObject の宛先。services-config.xml ファイル内の宛先名と一致する必要があります。
メソッドの詳細
getOperation()メソッド
override public function getOperation(name:String):AbstractOperation

指定された名前の 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

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

パラメータ

document:Object — この RemoteObject が存在する MXML ドキュメントです。
 
id:String — ドキュメント内部でのこの RemoteObject の ID です。

例 例の使用法
RemoteObjectExample.mxml
<?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>



© 2009 Adobe Systems Incorporated. All rights reserved.
Thu Mar 19 2009, 08:51 PM -07:00
 

 

このページに新しいコメントが追加された場合に、電子メールでの通知を希望する。 | コメントレポート

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