CallResponder - Adobe ActionScript® 3（AS3 Flex）API リファレンス

パッケージ	mx.rpc
クラス	public class CallResponder
継承	CallResponder EventDispatcher Object
実装	IResponder

言語バージョン:

ActionScript 3.0

製品バージョン:

Flex 3

ランタイムバージョン:

Flash Player 9, AIR 1.1

このコンポーネントは、RPC ベースのサービス（通常は MXML コンポーネント）から行われる非同期呼び出しの結果を管理する際に役立ちます。結果イベントとフォルトイベントは個々のサービスや操作から送出されますが、アプリケーションの異なる部分で同じ操作を使用する必要が生じるケースは少なくありません。ただし、1 つのイベントリスナーまたは lastResult 値をアプリケーション全体で使用するのは賢明でない場合があります。シンプルで軽量な CallResponder を使用すれば、同じサービスを参照する 2 つのサービスコンポーネントを作成しなくても、特定のサービス呼び出しに関連するイベントリスナーと lastResult 値を管理できます。

このコンポーネントの token プロパティを、サービスから返される AsyncToken に設定します。こうすることで、返された AsyncToken ごとにイベントリスナーを追加しなくても、このコンポーネントにイベントリスナーを追加できます。このコンポーネントでは、lastResult プロパティも管理されます。lastResult プロパティは、このサービスで監視されているトークンから最後に送出された成功の結果イベントによって返された値のコピーです。callResponder.token.result または callResponder.lastResult のいずれかにバインドできますが、後者は同じサービスに対する 2 番目の呼び出しが進行している間も保持されるのに対して、前者は新しいサービス呼び出しが開始されるとすぐにリセットされます。

パブリックプロパティ

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

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

	プロパティ		定義元
		constructor : Object 指定されたオブジェクトインスタンスのクラスオブジェクトまたはコンストラクター関数への参照です。	Object
		lastResult : * このプロパティには、成功の結果が配信されるたびに、トークンの result プロパティが格納されます。	CallResponder
		token : mx.rpc:AsyncToken 各 CallResponder は、単一のトークンから受信した結果イベントとフォルトイベントを送出します。	CallResponder

パブリックメソッド

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

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

	メソッド		定義元
		addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void イベントリスナーオブジェクトを EventDispatcher オブジェクトに登録し、リスナーがイベントの通知を受け取るようにします。	EventDispatcher
		dispatchEvent(event:Event):Boolean イベントをイベントフローに送出します。	EventDispatcher
		fault(data:Object):void このメソッドは、CallResponder に FaultEvent を配信する必要があるときに、AsyncToken によって呼び出されます。	CallResponder
		hasEventListener(type:String):Boolean EventDispatcher オブジェクトに、特定のイベントタイプに対して登録されたリスナーがあるかどうかを確認します。	EventDispatcher
		hasOwnProperty(name:String):Boolean オブジェクトに指定されたプロパティが定義されているかどうかを示します。	Object
		isPrototypeOf(theClass:Object):Boolean Object クラスのインスタンスが、パラメーターとして指定されたオブジェクトのプロトタイプチェーン内にあるかどうかを示します。	Object
		propertyIsEnumerable(name:String):Boolean 指定されたプロパティが存在し、列挙できるかどうかを示します。	Object
		removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void EventDispatcher オブジェクトからリスナーを削除します。	EventDispatcher
		result(data:Object):void このメソッドは、CallResponder に ResultEvent を配信する必要があるときに、AsyncToken によって呼び出されます。	CallResponder
		setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void ループ処理に対するダイナミックプロパティの可用性を設定します。	Object
		toLocaleString():String ロケール固有の規則に従って書式設定された、このオブジェクトのストリング表現を返します。	Object
		toString():String 指定されたオブジェクトのストリング表現を返します。	Object
		valueOf():Object 指定されたオブジェクトのプリミティブな値を返します。	Object
		willTrigger(type:String):Boolean 指定されたイベントタイプについて、この EventDispatcher オブジェクトまたはその祖先にイベントリスナーが登録されているかどうかを確認します。	EventDispatcher

イベント

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

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

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

	概要	定義元
activate	[ブロードキャストイベント] Flash Player または AIR アプリケーションがオペレーティングシステムのフォーカスを取得して、アクティブになったときに送出されます。	EventDispatcher
deactivate	[ブロードキャストイベント] Flash Player または AIR アプリケーションがオペレーティングシステムのフォーカスを失って、非アクティブになったときに送出されます。	EventDispatcher
fault	Operation 呼び出しが失敗したときに送出されます。	CallResponder
result	Operation 呼び出しが正常に結果を返したときに送出されます。	CallResponder

プロパティの詳細

lastResult

プロパティ

lastResult:*

言語バージョン:

ActionScript 3.0

製品バージョン:

Flex 3

ランタイムバージョン:

Flash Player 9, AIR 1.1

