Tuxedo CORBA ノーティフィケーション サービス

CORBA ノーティフィケーション サービス API のリファレンス

ここでは、以下の内容について説明します。

はじめに

Oracle Tuxedo CORBA ノーティフィケーション サービスでは、2 つのアプリケーション プログラミング インタフェースがサポートされます。1 つは、「CORBAservices: Common Object Services Specification」で定義されている CORBA ベースのノーティフィケーション サービスに基づいています。このインタフェースは、このマニュアルでは CosNotification サービス インタフェースと呼びます。もう 1 つのインタフェース (Oracle シンプル イベント インタフェース) は、使いやすく設計された Oracle 独自のインタフェースです。

それらのインタフェースは互いに互換性があり、どちらも CORBA ベースのノーティフィケーション サービス仕様で定義された構造化イベントを渡します。つまり、CosNotification サービス インタフェースを使用してポストされたイベントは Oracle シンプル イベント インタフェースでサブスクライブできるということです (逆方向も可)。

ノーティフィケーション サービス API を使用する前に、次のトピックに目を通してください。

サービスの品質

サブスクリプションが永続的かどうか、およびイベント配信の失敗後に配信が再試行されるかどうかを指定するために、サブスクライバではサービスの品質 (QoS) を指定します。サービスの品質には、永続的と一時的の 2 つの設定があります。QoS は、サブスクリプションのプロパティです。

永続的なサブスクリプション

永続的なサブスクリプションでは、イベントの配信とサブスクリプションの永続性が強固に保証されます。ただし、システム リソース (ディスク領域や CPU サイクルなど) がより多く消費されるとともに、より多くの管理タスク (キューの管理やデッド サブスクライバの検出など) が必要になります。

永続的なサブスクリプションには以下の特性があります。

一時的なサブスクリプション

一時的なサブスクリプションでは、最小限のオーバーヘッドで最高の性能が実現します。一時的なサブスクリプションには、次の特性があります。

サブスクリプションは、イベント配信の失敗が検出されるまで有効です。配信の失敗が検出された時点で、サブスクリプションは終了します。通常、ノーティフィケーション サービスでは、性能上の理由のために一時的なサブスクライバに正常にイベントが配信されたかどうかが確認されません。ただし、イベントを一時的なサブスクライバに配信する場合に、ノーティフィケーション サービスで配信が成功したかどうかが確認されることもあります。イベントが正常に配信されず、CORBA::TRANSIENT 例外が返されないときは、ノーティフィケーション サービスではサブスクリプションが無くなったものと判断し、サブスクリプションを取り消します。配信が失敗して CORBA::TRANSIENT 例外を受信した場合、ノーティフィケーション サービスではサブスクライバがビジー状態であると判断してイベントを破棄しますが、サブスクリプションは取り消されません。

デッド状態の一時的なサブスクリプションの自動的な取り消しでは、アンサブスクライブされていない一時的なサブスクライバのクリーンアップ メカニズムが提供されます。ただし、ノーティフィケーション サービスによる配信の確認はイベントがサブスクライバに最初に送信されたときに行われますが、それから 5 分が経過し、別のイベントが配信されるまでは次の確認は行われません。したがって、確認が実行される間隔は短くて 5 分であり、5 分経過後に配信するイベントがない場合その間隔はさらに長くなります。5 分という最短の間隔は固定であり、変更することはできません。このため、イベント配信の失敗は必ずしも最初の失敗の時点で検出されるわけではありません。イベント配信の失敗は、ノーティフィケーション サービスで確認が行われたときにのみ検出されます。

チャネル ファクトリの取得

チャネル ファクトリは、イベント チャネルを探すためにイベント ポスト元のアプリケーションとサブスクライバ アプリケーションによって使用されます。イベント チャネルは、イベントのポスト、サブスクリプションのサブスクライブ (作成)、およびサブスクリプションのアンサブスクライブ (取り消し) に使用します。

ノーティフィケーション サービス アプリケーションでは、Bootstrap オブジェクトを使用してイベント チャネル ファクトリのオブジェクト参照を取得します。その際には、Tobj_Bootstrap::resolve_initial_references オペレーションが使用されます。Bootstrap オブジェクトでは、ノーティフィケーション サービス アプリケーションの 2 つのサービス ID (NotificationService および Tobj_SimpleEventsService) がサポートされています。NotificationService オブジェクトは、CosNotification サービス API を使用するアプリケーションで使用します。Tobj_SimpleEventsService オブジェクトは、Oracle シンプル イベント API を使用するアプリケーションで使用します。

トランザクションの使い方

トランザクションに関する振る舞いは、Oracle シンプル イベント API と CosNotification サービス API で同じです。トランザクションの振る舞いをサポートする唯一のオペレーションは push_structured_event です。このオペレーションは、CosNotifyChannelAdmin::StructuredProxyPushConsumer インタフェースと Tobj_SimpleEvents::Channel インタフェースでサポートされています。ほかのすべてのオペレーションは、トランザクションのコンテキストで使用できますが、トランザクションで実行されても、それ以外で実行されても同じように機能します。

イベントをポストするときの振る舞いは、サブスクリプションの QoS に依存します。サブスクリプションのイベント配信 QoS が永続的である場合に、イベントがトランザクションのコンテキストでポストされると、その配信はトランザクションの結果に左右されます。つまり、トランザクションがコミットされる場合、ノーティフィケーション サービスでは通常どおりにサブスクライバにイベントが配信されます。トランザクションがロールバックされる場合は、イベントは配信されません。

サブスクライバのサブスクリプションのイベント配信 QoS が一時的である場合に、イベントがトランザクションのコンテキストでポストされると、トランザクションの結果に関係なくそのイベントの配信が 1 度試行されます。つまり、トランザクションはイベントが配信されるかどうかに影響を与えず、イベントの配信が 1 度試行されます。

構造化イベントのフィールド、型、およびフィルタ

ポスト元からノーティフィケーション サービスにプッシュされるか、サブスクライバに配信されるイベントはすべて COS 構造化イベントです。つまり、すべてのイベントは CORBA ベースのノーティフィケーション サービスで指定されている構造化イベントの定義に適合しています。CORBA ベースのノーティフィケーション サービスは、CORBAservices イベント サービスを拡張したサービスです (図 2-1 を参照)。イベントが (ドメインや型ではなく) 内容に基づいてフィルタ処理される場合、またはイベントが Oracle Tuxedo アプリケーションによってサブスクライブされる場合は、適用される制限が増えます。それらの制限は、データ型、および内容に基づくフィルタ処理に適用されます。次に、それらの制限について説明します。

