CORBA IDL

SubscriptionID subscribe (
      in    string                             subscription_name,
      in    RegularExpression                  domain,
      in    RegularExpression                  type,
      in    FilterExpression                   data_filter,
      // フィルタ式の長さは 1 で、名前は TRANSIENT_SUBSCRIPTION 
      // または PERSISTENT_SUBSCRIPTION でなければならない
      in    CosNotification::QoSProperties     qos,
      in    CosNotifyComm::StructuredPushConsumer push_consumer
);

パラメータ

例外

説明

このオペレーションを使用すると、イベントをサブスクライブできます。このオペレーションは、特定のイベントのサブスクリプションを作成するために、ノーティフィケーション・サービスのサブスクライバ・アプリケーションによって呼び出されます。サブスクリプション名、ドメイン名、型名、データ・フィルタ、サービスの品質、およびサブスクライバのコールバック・オブジェクトのオブジェクト・リファレンスが渡されます。コールバック・オブジェクトでは、CosNotifyComm::StructuredPushConsumer IDL インターフェイスがインプリメントされます。

注記 シャットダウンおよび再起動するサブスクライバについては、subscription_id を永続ストレージに書き込む必要があります。

戻り値

注記 1 度だけ起動およびシャットダウンされるノーティフィケーション・サービス・アプリケーションでは、subscription_id を使用してサブスクリプションが自動的にまたはシステム管理者によって取り消されているかどうかを確認できます。

例

C++ コード例

subscription_id = channel->subscribe(
          subscription_name,
          "News", // ドメイン
          “Sports” ,   // 型
          "",     // データ・フィルタなし
          qos,
          news_consumer.in()
        );

Java コード例

          "",     // データ・フィルタなし
          qos,
          news_consumer_impl
        );