OpenRTM_aist.ConnectorListener.ConnectorListener の継承関係図

公開メンバ関数
	toString (status)

詳解

ConnectorListener クラス

データポートの Connector において発生する各種イベントに対するコールバックを実現するリスナクラスの基底クラス。

コアロジックがOutPortに対してデータ書き込み、InPort側でデータが取得されるまでの間で発生する各種イベントをフックするコールバックを設定することができる。なお、リスナークラスは2種類存在し、バッファフルや送信時のコールバックで、その時点で有効なデータをファンクタの引数として受け取る ConnectorDataListener であり、もう一方はデータエンプティやバッファ読み込み時のタイムアウトなどデータが取得できない場合などにコールされるファンクタの引数に何もとらならい ConnecotorListener がある。

ConnectorListener クラスによって関連する動作をフックしたい場合、以下の例のように、このクラスを継承し、コネクタの情報を引数に取る以下のようなコールバックオブジェクトを定義し、データポートの適切なコールバック設定関数からコールバックオブジェクトをセットする必要がある。

 class MyListener
   : public ConnectorListener
 {
 public:
   MyListener(const char* name) : m_name(name) {}
   virtual ~MyListener() {}
   virtual ReturnCode operator()(ConnectorInfo& info)
   {
     std.cout << "Data Listener: " << m_name       << std.endl;
     std.cout << "Profile::name: " << info.name    << std.endl;
     std.cout << "Profile::id:   " << info.id      << std.endl;
     std.cout << "Profile::properties: "           << std.endl;
     std.cout << info.properties;
   };
   std.string m_name;
 };

このようにして定義されたリスナクラスは、以下のようにデータポートに対して、以下のようにセットされる。

 RTC.ReturnCode_t ConsoleIn.onInitialize()
 {
     m_outOut.
         addConnectorListener(ON_BUFFER_EMPTY,
                              new MyListener("ON_BUFFER_EMPTY"));
    :

第1引数の "ON_BUFFER_EMPTY" は、コールバックをフックするポイントであり、以下に列挙する値を取ることが可能である。データポートには、接続時にデータの送受信方法について、インターフェース型、データフロー型、サブスクリプション型等を設定することができるが、これらの設定によりフックされるポイントは異なる。以下に、インターフェースがCORBA CDR型の場合のコールバック一覧を示す。

OutPort:

Push型: Subscription Typeによりさらにイベントの種類が分かれる。
- Flush: Flush型にはバッファがないため ON_BUFFER 系のイベントは発生しない
  - ON_CONNECT
  - ON_DISCONNECT
- New型
  - ON_CONNECT
  - ON_DISCONNECT
- Periodic型
  - ON_BUFFER_EMPTY
  - ON_BUFFER_READ_TIMEOUT
  - ON_SENDER_EMPTY
  - ON_SENDER_ERROR
  - ON_CONNECT
  - ON_DISCONNECT
Pull型
- ON_BUFFER_EMPTY
- ON_BUFFER_READ_TIMEOUT
- ON_SENDER_EMPTY
- ON_SENDER_TIMEOUT
- ON_SENDER_ERROR
- ON_CONNECT
- ON_DISCONNECT
InPort:
Push型:
- ON_BUFFER_EMPTY
- ON_BUFFER_READ_TIMEOUT
- ON_CONNECT
- ON_DISCONNECT
Pull型
- ON_CONNECT
- ON_DISCONNECT

複数の ConnectorListener を保持し管理するクラス。

メソッド詳解

◆ toString()

OpenRTM_aist.ConnectorListener.ConnectorListener.toString ( status )

ConnectorListenerType を文字列に変換

ConnectorListenerType を文字列に変換する

引数

type	変換対象 ConnectorListenerType

戻り値: 文字列変換結果

このクラス詳解は次のファイルから抽出されました:

ConnectorListener.py

公開メンバ関数

詳解

メソッド詳解

◆ toString()