イベントの設計

イベントの設計は、あらゆるノーティフィケーション サービスの基本です。イベントの設計は、一致するサブスクリプションに配信される情報の量だけでなく、ノーティフィケーション サービスの効率と性能にも影響します。したがって、計画を慎重に行って、ノーティフィケーション サービスが現在のニーズだけでなく将来の規模拡大にも対応できるようにする必要があります。

ノーティフィケーション サービスでは、(1) ドメイン名、(2) 型名、(3) 優先順位、(4) フィルタ処理可能データ、および (5) 残りの本文の 5 段階のイベント設計がサポートされています。イベントを設計するときには、ドメイン名と型名を指定する必要があります (優先順位とフィルタ処理可能データは任意指定)。ドメイン名は、ビジネスに基づいて選択することができます。たとえば病院は医療ビジネス (health care business) に属しているので、病院のノーティフィケーション サービス アプリケーションでは「HEALTHCARE」をドメイン名として選択できます。保険業者の種類に基づいてイベントを分類する必要がある場合は、「HMO」または「UNINSURED」を型名として選択できます。支払い義務のあるエンティティを基準にイベントをさらに細かく定義する必要がある場合は、フィルタ処理可能データを使用して、特定の “HMO_Account” または特定の “Patient_Account” に対する “billing” としてエンティティを識別することも可能です。コード リスト 2-1 は、このタイプのイベント設計の例を示しています。

domain_name = “HEALTHCARE”
type_name = “HMO”
#フィルタ処理可能データの名前/値ペア
filterable_data.name = “billing”
filterable_data.value = 4498
filterable_data.name = “patient_account”
filterable_data.value = 37621

当然、ノーティフィケーション サービス アプリケーションでポストおよび受信されるイベントの設計が詳細かつ厳密になればなるほど、ノーティフィケーション サービスで処理しなければならないイベントの数が少なくなります。このことは、システム リソースとコンフィグレーションの要件に直接的に影響します。したがって、イベントを設計するときには十分な考慮が必要です。

イベントの FML フィールド テーブル ファイルの作成

イベントのフィールド操作言語 (FML) フィールド テーブル ファイルは、次の機能のいずれかが必要な場合のみ作成する必要があります。どの機能も必要でない場合は、FML テーブルは不要です。

構造化イベントの filterable_data フィールドには、名前/値 (NV) ペアのリストが格納されます。イベントのデータは通常はこのリストに格納されます。FML フィールド テーブル ファイルのフィールド名は、構造化イベント内の名前と一致していなければなりません。フィールドの型には、carray を除くすべての FML 型 (long、short、double、float、char、string) を使用できます。構造化イベントの値は、フィールド テーブルで定義されている型と同じでなければなりません。表 2-1 は、Oracle Tuxedo でサポートされている CORBA Any 型を示しています。これらの Any 型を使用して、データのフィルタ処理と Oracle Tuxedo の相互運用性を実現できます。

コード リスト 2-2 は、FML フィールド テーブル ファイルの例です。*base 2000 は、フィールドのベース番号です。最初のエントリでは、フィールド名が billing、フィールド番号が 1 (ベース番号に基づく値)、フィールドの型が long となっています。

*base 2000

#Field Name       Field #  Field Type    Flags     Comments
#-----------      -------  ----------    ------    --------
billing           1        long            -          -
stock_name        2        string          -          -
price_per_share   3        double          -          -
number_of_shares  5        long            -          -

Oracle Tuxedo の FML フィールド テーブル ファイルには、次のガイドラインと制限が適用されます。

FML フィールド テーブル ファイルの作成とコンフィグレーションの方法については、『Tuxedo コマンド リファレンス』の「field_tables」および『FML を使用した Tuxedo アプリケーションのプログラミング』を参照してください。

Oracle Tuxedo アプリケーションとの相互運用性

Oracle Tuxedo CORBA ノーティフィケーション サービスを使用するアプリケーションは、Oracle Tuxedo EventBroker を使用する Oracle Tuxedo アプリケーションと相互運用できます。Oracle Tuxedo ノーティフィケーション サービスを使用するアプリケーションでは、Oracle Tuxedo EventBroker のサブスクライバに配信されるイベントをポストでき、Oracle Tuxedo EventBroker によってポストされたイベントを受信できます。

この相互運用性を実現するには、Oracle Tuxedo で FML フィールド テーブルの内容を調整できるように、CosNotification 構造化イベントと Oracle Tuxedo FML バッファのマッピングを理解する必要があります。考慮すべき状況は 2 つあります。Oracle Tuxedo EventBroker を介して Oracle Tuxedo アプリケーションによって受信されるイベントのポストと、Oracle Tuxedo アプリケーションによってノーティフィケーション サービスのイベント チャネルにポストされたイベントの受信です。

イベントのポスト

Oracle Tuxedo アプリケーションによってポストされたイベントを Oracle Tuxedo アプリケーションでサブスクライブするには、Oracle Tuxedo 構造化イベントがポスト時にどのように FML32 およびイベント名にマッピングされるのかを理解する必要があります。マッピングは次のように行われます。

イベントの受信

Oracle Tuxedo のシステム イベントとユーザ イベントは、Oracle Tuxedo アプリケーションで受信できます。システム イベントを生成するのは、アプリケーションではなく、Oracle Tuxedo システムです。ユーザ イベントは、Oracle Tuxedo アプリケーションによって生成されます。システム イベントのリストについては、『Tuxedo コマンド リファレンス』の「EVENTS」を参照してください。システム イベントとユーザ イベントは、CosNotification 構造化イベントで次のようにマッピングされます。

Oracle Tuxedo システムでは、システムの警告と障害に関連する定義済みの特定のイベントが検出されてポストされます。たとえば、システム生成のイベントでは、コンフィグレーションの変更、状態の変化、接続の障害、およびマシンの分断が報告されます。

Oracle Tuxedo アプリケーションによってポストされたイベントを Oracle Tuxedo アプリケーションで受信するには、Oracle Tuxedo イベントが格納されている FML バッファをどのように使用して Oracle Tuxedo 構造化イベントが作成されるのかを理解する必要があります。また、domain_name と type_name の Oracle Tuxedo イベント名との関連を理解することも必要です。システム イベントとユーザ イベントの 2 つのケースを考慮する必要があります。