このプロパティには、成功の結果が配信されるたびに、トークンの result プロパティが格納されます。token.result プロパティの代わりにこのプロパティにバインドまたはアクセスすると、特定のサービスメソッドを 2 回目以降に呼び出すときに値がクリアされたかどうかを確認する必要がなくなります。さらに、フォルトが発生した場合でも、この値は、この CallResponder で監視されているトークンから最後に返された成功の結果に設定されます。

このプロパティはデータバインディングのソースとして使用できます。このプロパティを変更すると、 propertyChange イベントが送出されます。

実装
public function get lastResult():*
public function set lastResult(value:any):void

token

プロパティ

token:mx.rpc:AsyncToken

言語バージョン:

ActionScript 3.0

製品バージョン:

Flex 3

ランタイムバージョン:

Flash Player 9, AIR 1.1

各 CallResponder は、単一のトークンから受信した結果イベントとフォルトイベントを送出します。このプロパティ値ではそのトークンを指定します。通常、このプロパティにはサービスから返される AsyncToken オブジェクトを設定します。

このプロパティはデータバインディングのソースとして使用できます。このプロパティを変更すると、 propertyChange イベントが送出されます。

実装
public function get token():mx.rpc:AsyncToken
public function set token(value:mx.rpc:AsyncToken):void

メソッドの詳細

fault

()

メソッド

public function fault(data:Object):void

言語バージョン:

ActionScript 3.0

製品バージョン:

Flex 3

ランタイムバージョン:

Flash Player 9, AIR 1.1

このメソッドは、CallResponder に FaultEvent を配信する必要があるときに、AsyncToken によって呼び出されます。このメソッドは直接呼び出さないでください。

パラメーター

data:Object — AsyncToken によって配信される FaultEvent です。

result

()

メソッド

public function result(data:Object):void

言語バージョン:

ActionScript 3.0

製品バージョン:

Flex 3

ランタイムバージョン:

Flash Player 9, AIR 1.1

このメソッドは、CallResponder に ResultEvent を配信する必要があるときに、AsyncToken によって呼び出されます。このメソッドは直接呼び出さないでください。

パラメーター

data:Object — AsyncToken によって配信される ResultEvent です。

イベントの詳細

fault

イベント

イベントオブジェクトの型: mx.rpc.events.FaultEvent
プロパティ FaultEvent.type = mx.rpc.events.FaultEvent.FAULT

言語バージョン:

ActionScript 3.0

製品バージョン:

Flex 3

ランタイムバージョン:

Flash Player 9, AIR 1.1

Operation 呼び出しが失敗したときに送出されます。

FAULT イベントタイプです。

イベントオブジェクトの各プロパティには次の値が設定されています。

プロパティ	値
`bubbles`	false
`cancelable`	true。関連付けられたトークンの responder.fault メソッドから preventDefault() を呼び出すと、サービスまたは処理がこのイベントを送出しなくなります。
`currentTarget`	イベント処理を行うイベントリスナーの定義用オブジェクトを表します。例えば、イベントリスナーの登録に `myButton.addEventListener()` を使用すると、myButton の値は `currentTarget` となります。
`fault`	このイベントの原因についての詳細が含まれる Fault オブジェクトです。
`message`	このイベントに関連付けられたメッセージです。
`target`	イベントを送出したオブジェクトを表します。このオブジェクトは必ずしもイベントを受け取るオブジェクトとは限りません。イベントを受け取るオブジェクトに常にアクセスするには、`currentTarget` プロパティを使用してください。
`token`	メソッドの呼び出しを表すトークン。Asynchronous Completion Token パターンで使用されます。

result

イベント

イベントオブジェクトの型: mx.rpc.events.ResultEvent
プロパティ ResultEvent.type = mx.rpc.events.ResultEvent.RESULT

言語バージョン:

ActionScript 3.0

製品バージョン:

Flex 3

ランタイムバージョン:

Flash Player 9, AIR 1.1

Operation 呼び出しが正常に結果を返したときに送出されます。

RESULT イベントタイプです。

イベントオブジェクトの各プロパティには次の値が設定されています。

プロパティ	値
`bubbles`	false
`cancelable`	true。関連付けられたトークンの responder.result メソッドから preventDefault() を呼び出すと、サービスまたは処理がこのイベントを送出しなくなります。
`currentTarget`	イベント処理を行うイベントリスナーの定義用オブジェクトを表します。例えば、イベントリスナーの登録に `myButton.addEventListener()` を使用すると、myButton の値は `currentTarget` となります。
`message`	このイベントに関連付けられたメッセージです。
`target`	イベントを送出したオブジェクトを表します。このオブジェクトは必ずしもイベントを受け取るオブジェクトとは限りません。イベントを受け取るオブジェクトに常にアクセスするには、`currentTarget` プロパティを使用してください。
`result`	RPC 呼び出しが返す結果です。
`token`	メソッドの個々の呼び出しを表すトークン。 Asynchronous Completion Token パターンで使用されます。

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

CallResponder - AS3 Flex

クラス x

lastResult

token

fault

result

fault

result