Listenerクラス

13.17 リスナー・クラス

Listenerクラスは、指定のキューで登録済AgentとしてMessageをリスニングする機能をカプセル化します。

表13-23 Listenerメソッドの概要

メソッド	概要
Listener()	`Listener`クラスのコンストラクタです。
getAgentList()	`Listener`がサービスを提供する`Agent`のリストを取り出します。
getTimeOutForListen()	コールのタイムアウトを取り出します。
listen()	`Message`をリスニングし、`Message`の宛先である`Agent`の名前を戻します。
setAgentList()	`Listener`がサービスを提供する`Agent`のリストを指定します。
setTimeOutForListen()	listen()のコールのタイムアウトを指定します。

Listenerクラスのコンストラクタです。

構文	説明
Listener( const Connection* conn);	`Listener`オブジェクトを作成します。
Listener( const Connection* conn vector<Agent> &aglist, int waitTime=0);	`Listener`オブジェクトを作成し、かわりにキューでリスニングする`Agent`のリストを設定します。待機時間も設定します。デフォルトは待機なしです。

パラメータ	説明
conn	新規`Listener`オブジェクトの接続を指定します。
aglist	`Listener`オブジェクトがかわりにキューで待機するエージェントのリストを指定します。これは、この`Listener`のクライアントです。
waitTime	クライアントにとって重要なメッセージをキューで待機する秒数を指定します。

Listenerがサービスを提供するAgentのリストを取り出します。

構文

vector<Agent> getAgentList() const;

コールのタイムアウトを取り出します。

構文

int getTimeOutForListen() const;

前のsetTimeOutForListen()のコールで指定された時間だけ、指定されたAgentとしてMessageをリスニングします。MessageがあるAgentを戻します。

これはブロック化コールです。このコールの前に、次の手順を実行してください。

setAgentList()をコールして各エージェントのリスナーを登録します。
リスト上のAgentの1つにMessageが届いたときに戻されるsetTimeOutForListen()に対してブロック化コールを行います。待機時間が経過する前にMessageが届かない場合、コールはエラーを返します。

構文

Agent listen();

Listenerがサービスを提供するAgentのリストを指定します。

構文

void setAgentList(
   vector<Agent>& agList);

パラメータ	説明
agList	`Agent`のリストを指定します。

listen()のコールのタイムアウトを指定します。

構文

void setTimeOutForListen(
   int waitTime);

パラメータ	説明
waitTime	指定のキューで`Listener`が`Message`を待機する時間隔を秒単位で指定します。