Oracle Tuxedo では、イベント名の先頭にドット (.) を使用してシステム生成のイベントをアプリケーション定義のイベントから区別します。たとえば、システム イベントには .SysNetworkDropped があります。ユーザ イベントの例としては、eventsdropped があります。それらのイベントをサブスクライブするために、ノーティフィケーション サービスのサブスクライバ アプリケーションではサブスクリプションを次のように定義する必要があります。

サブスクリプションの作成時に使用するパラメータ

サブスクリプションを作成するときには、次のパラメータを指定できます。これらのパラメータでは、Oracle のシンプル イベント API と CosNotification サービス API がサポートされています。

subscription_name

domain_type

type_name

data_filter

データのフィルタ処理を利用するには、FML テーブルを設定し、サブスクリプションにフィルタを含めて、データをフィルタ処理し、イベントをポストします。コード リスト 2-3 は、それらのタスクの例を示しています。

// FML テーブルを設定

Field table file.
----------------
*base 2000

*Field Name    Field #   Field Type   Flags    Comments
-----------    -------   ---------    ------   ------
StockName        1        string        -        -
PricePerShare    2        double        -        -
CustomerId       3        long          -        - 
CustomerName     4        string        -        -

// サブスクリプション データのフィルタ処理
1) "NumberOfShares > 100 && NumberOfShares < 1000"
2) "CustomerId == 3241234"
3) "PricePerShare > 125.00"
4) "StockName == 'BEAS'"
5) "CustomerName %% '.*Jones.*'" // CustomerName が「Jones」を格納
6) "StockName == 'BEAS' && PricePerShare > 150.00"

// イベントをポスト
// C++
CosNotification::StructuredEvent ev;
...
ev.filterable_data[0].name    = CORBA::string_dup("StockName");
ev.filterable_data[0].value <<= "BEAS";
ev.filterable_data[1].name    = CORBA::string_dup("PricePerShare");
ev.filterable_data[1].value <<= CORBA::Double(175.00);
ev.filterable_data[2].name    = CORBA::string_dup("CustomerId");
ev.filterable_data[2].value <<= CORBA::Long(1234567);
ev.filterable_data[3].name    = CORBA::string_dup("CustomerName");
ev.filterable_data[3].value <<= "Jane Jones";

push_consumer

qos (サービスの品質)

Oracle シンプル イベント API

単純さと使いやすさが、Oracle シンプル イベント アプリケーション プログラミング インタフェース (API) の特徴と言えます。その機能は、Oracle Tuxedo EventBroker の機能と似ています。

Oracle シンプル イベント API は、次のインタフェースで構成されます (図 2-2 を参照)。

Tobj_SimpleEvents::Channel インタフェースと Tobj_SimpleEvents::ChannelFactory インタフェースは、ノーティフィケーション サービスによって実装されます (説明は後述)。

CosNotifyComm::StructuredPushConsumer インタフェースは、サブスクライバによって実装されます。このインタフェースの説明については、「CosNotifyComm::StructuredPushConsumer::push_structured_event」を参照してください。

TOBJ_SimpleEvents::Channel インタフェース

Channel インタフェースは次のように使用されます。

このインタフェースには、次のオペレーションがあります。

このインタフェースの CORBA IDL は次のとおりです。

module Tobj_SimpleEvents
  {
  typedef long   SubscriptionID;
  typedef string RegularExpression;
  typedef string FilterExpression;

  const SubscriptionType TRANSIENT_SUBSCRIPTION = 0;
  const SubscriptionType PERSISTENT_SUBSCRIPTION = 1;

interface Channel
    {
     void push_structured_event(
         in  CosNotification::StructuredEvent   event);

     SubscriptionID subscribe (
       in    string                            subscription_name,
       in    RegularExpression                 domain,
       in    RegularExpression                 type,
       in    FilterExpression                  data_filter,
       in    CosNotification::QoSProperties    qos,
       in    CosNotifyComm::StructuredPushConsumer push_consumer);

     boolean exists( in SubscriptionID id );

     void unsubscribe( in SubscriptionID  id );
    };
  };

これらのオペレーションについては、次の節を参照してください。

Channel::subscribe

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
);

パラメータ

このオペレーションでサポートされているパラメータの説明については、「サブスクリプションの作成時に使用するパラメータ」を参照してください。

例外

CORBA::BAD_PARAM

CORBA::IMP_LIMIT

CORBA::INV_OBJREF

説明

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

データのフィルタ処理を利用するか、あるいは Oracle Tuxedo システム イベントまたは Oracle Tuxedo アプリケーションでポストされたイベントをサブスクライブするには、「イベントの FML フィールド テーブル ファイルの作成」および「Oracle Tuxedo アプリケーションとの相互運用性」を参照してください。

戻り値

ユニークなサブスクリプション識別子が返されます。このオペレーションの結果は即時には現れません。このオペレーションからの復帰とイベント配信の実際の開始の間には遅延があります。遅延期間の長さは、コンフィグレーション次第ではかなり長くなります。この遅延期間に影響する要素の詳細については、「データベースの同期」を参照してください。

例

C++ サンプル コード

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

Channel::unsubscribe

CORBA IDL

void unsubscribe( in SubscriptionID id );

パラメータ

subscription_id

例外

CORBA::BAD_PARAM

説明

アンサブスクライブに使用します。サブスクライバ アプリケーションでは、このオペレーションを使用してサブスクリプションを終了します。このオペレーションから復帰すると、それ以降にイベントは配信できません。入力パラメータは、サブスクライブ時に取得した SubscriptionID 1 つです。

例

C++ サンプル コード

channel->unsubscribe(subscription_id);

Channel::push_structured_event

CORBA IDL

void push_structured_event(
      in   CosNotification::StructuredEvent   notification
);

パラメータ

notification

例外

CORBA_IMP_LIMIT

説明

ノーティフィケーション サービスにイベントをポストするためにポスト元アプリケーションで使用されます。

例

C++ サンプル コード

channel->push_structured_event(notification);

Channel::exists

CORBA IDL

boolean exists(in SubscriptionID subscription_id);

パラメータ

subscription_id

例外

CORBA::BAD_PARAM

説明

