MessageAgent

パッケージ	mx.messaging
クラス	public class MessageAgent
継承	MessageAgent EventDispatcher Object
実装	IMXMLObject
サブクラス	AbstractConsumer, AbstractProducer

言語バージョン:

ActionScript 3.0

製品バージョン:

BlazeDS 4, Adobe Digital Enterprise Platform Data Services for Java EE 3

ランタイムバージョン:

Flash Player 9, AIR 1.1

MessageAgent クラスは、宛先に対するメッセージ処理に共通する基本的な低レベル機能を提供します。

メモ：高度な使用のみを目的としています。このクラスは、既存のプロデューサクラスやコンシューマクラスなどのカスタムエージェントを作成する場合に使用します。

MXML シンタックス expanded

MXML シンタックスを隠す

All message agent classes, including the Producer and Consumer classes, extend MessageAgent and inherit the following tag attributes:

   <mx:tagname

    Properties
    channelSet="No default."
    clientId="No default."
    connected="false"
    destination="No default."
    requestTimeout="-1"
    subtopic="No default."
 
 
   Events
    acknowledge="No default."
    channelConnect="No default."
    channelDisconnect="No default."
    channelFault="No default."
    fault="No default."
    propertyChange="No default."
  />

パブリックプロパティ

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

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

	プロパティ		定義元
		authenticated : Boolean [読み取り専用] この MessageAgent が宛先への接続に認証を使用するかどうかを示します。	MessageAgent
		channelSet : ChannelSet MessageAgent が使用する ChannelSet へのアクセスを提供します。	MessageAgent
		clientId : String [読み取り専用] MessageAgent のクライアント ID へのアクセスを提供します。	MessageAgent
		connected : Boolean [読み取り専用] この MessageAgent が現在、ChannelSet を介して宛先に接続されているかどうかを示します。	MessageAgent
		constructor : Object 指定されたオブジェクトインスタンスのクラスオブジェクトまたはコンストラクター関数への参照です。	Object
		destination : String MessageAgent の宛先へのアクセスを提供します。	MessageAgent
		requestTimeout : int 送信メッセージの要求タイムアウト時間（秒単位）に対するアクセスを提供します。	MessageAgent

パブリックメソッド

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

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

	メソッド		定義元
		MessageAgent() コンストラクターです。	MessageAgent
		acknowledge(ackMsg:AcknowledgeMessage, msg:IMessage):void 送信されたメッセージの結果を受信したときに MessageResponder によって呼び出されます。	MessageAgent
		addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void イベントリスナーオブジェクトを EventDispatcher オブジェクトに登録し、リスナーがイベントの通知を受け取るようにします。	EventDispatcher
		channelConnectHandler(event:ChannelEvent):void CONNECT ChannelEvent を処理します。	MessageAgent
		channelDisconnectHandler(event:ChannelEvent):void DISCONNECT ChannelEvent を処理します。	MessageAgent
		channelFaultHandler(event:ChannelFaultEvent):void ChannelFaultEvent を処理します。	MessageAgent
		disconnect():void MessageAgent のネットワーク接続を切断します。	MessageAgent
		dispatchEvent(event:Event):Boolean イベントをイベントフローに送出します。	EventDispatcher
		fault(errMsg:ErrorMessage, msg:IMessage):void 送信されたメッセージの失敗を受信したときに、MessageResponder によって呼び出されます。	MessageAgent
		hasEventListener(type:String):Boolean EventDispatcher オブジェクトに、特定のイベントタイプに対して登録されたリスナーがあるかどうかを確認します。	EventDispatcher
		hasOwnProperty(name:String):Boolean オブジェクトに指定されたプロパティが定義されているかどうかを示します。	Object
		hasPendingRequestForMessage(msg:IMessage):Boolean 渡されたメッセージに対し保留中の要求がある場合、true を返します。	MessageAgent
		initialized(document:Object, id:String):void 実装オブジェクトが作成され、タグに指定されたすべてのプロパティが割り当てられた後に呼び出されます。	MessageAgent
		isPrototypeOf(theClass:Object):Boolean Object クラスのインスタンスが、パラメーターとして指定されたオブジェクトのプロトタイプチェーン内にあるかどうかを示します。	Object
		logout():void MessageAgent をリモート宛先からログアウトします。	MessageAgent
		propertyIsEnumerable(name:String):Boolean 指定されたプロパティが存在し、列挙できるかどうかを示します。	Object
		removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void EventDispatcher オブジェクトからリスナーを削除します。	EventDispatcher
		setCredentials(username:String, password:String, charset:String = null):void MessageAgent が宛先の認証に使用する証明書を設定します。	MessageAgent
		setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void ループ処理に対するダイナミックプロパティの可用性を設定します。	Object
		setRemoteCredentials(username:String, password:String, charset:String = null):void セカンダリシステムへの認証のためにリモート宛先に渡すリモート資格情報を設定します。	MessageAgent
		toLocaleString():String ロケール固有の規則に従って書式設定された、このオブジェクトのストリング表現を返します。	Object
		toString():String 指定されたオブジェクトのストリング表現を返します。	Object
		valueOf():Object 指定されたオブジェクトのプリミティブな値を返します。	Object
		willTrigger(type:String):Boolean 指定されたイベントタイプについて、この EventDispatcher オブジェクトまたはその祖先にイベントリスナーが登録されているかどうかを確認します。	EventDispatcher

