Interstage Application Server アプリケーション作成ガイド （イベントサービス編）

4.1 イベントチャネル接続のアプリケーション開発

　イベントチャネル接続での処理手順は、イベントチャネルの作成方法を問わず共通です。イベントサービスを使用する場合、アプリケーションは最初にイベントチャネルと接続する処理を行います。アプリケーションでのイベントチャネルとの接続手順を以下の図に示します。図では、アプリケーション内のメソッドの発行とイベントチャネルとの接続状態を表しています。

イベントサービスの場合

　CプログラムのMixedモデルのアプリケーション作成例と処理の流れを以下に説明します。

[Mixedモデルのアプリケーション作成例（C言語の場合）]

  CORBA_Boolean func() {
  channel = イベントチャネルのオブジェクトリファレンスの獲得           /* 1 */
  supplier = CosEventChannelAdmin_EventChannel_for_suppliers(
                channel, &env );                                       /* 2 */
  proxy_push = CosEventChannelAdmin_SupplierAdmin_obtain_push_consumer(
                supplier, &env );                                      /* 3 */
  CosEventChannelAdmin_ProxyPushConsumer_connect_push_supplier(
                proxy_push, CORBA_OBJECT_NIL, &env);                   /* 4 */
  CosEventChannelAdmin_ProxyPushConsumer_push(
                proxy_push, push_data, &env);                          /* 5 */
  CosEventChannelAdmin_ProxyPushConsumer_disconnect_push_consumer(
                proxy_push, &env );                                    /* 6 */
      ... 
  }

1. イベントチャネルのオブジェクトリファレンスを獲得します。イベントチャネルのオブジェクトリファレンスの獲得方法については、各言語の“アプリケーションの開発”−“イベントチャネルのオブジェクトリファレンスの獲得”を参照してください。
2. CosEventChannelAdmin_EventChannel_for_suppliers()メソッドで、サプライヤ管理のオブジェクトリファレンスを獲得します。
3. CosEventChannelAdmin_SupplierAdmin_obtain_push_consumer()メソッドで、サプライヤに接続するイベントチャネルのオブジェクトを獲得します。
4. CosEventChannelAdmin_ProxyPushConsumer_connect_push_supplier()メソッドで、イベントチャネルとサプライヤを接続します。サプライヤまたはコンシューマとして動作する自アプリケーションのオブジェクトリファレンスをパラメタとして接続時に指定します。自アプリケーションのオブジェクトリファレンスの獲得方法については、各言語の“アプリケーションの開発”−“コンシューマとサプライヤのオブジェクトリファレンスの獲得”を参照してください。
5. CosEventChannelAdmin_ProxyPushConsumer_push()メソッドで、イベントチャネルにイベントデータを送信します。
6. CosEventChannelAdmin_ProxyPushConsumer_disconnect_push_consumer()メソッドで、サプライヤをイベントチャネルと切断します。

ノーティフィケーションサービスの場合

　CプログラムのMixedモデルのアプリケーション作成例と処理の流れを以下に説明します。

[Mixedモデルのアプリケーション作成例（C言語の場合）]

  CORBA_Boolean func() {
  channel = イベントチャネルのオブジェクトリファレンスの獲得     /* 1 */
  supplier = CosNotifyChannelAdmin_EventChannel_get_default_supplier_admin(
                channel, &env ）                                 /* 2 */
  proxy_push= CosNotifyChannelAdmin_SupplierAdmin_obtain_notification_push_consumer (
                supplier,ctype,&proxy_id, &env);                 /* 3 */
  CosNotifyChannelAdmin_StructuredProxyPushConsumer_connect_structured_push_supplier(
                proxy_push, CORBA_OBJECT_NIL, &env );            /* 4 */
  CosNotifyChannelAdmin_StructuredProxyPushConsumer_push_structured_event(
                proxy_push, push_data, &env );                   /* 5 */
  CosNotifyChannelAdmin_StructuredProxyPushConsumer_disconnect_structured_push_consumer(
                proxy_push, &env );                              /* 6 */
      ... 
  }

1. イベントチャネルのオブジェクトリファレンスを獲得します。イベントチャネルのオブジェクトリファレンスの獲得方法については、各言語の“アプリケーションの開発”−“イベントチャネルのオブジェクトリファレンスの獲得”を参照してください。
2. CosNotifyChannelAdmin_EventChannel_get_default_supplier_admin()メソッドで、サプライヤ管理のオブジェクトリファレンスを獲得します。
3. CosNotifyChannelAdmin_SupplierAdmin_obtain_notification_push_consumer()メソッドで、サプライヤに接続するイベントチャネルのオブジェクトを獲得します。
4. CosNotifyChannelAdmin_StructuredProxyPushConsumer_connect_structured_push_supplier()メソッドで、イベントチャネルとサプライヤを接続します。サプライヤまたはコンシューマとして動作する自アプリケーションのオブジェクトリファレンスをパラメタとして接続時に指定します。自アプリケーションのオブジェクトリファレンスの獲得方法については、各言語の“アプリケーションの開発”−“コンシューマとサプライヤのオブジェクトリファレンスの獲得”を参照してください。
5. CosNotifyChannelAdmin_StructuredProxyPushConsumer_push_structured_event()メソッドで、イベントデータを送信します。
6. CosNotifyChannelAdmin_StructuredProxyPushConsumer_disconnect_structured_push_consumer()メソッドで、サプライヤをイベントチャネルと切断します。

　イベントチャネルの接続(connect)を行ったアプリケーションは、必ずイベントチャネルからの切断(disconnect)を行ったうえ、終了するように作成してください。

---

4.1.1 ノーティフィケーションサービスのQoS機能の運用

4.1.2 アプリケーション異常終了時の接続情報の回収方法

4.1.3 イベントチャネルの接続情報の取得