サブスクリプションが存在するかどうかを確認するためにサブスクライバ アプリケーションによって使用されます。システム管理者はサブスクリプションを手動で削除でき、ノーティフィケーション サービスでは一時的なサブスクリプションを自動的に削除できるので、サブスクライバ アプリケーションでは必要に応じてサブスクリプションを再作成できるようにこのオペレーションを使用する必要があります。このオペレーションで使用する subscription_id は、サブスクライブ時に取得した同じ識別子です。

戻り値

サブスクリプションが存在する場合は true、存在しない場合は false が返されます。

例

C++ サンプル コード

if channel->exists (subscription_id) {
    // サブスクリプションは依然として有効
} else {
  // サブスクリプションはもう存在しない

}

TOBJ_SimpleEvents::ChannelFactory インタフェース

ChannelFactory インタフェースは、イベント チャネルの検索に使用します。このインタフェースには、find_channel という 1 つのオペレーションがあります。

このインタフェースの CORBA IDL は次のとおりです。

module Tobj_SimpleEvents
{
  typedef long   ChannelID;

interface ChannelFactory
{
 Channel find_channel(
   in ChannelID channel_id // DEFAULT_CHANNEL でなければならない
  );
 };
};

Channel_Factory::find_channel

CORBA IDL

Channel find_channel(
      in  ChannelID  channel_id );

パラメータ

このリリースの Oracle Tuxedo では、イベント チャネルは 1 つだけです。したがって、ChannelID は Tobj_SimpleEvents::DEFAULT_CHANNEL (C++) に設定する必要があります。

例外

CORBA::BAD_PARAM

説明

ポスト元アプリケーションとサブスクライバ アプリケーションによって使用されます。このオペレーションを使用すると、イベント チャネルを見つけて、ポスト元ではイベントをポストし、サブスクライバではイベントをサブスクライブおよびアンサブスクライブできます。

戻り値

デフォルト イベント チャネルのオブジェクト参照が返されます。

例

C++ サンプル コード

channel_factory->find_channel(
               Tobj_SimpleEvents::DEFAULT_CHANNEL);

CosNotification サービス API

この節では、Oracle Tuxedo CORBA ノーティフィケーション サービスによって実装される CosNotification サービスで定義されるオペレーションについて説明します。それらのオペレーションは、オペレーション セット全体のサブセットです。このサブセットは、Oracle シンプル イベント API の代わりとして使用できる機能的に完全な API です。

この API は、Oracle シンプル イベント API よりも複雑です。それには、2 つの理由があります。まず、CosNotification サービス API がより複雑になっています。次に、CosNotification サービス API の Oracle Tuxedo 実装では、サポートされるオペレーションに制限が追加されます。このように複雑でも、パフォーマンスまたは柔軟性の点で利点はないので、できる限りに Oracle シンプル イベント API を使用することをお勧めします。

CosNotification API は、可搬性を実現するため、できる限り標準の API を使用する必要がある場合のために用意されています。この API では、機能の点で、シンプル イベント API を上回る利点は提供されません。この API を使用して開発されたアプリケーションは、ほぼ可搬性がありますが、完全ではありません。その理由は、完全な可搬性を実現できるほど CosNotification サービス API が十分にサポートされていないことです。たとえば、CORBA ベースのノーティフィケーション サービスで使用するフィルタ処理の文法は COS Trader 文法に基づいています。Oracle Tuxedo ではこの文法がサポートされていず、Oracle Tuxedo EventBroker の文法に基づく別の文法がサポートされているので、フィルタ処理を必要とするアプリケーションは可搬になりません。同じことが QoS についても言えます。つまり、CosNotification サービス API では CORBA ベースのノーティフィケーション サービスの標準のサービス品質がサポートされていず、別のサービス品質がサポートされています。

サポートされている CosNotification サービスのクラスの概要

図 2-3 は、このリリースの Oracle Tuxedo で (完全または部分的に) 実装されている CosNotification サービスのクラスとそれらの関係を示しています。

各クラスでサポートされているオペレーションについては、以下に要約があります。詳細については、「CosNotification サービスのクラスの詳しい説明」を参照してください。

CosNotification サービスのクラスの詳しい説明

この節では、このリリースの Oracle Tuxedo で実装される CosNotification サービスのクラスについて説明します。それらのクラスは、tuxdir\include ディレクトリにある CosNotification サービスの IDL ファイルで完全に記述されています。

CosNotifyFilter::Filter クラス

このクラスは、イベント サブスクライバ アプリケーションによって使用されます。このクラスの OMG IDL は次のとおりです。

Module CosNotifyFilter
{
interface Filter { 
     ConstraintInfoSeq add_constraints (
             in ConstraintExpSeq constraint)
          raises (InvalidConstraint);

      void destroy();
    };
}; //CosNotifyFilter

CosNotifyFilter::Filter::add_constraints

概要

フィルタ オブジェクトでドメイン、型、およびデータ フィルタの各パラメータを設定します。

OMG IDL

ConstraintInfoSeq add_constraints (
             in ConstraintExpSeq constraint)
          raises (InvalidConstraint);

例外

CosNotifyFilter::InvalidConstraint

CORBA::BAD_PARAM

CORBA_IMP_LIMIT

説明

サブスクライブするときに使用します。このオペレーションは、サブスクライブするイベントの種類を定義するためにサブスクライバ アプリケーションで使用されます。フィルタ オブジェクトのドメイン、型、およびデータ フィルタの各パラメータを設定します。これらのパラメータの説明については、「サブスクリプションの作成時に使用するパラメータ」を参照してください。

戻り値

空のリストが返されます。呼び出し側では無視することをお勧めします。

例

C++ サンプル コード

// フィルタ処理パラメータを設定
// (ドメイン = "News"、型、およびデータ フィルタなし)
CosNotifyFilter::ConstraintExpSeq constraints;
constraints.length(1);
constraints[0].event_types.length(1);
constraints[0].event_types[0].domain_name =
    CORBA::string_dup("News");
constraints[0].event_types[0].type_name = 
                CORBA::string_dup (“Sports”);
// データ フィルタなし
constraints[0].constraint_expr = CORBA::string_dup("");           CosNotifyFilter::ConstraintInfoSeq_var
add_constraints_results = // この戻り値は無視
     filter->add_constraints(constraints);

CosNotifyFilter::Filter::destroy

概要

フィルタ オブジェクトを破棄します。

OMG IDL

void destroy();

例外

CORBA::BAD_PARAM

説明

アンサブスクライブするときに使用します。このオペレーションは、フィルタ オブジェクトを破棄するためにサブスクライバ アプリケーションで使用されます。