プロテクトメソッド

	メソッド		定義元
		handleAuthenticationFault(errMsg:ErrorMessage, msg:IMessage):void サーバー上の認証エラーを処理します。	MessageAgent
		initChannelSet(message:IMessage):void MessageAgent の初回の接続前に MessageAgent の channelSet プロパティを自動的に初期化します。	MessageAgent
		internalSend(message:IMessage, waitForClientId:Boolean = true):void エージェントの ChannelSet を使って、MessageAgent から宛先にメッセージを送信します。	MessageAgent
		reAuthorize(msg:IMessage):void この関数をサブクラスでオーバーライドして、サブクラス固有のサーバーセッションタイムアウト動作による再認証を実装する必要があります。	MessageAgent

イベント

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

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

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

	概要	定義元
acknowledge	送信したメッセージに対する応答メッセージを受信したときに送出されます。	MessageAgent
activate	[ブロードキャストイベント] Flash Player または AIR アプリケーションがオペレーティングシステムのフォーカスを取得して、アクティブになったときに送出されます。	EventDispatcher
channelConnect	MessageAgent が使用中の基本チャンネルが接続されたときに送出されます。	MessageAgent
channelDisconnect	MessageAgent が使用中の基本チャンネルが切断されたときに送出されます。	MessageAgent
channelFault	MessageAgent が使用中の基本チャンネルでエラーが発生したときに送出されます。	MessageAgent
deactivate	[ブロードキャストイベント] Flash Player または AIR アプリケーションがオペレーティングシステムのフォーカスを失って、非アクティブになったときに送出されます。	EventDispatcher
fault	メッセージエラーが発生したときに送出されます。	MessageAgent
propertyChange	MessageAgent の connected プロパティが変更されたときに送出されます。	MessageAgent

プロパティの詳細

authenticated

プロパティ

authenticated:Boolean [読み取り専用]

この MessageAgent が宛先への接続に認証を使用するかどうかを示します。

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

実装
public function get authenticated():Boolean

コンストラクターの詳細

メソッドの詳細

イベントの詳細

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

プロパティ	値
`acknowledgeMessage`	MessageEvent のメッセージプロパティを AcknowledgeMessage として取得するためのユーティリティプロパティです。
`bubbles`	false
`cancelable`	false
`currentTarget`	イベント処理を行うイベントリスナーの定義用オブジェクトを表します。例えば、イベントリスナーの登録に `myButton.addEventListener()` を使用すると、myButton の値は `currentTarget` となります。
`correlate`	この応答に関連付けられた元のメッセージ。
`message`	このイベントに関連付けられたメッセージです。
`target`	イベントを送出したオブジェクトを表します。このオブジェクトは必ずしもイベントを受け取るオブジェクトとは限りません。イベントを受け取るオブジェクトに常にアクセスするには、`currentTarget` プロパティを使用してください。

プロパティ	値
`bubbles`	false
`cancelable`	false
`channel`	このイベントが生成されたチャンネルです。
`currentTarget`	イベント処理を行うイベントリスナーの定義用オブジェクトを表します。例えば、イベントリスナーの登録に `myButton.addEventListener()` を使用すると、myButton の値は `currentTarget` となります。
`target`	イベントを送出したオブジェクトを表します。このオブジェクトは必ずしもイベントを受け取るオブジェクトとは限りません。イベントを受け取るオブジェクトに常にアクセスするには、`currentTarget` プロパティを使用してください。
`reconnecting`	このイベントを生成したチャンネルが再接続中であるかどうかを示します。
`rejected`	このイベントを生成したチャンネルが拒否されたかどうかを示します。アクティビティがないことによりチャンネルが切断された場合は、これが true になり、フェイルオーバーが行われず、代替チャンネルへの接続も行われません。

プロパティ	値
`bubbles`	false
`cancelable`	false
`channel`	このイベントが生成されたチャンネルです。
`currentTarget`	イベント処理を行うイベントリスナーの定義用オブジェクトを表します。例えば、イベントリスナーの登録に `myButton.addEventListener()` を使用すると、myButton の値は `currentTarget` となります。
`target`	イベントを送出したオブジェクトを表します。このオブジェクトは必ずしもイベントを受け取るオブジェクトとは限りません。イベントを受け取るオブジェクトに常にアクセスするには、`currentTarget` プロパティを使用してください。
`reconnecting`	このイベントを生成したチャンネルが再接続中であるかどうかを示します。
`rejected`	このイベントを生成したチャンネルが拒否されたかどうかを示します。アクティビティがないことによりチャンネルが切断された場合は、これが true になり、フェイルオーバーが行われず、代替チャンネルへの接続も行われません。