CosNotifyFilter::FilterFactory クラス

このクラスは、イベント サブスクライバ アプリケーションによって使用されます。このクラスの OMG IDL は次のとおりです。

Module CosNotifyFilter
{
interface FilterFactory {
   Filter create_filter (
          in string constraint_grammar)
      raises (InvalidGrammar);
   destroy();
  }; 
}; //CosNotifyFilter

CosNotifyFilter::FilterFactory::create_filter

概要

どのイベントがサブスクリプションに配信されるのかを指定します。

OMG IDL

Filter create_filter (
in string constraint_grammar)
raises (InvalidGrammar);

例外

CosNotifyFilter::InvalidGrammar

説明

新しいフィルタ オブジェクトを作成するためにサブスクライバ アプリケーションで使用されます。このフィルタは、どのイベントがサブスクリプションに配信されるのかを指定するために使用します。サブスクライバでは、フィルタを設定して 5 分以内にプロキシに追加する必要があります。5 分以内に追加しないと、フィルタは破棄されます。フィルタの文法は、Tobj_Notification::Constraint_grammar に設定する必要があります。そうしないと、InvalidGrammar 例外が発生します。

戻り値

新しいフィルタのオブジェクト参照が返されます。

例

C++ サンプル コード

filter_factory->create_filter(
      Tobj_Notification::CONSTRAINT_GRAMMAR
);

CosNotifyChannelAdmin::StructuredProxyPushSupplier クラス

このクラスは、イベント サブスクライバ アプリケーションによって使用されます。このクラスの OMG IDL は次のとおりです。

Module CosNotifyChannelAdmin
{
 interface StructuredProxyPushSupplier : 
       ProxySupplier,
       CosNotifyComm::StructuredPushSupplier {

    void connect_structured_push_consumer (
           in CosNotifyComm::StructuredPushConsumer push_consumer)
         raises(CosEventChannelAdmin::AlreadyConnected,
                 CosEventChannelAdmin::TypeError );
    };
    // 次のオペレーションが継承される
    void set_qos(in QoSProperties qos) 
         raises (UnsupportedQoS);
    FilterID add_filter (in Filter new_filter );
    Filter get_filter( in FilterID filter )
         raises ( FilterNotFound);
    void disconnect_structured_push_supplier();
    readonly attribute ProxyType     MyType;
  };
}; //CosNotifyChannelAdmin

CosNotifyChannelAdmin::StructuredProxyPushSupplier:: connect_structured_push_consumer

概要

サブスクリプションを完了します。

OMG IDL

void connect_structured_push_consumer (
in CosNotifyComm::StructuredPushConsumer push_consumer)
raises(CosEventChannelAdmin::AlreadyConnected,
CosEventChannelAdmin::TypeError );

例外

CosEventChannelAdmin::TypeError

CORBA::INV_OREF

CORBA::IMP_LIMIT

CORBA::OBJECT_NOT_EXIST

CosEventChannelAdmin::AlreadyConnected

説明

このオペレーションは、サブスクライブするときに使用します。このオペレーションは、イベントをサブスクライブするためにサブスクライバ アプリケーションで使用されます。push_consumer パラメータは、サブスクライバのコールバック オブジェクトを識別します。

connect_structured_push_consumer が呼び出されると、ノーティフィケーション サービスはコールバック オブジェクトの push_structured_event オペレーションを呼び出してサブスクライバにイベントを送信します。connect_structured_push_consumer が既に呼び出されている場合は、AlreadyConnected 例外が発生します。

例

C++ サンプル コード

subscription->connect_structured_push_consumer(
    news_consumer.in()
);

CosNotifyChannelAdmin::StructuredProxyPushSupplier::set_qos

概要

サブスクリプションの QoS を設定します。

OMG IDL

void set_qos(in QoSProperties qos)
raises (UnsupportedQoS);

例外

UnsupportedQoS

ORBA::IMP_LIMIT

説明

サブスクライブするときに使用します。このオペレーションは、サブスクリプションの QoS を設定するためにサブスクライバ アプリケーションで使用されます。このオペレーションは、サブスクライバが要求しているサービス品質プロパティ設定をカプセル化する名前と値のペアのシーケンスを入力パラメータとしてとります。

QoS は、サブスクリプションの種類とサブスクリプションの名前という 2 つ要素で構成されます。サブスクリプションの種類は、名前と値のペアを作成して設定します。その名前は Tobj_Notification::SUBSCRIPTION_TYPE で、値は Tobj_Notification::PERSISTENT_SUBSCRIPTION または Tobj_Notification::TRANSIENT_SUBSCRIPTION です。詳細については、「サービスの品質」を参照してください。

サブスクリプションの名前は、名前と値のペアを作成して設定します。その名前は Tobj_Notification::SUBSCRIPTION_NAME で、値はユーザ定義の文字列です。

このパラメータの詳細については、「サブスクリプションの作成時に使用するパラメータ」を参照してください。

例

C++ サンプル コード

CosNotification::QoSProperties qos;
qos.length(2);
qos[0].name =
    CORBA::string_dup(Tobj_Notification::SUBSCRIPTION_NAME);
qos[0].value <<= “MySubsription”;
qos[1].name =
    CORBA::string_dup(Tobj_Notification::SUBSCRIPTION_TYPE);
qos[1].value <<=
    Tobj_Notification::TRANSIENT_SUBSCRIPTION;

subscription->set_qos(qos);

CosNotifyChannelAdmin::StructuredProxyPushSupplier::add_filter

概要

サブスクライバのコールバック オブジェクトでフィルタ オブジェクトを設定します。

OMG IDL

add_filter(
      in Filter new_filter
);

例外

CORBA::IMP_LIMIT

CORBA::OBJECT_NOT_EXIST

説明

サブスクライブするときに使用します。このオペレーションは、サブスクライバのコールバック オブジェクトのフィルタ オブジェクトを設定するためにサブスクライバ アプリケーションで使用されます。このオペレーションを使用するアプリケーションが停止されて再起動される場合は、filter_id を永続ストレージに書き込む必要があります。

戻り値

filter_id が返されます。

例

C++ サンプル コード

CosNotifyFilter::FilterID filter_id =
      subscription->add_filter(filter.in());

CosNotifyChannelAdmin::StructuredProxyPushSupplier::get_filter

概要

サブスクライバのコールバック オブジェクトに現在関連付けられているフィルタのオブジェクト参照を取得します。

OMG IDL

Filter get_filter( in FilterID filter )
      raises ( FilterNotFound);

例外

CosNotifyChannelAdmin::FilterNotFound

説明

再起動可能なサブスクライバでアンサブスクライブする必要があるときに使用します。このオペレーションは、サブスクライバのコールバック オブジェクトと現在関連付けられているフィルタのオブジェクト参照を取得するためにサブスクライバ アプリケーションで使用されます。渡される FilterID は、サブスクライバの StructuredProxyPushSupplier オブジェクトで有効でなければなりません。FilterID がイベント チャネルと関連付けられているプロキシ オブジェクトで有効ではない場合は、FilterNotFound 例外が送出されます。このオペレーションは、停止して再起動されるサブスクライバでのみ使用されます。

制限事項

このオペレーションでは、次の制限とガイドラインが適用されます。

戻り値

サブスクライバのコールバック オブジェクトに現在関連付けられているフィルタのオブジェクト参照が返されます。

例

C++ サンプル コード

CosNotify::Filter_var filter = 
     subscription->get_filter( filter_id() );

CosNotifyChannelAdmin::StructuredProxyPushSupplier::
disconnect_structured_push_supplier

概要

アンサブスクライブに使用します。

OMG IDL

void disconnect_structured_push_supplier();

例外

CORBA::OBJECT_NOT_EXIST

説明

アンサブスクライブするときにサブスクライバ アプリケーションによって使用されます。このオペレーションは、ノーティフィケーション サービスとサブスクライバのコールバック オブジェクトの接続を終了するためにサブスクライバ アプリケーションで使用されます。

例

C++ サンプル コード

subscription->disconnect_structured_push_supplier();

CosNotifyChannelAdmin::StructuredProxyPushSupplier::MyType

概要

常に CosNotifyChannelAdmin::PUSH_STRUCTURED プロキシを返します。

OMG IDL

readonly attribute ProxyType MyType

説明

常に CosNotifyChannelAdmin::PUSH_STRUCTURED プロキシを返します。

CosNotifyChannelAdmin::StructuredProxyPushConsumer クラス

このクラスは、イベント ポスト元アプリケーションによって使用されます。このクラスの OMG IDL は次のとおりです。

Module CosNotifyChannelAdmin
{
 interface StructuredProxyPushConsumer : 
       ProxyConsumer,
       CosNotifyComm::StructuredPushConsumer {

    void connect_structured_push_supplier (
          in CosNotifyComm::StructuredPushSupplier push_supplier)
       raises(CosEventChannelAdmin::AlreadyConnected);
    // 次のオペレーションが継承される
    readonly attribute MyType;
    void push_structured_event(
          in CosNotification::StructuredEvent notification ) 
       raises( CosEventComm::Disconnected );
    void disconnect_structured_push_consumer();
   }; 
}; \\StructuredProxyPushConsumer

CosNotifyChannelAdmin::StructuredProxyPushConsumer::
connect_structured_push_supplier

概要

イベントを受信するようにノーティフィケーション サービスを準備します。

OMG IDL

void connect_structured_push_supplier (
          in CosNotifyComm::StructuredPushSupplier push_supplier)
       raises(CosEventChannelAdmin::AlreadyConnected);

例外

CosEventChannelAdmin::AlreadyConnected

説明

イベントのポスト時にポスト元アプリケーションによって使用されます。このオペレーションを呼び出さないと、ノーティフィケーション サービスではイベント受信の準備ができません。また、このオペレーションを使用するときには NIL を渡す必要があります。次の順序で使用します。

例

C++ サンプル コード

proxy_push_consumer->connect_structured_push_supplier(
      CosNotifyComm::StructuredPushSupplier::_nil()
    );

CosNotifyChannelAdmin::StructuredProxyPushConsumer::
push_structured_event

概要

イベント チャネルにイベントをポストします。

OMG IDL

void push_structured_event(
        in CosNotification::StructuredEvent notification ) 
     raises( CosEventComm::Disconnected );

例外

CosEventComm::Disconnected

CORBA::IMP_LIMIT

説明

イベントをポストするときに使用します。このオペレーションは、イベント チャネルにイベントをポストするためにポスト元アプリケーションで使用されます。

例

C++ サンプル コード

proxy_push_consumer->push_structured_event(notification);

CosNotifyChannelAdmin::StructuredProxyPushConsumer::
disconnect_structured_push_consumer

概要

イベントのポストを停止します。

OMG IDL

void disconnect_structured_push_consumer();

説明

イベントをポストするときに使用します。このオペレーションは、イベントのポストを停止するためにポスト元アプリケーションによって使用されます。入力パラメータは不要で、値は返されません。次の順序で使用することをお勧めします。

例

C++ サンプル コード

proxy_push_consumer->disconnect_structured_push_consumer();

CosNotifyChannelAdmin::StructuredProxyPushConsumer::MyType

概要

常に CosNotifyChannelAmdmin::PUSH_STRUCTURED プロキシを返します。

OMG IDL

readonly attribute ProxyType MyType

説明

常に CosNotifyChannelAmdmin::PUSH_STRUCTURED プロキシを返します。

CosNotifyChannelAdmin::ConsumerAdmin クラス

このクラスは、イベント サブスクライバ アプリケーションによって使用されます。このクラスの OMG IDL は次のとおりです。

Module CosNotifyChannelAdmin
{
 interface ConsumerAdmin : 

       CosNotification::QoSAdmin,
       CosNotifyComm::NotifySubscribe,
       CosNotifyFilter::FilterAdmin,
       CosEventChannelAdmin::ConsumerAdmin {

    ProxySupplier obtain_notification_push_supplier (
           in ClientType ctype,
           out ProxyID proxy_id)
         raises ( AdminLimitExceeded )

    ProxySupplier get_proxy_supplier (
           in ProxyID proxy_id )
        raises ( ProxyNotFound );

  }; 
}; //CosNotifyChannelAdmin

CosNotifyChannelAdmin::ConsumerAdmin::
obtain_notification_push_supplier

概要

プロキシ プッシュ サプライヤ オブジェクトを作成します。

OMG IDL

ProxySupplier obtain_notification_push_supplier (
           in ClientType ctype,
           out ProxyID proxy_id)
         raises ( AdminLimitExceeded )

例外

CosNotifyChannelAdmin::AdminLimitExceeded

CORBA::IMP_LIMIT

説明