プロパティ	値
`bubbles`	false
`cancelable`	false
`channel`	このイベントを生成したチャンネルです。
`currentTarget`	イベント処理を行うイベントリスナーの定義用オブジェクトを表します。例えば、イベントリスナーの登録に `myButton.addEventListener()` を使用すると、myButton の値は `currentTarget` となります。
`faultCode`	失敗に関する宛先固有の詳細を提供します。
`faultDetail`	失敗の宛先固有の理由へのアクセスを提供します。
`faultString`	チャンネル自体がフォルトを生成しなかった場合は、フォルトの根本的な理由へのアクセスを提供します。
`reconnecting`	このイベントを生成したチャンネルが再接続中であるかどうかを示します。
`rootCause`	チャンネル自体がフォルトを生成しなかった場合は、フォルトの根本的な理由へのアクセスを提供します。
`target`	イベントを送出したオブジェクトを表します。このオブジェクトは必ずしもイベントを受け取るオブジェクトとは限りません。イベントを受け取るオブジェクトに常にアクセスするには、`currentTarget` プロパティを使用してください。

プロパティ	値
`bubbles`	false
`cancelable`	false
`currentTarget`	イベント処理を行うイベントリスナーの定義用オブジェクトを表します。例えば、イベントリスナーの登録に `myButton.addEventListener()` を使用すると、myButton の値は `currentTarget` となります。
`faultCode`	失敗に関する宛先固有の詳細を提供します。
`faultDetail`	失敗の宛先固有の理由へのアクセスを提供します。
`faultString`	チャンネル自体がフォルトを生成しなかった場合は、フォルトの根本的な理由へのアクセスを提供します。
`message`	このイベントの ErrorMessage。
`rootCause`	失敗の根本的な理由へのアクセスを提供します（存在する場合）。
`target`	イベントを送出したオブジェクトを表します。このオブジェクトは必ずしもイベントを受け取るオブジェクトとは限りません。イベントを受け取るオブジェクトに常にアクセスするには、`currentTarget` プロパティを使用してください。

MessageAgent - AS3 BlazeDS LCDS

パッケージx

言語エレメント

付録

パッケージ mx.messaging

authenticated

channelSet

clientId

connected

destination

requestTimeout

acknowledge

channelConnectHandler

channelDisconnectHandler

channelFaultHandler

disconnect

fault

handleAuthenticationFault

hasPendingRequestForMessage

initChannelSet

initialized

internalSend

logout

reAuthorize

setCredentials

setRemoteCredentials

acknowledge

channelConnect

channelDisconnect

channelFault

fault

propertyChange

	`ackMsg:AcknowledgeMessage` — 返される AcknowledgMessage です。

	`msg:IMessage` — 元の送信メッセージです。

	`errMsg:ErrorMessage` — ErrorMessage です。

	`msg:IMessage` — このエラーの原因となった元の送信メッセージです。

	`errMsg:ErrorMessage` — エラーメッセージです。

	`msg:IMessage` — エラーの原因となったメッセージです。再認証による切断または接続の後、再度送信する必要があります。

	`document:Object` — このオブジェクトを作成した MXML ドキュメントです。

	`id:String` — ドキュメントがこのオブジェクトを参照するために使用する ID です。オブジェクトがドキュメントの deep プロパティである場合、ID は null になります。

	`message:IMessage` — 送信するメッセージです。

	`waitForClientId:Boolean` (default = `true`) — true の場合、clientId がエージェントに割り当てられるまでメッセージはキューに置かれることがあります。通常、これは必要な動作です。自動再接続、自動再サブスクライブなどの特別な動作の場合、エージェントは false を渡してデフォルトのキューイング動作をオーバーライドすることがあります。

	`username:String` — ユーザー名です。

	`password:String` — パスワードです。

	`charset:String` (default = `null`) — 資格情報をエンコードする際に使用する文字セットエンコーディングです。デフォルトは null で、旧式文字セットの ISO-Latin-1 を示します。サポートされているその他の文字セットは "UTF-8" のみです。

	`username:String` — ユーザー名です。

	`password:String` — パスワードです。

	`charset:String` (default = `null`) — リモート資格情報をエンコードする際に使用する文字セットエンコーディングです。デフォルトは null で、旧式文字セットの ISO-Latin-1 を示します。現在サポートされているその他のオプションは "UTF-8" のみです。

プロパティ	値
`bubbles`	コンストラクターによって決定されます。デフォルトは false です。
`cancelable`	コンストラクターによって決定されます。デフォルトは false です。
`kind`	変更の種類。PropertyChangeEventKind.UPDATE または PropertyChangeEventKind.DELETE のいずれかです。
`oldValue`	元のプロパティの値です。
`newValue`	新しいプロパティの値（存在する場合）です。
`property`	変更されたプロパティです。
`source`	変更されたプロパティを含むオブジェクトです。
`currentTarget`	イベント処理を行うイベントリスナーの定義用オブジェクトを表します。例えば、イベントリスナーの登録に `myButton.addEventListener()` を使用すると、myButton の値は `currentTarget` となります。
`target`	イベントを送出したオブジェクトを表します。このオブジェクトは必ずしもイベントを受け取るオブジェクトとは限りません。イベントを受け取るオブジェクトに常にアクセスするには、`currentTarget` プロパティを使用してください。