サブスクライブするときに使用します。このオペレーションは、プロキシ プッシュ サプライヤ オブジェクトを作成するためにサブスクライバ アプリケーションで使用されます。構造化イベントのみがサポートされています。つまり、ANY_EVENT と SEQUENCE_EVENT ClientTypes はサポートされていません。したがって、ClientType 入力パラメータは CosNotifyComm::STRUCTURED_EVENT に設定する必要があります。サブスクライバを停止して再起動する場合で、サブスクリプションがプログラムの複数の実行にまたがって存続する場合は、このオペレーションで返される ProxyID を永続的に保存する必要があります。サブスクライバでは、プロキシ サプライヤを CosNotifyChannelAdmin::StructuredProxyPushSupplier にナロー変換する必要があります。必要なすべてのオペレーションは 5 分間で完了する必要があります。

戻り値

このオペレーションでは、新しいプロキシのオブジェクト参照が返されます。新しい proxy_id も、proxy_id 出力パラメータを通じて返されます。

例

C++ サンプル コード

CosNotifyChannelAdmin::ProxySupplier_var generic_proxy =
       consumer_admin->obtain_notification_push_supplier(
          CosNotifyChannelAdmin::STRUCTURED_EVENT,
          proxy_id
        );

CosNotifyChannelAdmin::StructuredProxyPushSupplier_var proxy =
CosNotifyChannelAdmin::StructuredProxyPushSupplier::_narrow(
generic_proxy.in ()
);

CosNotifyChannelAdmin::ConsumerAdmin::get_proxy_supplier

概要

コンシューマ管理オブジェクトの obtain_notification_push_supplier オペレーションを使用して作成されたプロキシ プッシュ サプライヤ オブジェクトを返します。

OMG IDL

    ProxySupplier get_proxy_supplier (
           in ProxyID proxy_id )
        raises ( ProxyNotFound );

例外

CosNotifyChannelAdmin::ProxyNotFound

説明

アンサブスクライブするときに使用します。このオペレーションは、コンシューマ管理オブジェクトの obtain_notification_push_supplier オペレーションを使用して作成されたプロキシ プッシュ サプライヤ オブジェクトを返すためにサブスクライバ アプリケーションで使用されます。ProxyID 入力パラメータは、プロキシ オブジェクトをユニークに識別します。呼び出し側では、一時的なサブスクリプションの配信エラーまたは ntsadmin 管理コマンドによってプロキシ オブジェクトが破棄される可能性があることを認識していなければなりません。プロキシ オブジェクトが破棄されると、関連付けられている ProxyID が無効になります。ProxyID が無効な場合は、ProxyNotFound 例外が発生します。サブスクライバでは、プロキシ サプライヤを CosNotifyChannelAdmin::StructuredProxyPushSupplier にナロー変換する必要があります。

戻り値

既存のプロキシのオブジェクト参照が返されます。

例

C++ サンプル コード

CosNotifyChannelAdmin::ProxySupplier_var generic_proxy =
        m_consumer_admin->get_proxy_supplier(
          m_subscription_info.news_proxy_id()
        );

CosNotifyChannelAdmin::StructuredProxyPushSupplier_var proxy =
      CosNotifyChannelAdmin::StructuredProxyPushSupplier::_narrow(
          generic_proxy.in()
      );

CosNotifyChannelAdmin::SupplierAdmin クラス

このクラスは、イベント ポスト元アプリケーションによって使用されます。このクラスの OMG IDL は次のとおりです。

Module CosNotifyChannelAdmin
{
 interface SupplierAdmin : 
        CosNotification::QoSAdmin,
        CosNotifyComm::NotifyPublish,
        CosNotifyFilter::FilterAdmin,
        CosEventChannelAdmin::SupplierAdmin {

     ProxyConsumer obtain_notification_push_consumer (
               in ClientType ctype,
               out ProxyID proxy_id)
        raises ( AdminLimitExceeded );
  }; 
}; //SupplierAdmin

CosNotifyChannelAdmin::SupplierAdmin::
obtain_notification_push_consumer

概要

プロキシ プッシュ コンシューマ オブジェクトを作成します。

OMG IDL

ProxyConsumer obtain_notification_push_consumer (
             in ClientType ctype,
             out ProxyID proxy_id)
        raises ( AdminLimitExceeded );

例外

CosNotifyChannelAdmin::AdminLimitExceeded

CORBA::IMP_LIMIT

説明

イベントをポストするときに使用します。このオペレーションは、プロキシ プッシュ コンシューマ オブジェクトを作成するためにポスト元アプリケーションで使用されます。ClientType は、“CosNotifyChannelAdmin::STRUCTURED_EVENT” に設定する必要があります。返される ProxyID は無視してください。プロキシ コンシューマは、CosNotifyChannelAdmin::StructuredProxyPushConsumer にナロー変換する必要があります。

戻り値

このオペレーションでは、新しいプロキシのオブジェクト参照が返されます。新しい proxy_id も、proxy_id 出力パラメータを通じて返されます。

例

C++ サンプル コード

CosNotifyChannelAdmin::ProxyConsumer_var generic_proxy_consumer =
      supplier_admin->obtain_notification_push_consumer(
        CosNotifyChannelAdmin::STRUCTURED_EVENT,
        proxy_id
      );

CosNotifyChannelAdmin::StructuredProxyPushConsumer_var
   proxy_push_consumer =
      CosNotifyChannelAdmin::StructuredProxyPushConsumer::_narrow(
        generic_proxy_consumer
      );

CosNotifyChannelAdmin::EventChannel クラス

このクラスは、イベント ポスト元アプリケーションによって使用されます。このクラスの OMG IDL は次のとおりです。

Module CosNotifyChannelAdmin
{
 interface EventChannel :
       CosNotification::QoSAdmin,
       CosNotification::AdminPropertiesAdmin,
       CosEventChannelAdmin::EventChannel {

     readonly attribute ConsumerAdmin default_consumer_admin;
     readonly attribute SupplierAdmin default_supplier_admin;
     readonly attribute CosNotifyFilter::FilterFactory
                                default_filter_factory;
  }; 
}; //CosNotifyChannelAdmin

CosNotifyChannelAdmin::EventChannel::
ConsumerAdmin default_consumer_admin

概要

ConsumerAdmin オブジェクトを取得します。

OMG IDL

readonly attribute ConsumerAdmin default_consumer_admin;

説明

サブスクライブおよびアンサブスクライブするときに使用します。このオペレーションは、ConsumerAdmin オブジェクトを取得するためにサブスクライバ アプリケーションで使用されます。

戻り値

ConsumerAdmin オブジェクトのオブジェクト参照が返されます。

例

C++ サンプル コード

channel->default_consumer_admin();

CosNotifyChannelAdmin::EventChannel::
ConsumerAdmin default_supplier_admin

概要

SupplierAdmin オブジェクトを取得します。

OMG IDL

readonly attribute SupplierAdmin default_supplier_admin;

説明

イベントをポストするときに使用します。このオペレーションは、SupplierAdmin オブジェクトを取得するためにイベント ポスト元アプリケーションで使用されます。

戻り値

SupplierAdmin のオブジェクト参照が返されます。

例

C++ サンプル コード

channel->default_supplier_admin();

CosNotifyChannelAdmin::EventChannel::default_filter_factory

概要

デフォルトの FilterFactory オブジェクトを取得します。

OMG IDL

readonly attribute CosNotifyFilter::FilterFactory
            default_filter_factory;

説明

サブスクライブするときに使用します。このオペレーションは、デフォルトの FilterFactory オブジェクトを取得するためにサブスクライバ アプリケーションで使用されます。

戻り値

デフォルトの FilterFactory オブジェクトのオブジェクト参照が返されます。

例

C++ サンプル コード

channel->default_filter_factory();

CosNotifyChannelAdmin::EventChannelFactory クラス

このクラスは、イベント ポスト元アプリケーションによって使用されます。このクラスの OMG IDL は次のとおりです。

Module CosNotifyChannelAdmin
{
 interface EventChannelFactory {
     EventChannel get_event_channel ( in ChannelID id )
     raises (ChannelNotFound);
   }; 
}; //CosNotifyChannelAdmin

CosNotifyChannelAdmin::EventChannelFactory::get_event_channel

概要

EventChannel オブジェクトを取得します。

OMG IDL

EventChannel get_event_channel ( in ChannelID id )
     raises (ChannelNotFound);

例外

CosNotifyChannelAdmin::ChannelNotFound

説明

イベントをサブスクライブ、アンサブスクライブ、およびポストするときに使用します。このオペレーションは、EventChannel オブジェクトを取得するためにアプリケーションで使用されます。サブスクライブのときには、EventChannel オブジェクトを使用してフィルタ ファクトリ オブジェクトと ConsumerAdmin オブジェクトを取得します。アンサブスクライブのときには、EventChannel オブジェクトを使用して ConsumerAdmin オブジェクトを取得します。イベントをポストするときには、EventChannel オブジェクトを使用して SupplierAdmin オブジェクトを取得します。ChannelID パラメータは、Tobj_Notification::DEFAULT_CHANNEL に設定しなければなりません。そのように設定しないと、ChannelNotFound 例外が発生します。

戻り値

デフォルト イベント チャネルのオブジェクト参照が返されます。

例

C++ サンプル コード

channel_factory->get_event_channel(
    Tobj_Notification::DEFAULT_CHANNEL );

CosNotifyComm::StructuredPushConsumer インタフェース

このインタフェースは、イベントの配信を目的としてイベント サブスクライバ アプリケーションによって使用されます。このインタフェースを実装しないと、ノーティフィケーション サービスではサブスクライバにイベントを配信できません。このインタフェースには、実装しなければならない 3 つのメソッドがあります。

このクラスの OMG IDL は次のとおりです。

Module CosNotifyComm
{
 interface StructuredPushConsumer : NotifyPublish {

    void push_structured_event(
          in CosNotification::StructuredEvent event)
      raises(CosEventComm::Disconnected);
    void disconnect_structured_push_consumer:
    // 次のオペレーションが継承される
    void offer_change(
          in CosNotification::EventTypeSeq added,
          in CosNotification::EventTypeSeq removed )
      raises ( InvalidEventType );
  }; 
}; //CosNotifyComm

CosNotifyComm::StructuredPushConsumer::push_structured_event

概要

構造化イベントを配信します。

OMG IDL

void push_structured_event(
          in CosNotification::StructuredEvent event)
      raises(CosEventComm::Disconnected);

例外

CosEventComm::Disconnected

説明

サブスクライブするときに使用します。このオペレーションは、サブスクライバのコールバック オブジェクトによって実装され、構造化イベントが配信されるたびにノーティフィケーション サービスによって呼び出されます。このオペレーションには、1 つの入力パラメータ (構造化イベント) があります。

例

C++ サンプル コード

virtual void push_structured_event(
      const CosNotification::StructuredEvent& notification );
       {
       // イベントを処理
       }

CosNotifyComm::StructuredPushConsumer::
disconnect_structured_push_consumer

概要

呼び出されることはありません。

OMG IDL

void disconnect_structured_push_consumer;

説明

このオペレーションが呼び出されることはありません。サブスクライバ アプリケーションでは、このオペレーションのスタブ アウト バージョンを用意する必要があります。

例

C++ サンプル コード

virtual void push_structured_event(
      const CosNotification::StructuredEvent& notification );
  {
    throw new CORBA::NO_IMPLEMENT();
  }

CosNotifyComm::StructuredPushConsumer::Offer_change

概要

呼び出されることはありません。

OMG IDL

 void offer_change(
          in CosNotification::EventTypeSeq added,
          in CosNotification::EventTypeSeq removed )
      raises ( InvalidEventType );

例外

CosNotifyComm::InvalidEventType

説明

このオペレーションが呼び出されることはありません。サブスクライバ アプリケーションでは、このオペレーションのスタブ アウト バージョンを用意する必要があります。

例

C++ サンプル コード

virtual void offer_change(
      const CosNotification::EventTypeSeq& added,
      const CosNotification::EventTypeSeq& removed )
    {
      throw CORBA::NO_IMPLEMENT();
    } 

例外のマイナー コード

この節では、ノーティフィケーション サービスの例外シンボルとマイナー コードについて説明します。マイナー コードは、Tobj_Events.idl ファイルと Tobj_Notification.idl ファイルにあります。それらのファイルは、tuxdir\include ディレクトリ (Microsoft Windows の場合) および tuxdir/include ディレクトリ (UNIX の場合) に配置されています。

表 2-4 と表 2-5 は、それぞれ Tobj_Events 例外と Tobj_Notification 例外の例外シンボルと対応するマイナー コードを示しています。CORBA システム イベントにはマイナー コード フィールドがあり、それらのマイナー コードも以下の表で定義されています。