ページの先頭行へ戻る
Interstage Application Server リファレンスマニュアル(API編)
Interstage

3.22.2 com.fujitsu.ObjectDirector.EventService.ESクラス

3.22.2.1 com.fujitsu.ObjectDirector.EventService.ES.ChannelUtil.get_proxys()

名前

com.fujitsu.ObjectDirector.EventService.ES.ChannelUtil.get_proxys

形式

import  com.fujitsu.ObjectDirector.EventService.ES.*;
import  com.fujitsu.ObjectDirector.EventService.ES.ChannelUtilPackage.*;
public interface ChannelUtil extends org.omg.CORBA.Object{
    public ProxyData[] get_proxys(
                                  ProxyKind  kind);
}

class ProxyData {
      org.omg.CORBA.Object   proxy; 
      int                    time; 
      int                    ipaddress; 
      ProxyKind              kind; 
};

機能説明

イベントチャネルに接続しているコンシューマ/サプライヤの接続情報を取得します。

パラメタ

kind

取得するProxyオブジェクトのタイプ。
本パラメタに指定する値に応じて、取得する接続情報が異なります。以下に本パラメタに指定する値と復帰値情報の対応を示します。

kind値と復帰値情報の対応

kindに指定可能な値

復帰値情報

ChannelUtilPackage.Proxykind.ALL_PROXYS

すべての接続情報を取得

ChannelUtilPackage.Proxykind.PROXY_CONSUMER

すべてのProxyConsumerの一覧を取得

ChannelUtilPackage.Proxykind.PROXY_SUPPLIER

すべてのProxySupplierの一覧を取得

ChannelUtilPackage.Proxykind.PROXY_PULL_CONSUMER_EVENT

CosEventChannelAdminのProxyPullConsumerの一覧を取得

ChannelUtilPackage.Proxykind.PROXY_PULL_SUPPLIER_EVENT

CosEventChannelAdminのProxyPullSupplierの一覧を取得

ChannelUtilPackage.Proxykind.PROXY_PUSH_CONSUMER_EVENT

CosEventChannelAdminのProxyPushConsumerの一覧を取得

ChannelUtilPackage.Proxykind.PROXY_PUSH_SUPPLIER_EVENT

CosEventChannelAdminのProxyPushSupplierの一覧を取得

ChannelUtilPackage.Proxykind.PROXY_PULL_CONSUMER_NOTIFY

CosNotifyChannelAdminのProxyPullConsumerの一覧を取得

ChannelUtilPackage.Proxykind.PROXY_PULL_SUPPLIER_NOTIFY

CosNotifyChannelAdminのProxyPullSupplierの一覧を取得

ChannelUtilPackage.Proxykind.PROXY_PUSH_CONSUMER_NOTIFY

CosNotifyChannelAdminのProxyPushConsumerの一覧を取得

ChannelUtilPackage.Proxykind.PROXY_PUSH_SUPPLIER_NOTIFY

CosNotifyChannelAdminのProxyPushSupplierの一覧を取得

ChannelUtilPackage.Proxykind.STRUCTURED_PROXY_PULL_CONSUMER

CosNotifyChannelAdminのStructuredProxyPullConsumerの一覧を取得

ChannelUtilPackage.Proxykind.STRUCTURED_PROXY_PULL_SUPPLIER

CosNotifyChannelAdminのStructuredProxyPullSupplierの一覧を取得

ChannelUtilPackage.Proxykind.STRUCTURED_PROXY_PUSH_CONSUMER

CosNotifyChannelAdminのStructuredProxyPushConsumerの一覧を取得

ChannelUtilPackage.Proxykind.STRUCTURED_PROXY_PUSH_SUPPLIER

CosNotifyChannelAdminのStructuredProxyPushSupplierの一覧を取得

ProxyData構造体の各メンバには以下の値が設定されます。

ProxyData構造体のメンバと設定値

メンバ

設定値

Proxy

イベントチャネルに接続しているコンシューマ/サプライヤのオブジェクトリファレンス

Time

イベントチャネルに接続された時間

ipaddress

イベントチャネルに接続しているコンシューマ/サプライヤのIPアドレス

kind

イベントチャネルに接続しているコンシューマ/サプライヤのプロキシ種別
  ChannelUtilPackage.Proxykind.PROXY_PULL_CONSUMER_EVENT
  ChannelUtilPackage.Proxykind.PROXY_PULL_SUPPLIER_EVENT
  ChannelUtilPackage.Proxykind.PROXY_PUSH_CONSUMER_EVENT
  ChannelUtilPackage.Proxykind.PROXY_PUSH_SUPPLIER_EVENT
  ChannelUtilPackage.Proxykind.PROXY_PULL_CONSUMER_NOTIFY
  ChannelUtilPackage.Proxykind.PROXY_PULL_SUPPLIER_NOTIFY
  ChannelUtilPackage.Proxykind.PROXY_PUSH_CONSUMER_NOTIFY
  ChannelUtilPackage.Proxykind.PROXY_PUSH_SUPPLIER_NOTIFY
  ChannelUtilPackage.Proxykind.STRUCTURED_PROXY_PULL_CONSUMER
  ChannelUtilPackage.Proxykind.STRUCTURED_PROXY_PULL_SUPPLIER
  ChannelUtilPackage.Proxykind.STRUCTURED_PROXY_PUSH_CONSUMER
  ChannelUtilPackage.Proxykind.STRUCTURED_PROXY_PUSH_SUPPLIER

復帰値

正常終了した場合は、イベントチャネルに接続しているコンシューマ/サプライヤの接続情報が返されます。
異常終了した場合は、例外が発生します。

システム例外の場合は、“メッセージ集”の“イベントサービスから通知される例外情報/マイナーコード”および“CORBAサービスから通知される例外情報/マイナーコード”を参照し、発生したシステム例外およびマイナーコードに対する対処を行ってください。

注意

IPv6環境のIPアドレスで運用している場合、メンバ“ipaddress”には“0”が格納されます。
IPv6環境で使用する場合は、com.fujitsu.ObjectDirector.EventService.ES.ChannelUtil.get_proxys6()を使用してください。

3.22.2.2 com.fujitsu.ObjectDirector.EventService.ES.ChannelUtil.get_proxys6()

名前

com.fujitsu.ObjectDirector.EventService.ES.ChannelUtil.get_proxys6

形式

import  com.fujitsu.ObjectDirector.EventService.ES.*;
import  com.fujitsu.ObjectDirector.EventService.ES.ChannelUtilPackage.*;
public interface ChannelUtil extends org.omg.CORBA.Object{
    public ProxyData6[] get_proxys6(
                                  ProxyKind  kind);
}

class ProxyData6 {
      org.omg.CORBA.Object   proxy; 
      int                    time; 
      byte[]                 ipaddress; 
      int                    ip_format;
      ProxyKind              kind; 
};

機能説明

イベントチャネルに接続しているコンシューマ/サプライヤの接続情報を取得します。
ip_formatには、ipaddressがIPv6形式で格納されている場合は“1”が、IPv4形式の場合は“0”が入力されます。

パラメタ

kind

取得するProxyオブジェクトのタイプ。
本パラメタに設定する値に応じて、取得する接続情報が異なります。kindに指定した値と復帰値情報の対応については、“3.22.2.1 com.fujitsu.ObjectDirector.EventService.ES.ChannelUtil.get_proxys()”の“kind値と復帰値情報の対応”を参照してください。

復帰値

正常終了した場合は、イベントチャネルに接続しているコンシューマ/サプライヤの接続情報が返されます。
異常終了した場合は、例外が発生します。

システム例外の場合は、“メッセージ集”の“イベントサービスから通知される例外情報/マイナーコード”および“CORBAサービスから通知される例外情報/マイナーコード”を参照し、発生したシステム例外およびマイナーコードに対する対処を行ってください。

注意

IPv6環境で運用している場合は、IPv4クライアントのメンバ“ipaddress”にはIPv4射影アドレスが格納されます。IPv6環境で運用する設定については、“チューニングガイド”の“Interstageのチューニング”-“IPv6環境での運用について”、および“CORBAサービスの動作環境ファイル”-“config”(IP-versionパラメタ)を参照してください。

3.22.2.3 com.fujitsu.ObjectDirector.EventService.ES.ChannelUtil.get_consumer_count()

名前

com.fujitsu.ObjectDirector.EventService.ES.ChannelUtil.get_consumer_count

形式

import  com.fujitsu.ObjectDirector.EventService.ES.*;
public interface ChannelUtil extends org.omg.CORBA.Object{
    int get_consumer_count();
}

機能説明

イベントチャネルに接続しているコンシューマ数を取得します。

復帰値

正常終了した場合は、イベントチャネルに接続しているコンシューマ数が返されます。
異常終了した場合は、例外が発生します。

システム例外の場合は、“メッセージ集”の“イベントサービスから通知される例外情報/マイナーコード”および“CORBAサービスから通知される例外情報/マイナーコード”を参照し、発生したシステム例外およびマイナーコードに対する対処を行ってください。

3.22.2.4 com.fujitsu.ObjectDirector.EventService.ES.ChannelUtil.get_supplier_count()

名前

com.fujitsu.ObjectDirector.EventService.ES.ChannelUtil.get_supplier_count

形式

import  com.fujitsu.ObjectDirector.EventService.ES.*;
public interface ChannelUtil extends org.omg.CORBA.Object{
    int get_supplier_count();
}

機能説明

イベントチャネルに接続しているサプライヤ数を取得します。

復帰値

正常終了した場合は、イベントチャネルに接続しているサプライヤ数が返されます。
異常終了した場合は、例外が発生します。

システム例外の場合は、“メッセージ集”の“イベントサービスから通知される例外情報/マイナーコード”および“CORBAサービスから通知される例外情報/マイナーコード”を参照し、発生したシステム例外およびマイナーコードに対する対処を行ってください。

3.22.2.5 com.fujitsu.ObjectDirector.EventService.ES.ChannelUtil.get_queue_length()

名前

com.fujitsu.ObjectDirector.EventService.ES.ChannelUtil.get_queue_length

形式

import  com.fujitsu.ObjectDirector.EventService.ES.*;
public interface ChannelUtil extends org.omg.CORBA.Object{
    int get_queue_length();
}

機能説明

イベントチャネルにキューイングされているイベントデータ数を取得します。

復帰値

正常終了した場合は、イベントチャネルにキューイングされているイベントデータ数が返されます。
異常終了した場合は、例外が発生します。

システム例外の場合は、“メッセージ集”の“イベントサービスから通知される例外情報/マイナーコード”および“CORBAサービスから通知される例外情報/マイナーコード”を参照し、発生したシステム例外およびマイナーコードに対する対処を行ってください。

3.22.2.6 com.fujitsu.ObjectDirector.EventService.ES.ChannelUtil.local_begin()

名前

com.fujitsu.ObjectDirector.EventService.ES.ChannelUtil.local_begin

形式

import  com.fujitsu.ObjectDirector.EventService.ES.*;
import  com.fujitsu.ObjectDirector.EventService.ES.ChannelUtilPackage.*;
public  interface ChannelUtil extends org.omg.CORBA.Object {
    public  void local_begin(org.omg.CORBA.Object  proxy);
}

機能説明

チャネルに対して、ローカルトランザクションの開始を通知します。
コンシューマの場合、com.fujitsu.ObjectDirector.EventService.ES.ChannelUtil.local_commit()またはcom.fujitsu.ObjectDirector.EventService.ES.ChannelUtil.local_rollback()までの間には、以下のメソッドを発行することができます。

サプライヤの場合、com.fujitsu.ObjectDirector.EventService.ES.ChannelUtil.local_commit()またはcom.fujitsu.ObjectDirector.EventService.ES.ChannelUtil.local_rollback()までの間には、以下のメソッドを発行することができます。

また、本メソッド発行後、com.fujitsu.ObjectDirector.EventService.ES.ChannelUtil.local_commit()またはcom.fujitsu.ObjectDirector.EventService.ES.ChannelUtil.local_rollback()が発行されない場合は、ローカルトランザクションタイムアウト時間が経過した時点で、ノーティフィケーションサービスにより自動的にrollbackされます。
なお、本メソッドは、同一proxyに対して、2重に発行できません。

パラメタ

proxy

org.omg.CosNotifyChannelAdmin.ConsumerAdmin.obtain_notification_pull_supplier()、またはorg.omg.CosNotifyChannelAdmin.SupplierAdmin.obtain_notification_push_consumer()で取得したチャネルのオブジェクトリファレンス

復帰値

正常終了した場合は、ありません。
異常終了した場合は、例外が発生します。

システム例外の場合は、“メッセージ集”の“イベントサービスから通知される例外情報/マイナーコード”および“CORBAサービスから通知される例外情報/マイナーコード”を参照し、発生したシステム例外およびマイナーコードに対する対処を行ってください。

3.22.2.7 com.fujitsu.ObjectDirector.EventService.ES.ChannelUtil.local_commit()

名前

com.fujitsu.ObjectDirector.EventService.ES.ChannelUtil.local_commit

形式

import  com.fujitsu.ObjectDirector.EventService.ES.*;
import  com.fujitsu.ObjectDirector.EventService.ES.ChannelUtilPackage.*;
public  interface ChannelUtil extends org.omg.CORBA.Object {
    public  void local_commit(org.omg.CORBA.Object  proxy);
}

機能説明

チャネルに対して、ローカルトランザクションの完了を通知します。
コンシューマの場合、本メソッドの完了時点でイベントチャネルからメッセージの受信が完了します。
サプライヤの場合、本メソッドの完了時点でイベントチャネルからの配信が完了します。

パラメタ

proxy

org.omg.CosNotifyChannelAdmin.ConsumerAdmin.obtain_notification_pull_supplier()、またはorg.omg.CosNotifyChannelAdmin.SupplierAdmin.obtain_notification_push_consumer()で取得したチャネルのオブジェクトリファレンス

復帰値

正常終了した場合は、ありません。
異常終了した場合は、例外が発生します。

システム例外の場合は、“メッセージ集”の“イベントサービスから通知される例外情報/マイナーコード”および“CORBAサービスから通知される例外情報/マイナーコード”を参照し、発生したシステム例外およびマイナーコードに対する対処を行ってください。

3.22.2.8 com.fujitsu.ObjectDirector.EventService.ES.ChannelUtil.local_rollback()

名前

com.fujitsu.ObjectDirector.EventService.ES.ChannelUtil.local_rollback

形式

import  com.fujitsu.ObjectDirector.EventService.ES.*;
import  com.fujitsu.ObjectDirector.EventService.ES.ChannelUtilPackage.*;
public  interface ChannelUtil extends org.omg.CORBA.Object {
    public  void local_rollback(org.omg.CORBA.Object  proxy);
}

機能説明

チャネルに対して、ローカルトランザクションのキャンセルを通知します。本メソッドを発行することにより、ノーティフィケーションサービスのイベントチャネルはcom.fujitsu.ObjectDirector.EventService.ES.ChannelUtil.local_begin()発行前の状態に戻ります。

パラメタ

proxy

org.omg.CosNotifyChannelAdmin.ConsumerAdmin.obtain_notification_pull_supplier()、またはorg.omg.CosNotifyChannelAdmin.SupplierAdmin.obtain_notification_push_consumer()で取得したチャネルのオブジェクトリファレンス

復帰値

正常終了した場合は、ありません。
異常終了した場合は、例外が発生します。

システム例外の場合は、“メッセージ集”の“イベントサービスから通知される例外情報/マイナーコード”および“CORBAサービスから通知される例外情報/マイナーコード”を参照し、発生したシステム例外およびマイナーコードに対する対処を行ってください。

3.22.2.9 com.fujitsu.ObjectDirector.EventService.ES.ChannelUtil.pull_cancel()

名前

com.fujitsu.ObjectDirector.EventService.ES.ChannelUtil.pull_cancel

形式

import  com.fujitsu.ObjectDirector.EventService.ES.*;
import  com.fujitsu.ObjectDirector.EventService.ES.ChannelUtilPackage.*;
public  interface ChannelUtil extends org.omg.CORBA.Object {
    public  void pull_cancel(org.omg.CORBA.Object  proxy);
}

機能説明

本メソッドは、対象proxyのpull待ち状態(pullおよびcom.fujitsu.ObjectDirector.EventService.ES.ChannelUtil.pull_wait()メソッド発行による待ち合わせ状態)をキャンセルします。

パラメタ

proxy

org.omg.CosNotifyChannelAdmin.ConsumerAdmin.obtain_notification_pull_supplier()で取得したチャネルのオブジェクトリファレンス。
注)pullおよびcom.fujitsu.ObjectDirector.EventService.ES.ChannelUtil.pull_wait()で指定したオブジェクトリファレンスと同一のオブジェクトリファレンスを指定してください。

復帰値

正常終了した場合は、ありません。
異常終了した場合は、例外が発生します。

システム例外の場合は、“メッセージ集”の“イベントサービスから通知される例外情報/マイナーコード”および“CORBAサービスから通知される例外情報/マイナーコード”を参照し、発生したシステム例外およびマイナーコードに対する対処を行ってください。

3.22.2.10 com.fujitsu.ObjectDirector.EventService.ES.ChannelUtil.pull_wait()

名前

com.fujitsu.ObjectDirector.EventService.ES.ChannelUtil.pull_wait

形式

import  com.fujitsu.ObjectDirector.EventService.ES.*;
import  com.fujitsu.ObjectDirector.EventService.ES.ChannelUtilPackage.*;
public  interface ChannelUtil extends org.omg.CORBA.Object {
    public  void pull_wait(org.omg.CORBA.Object  proxy)
        throws org.omg.CosEventComm.Disconnected;
}

機能説明

本メソッドは、対象proxyがpullまたはtry_pullでデータ取得が可能な状態となるまで待ち合わせます。メソッド実行後、データ取得が可能な状態となった時点で呼び出し元に復帰します。
対象proxyがすでにpullでデータ取得可能な状態である場合は、即時復帰します。pullと同様、待ち合わせ時間内にデータが取得可能状態にならない場合は、タイムアウトで復帰します。

パラメタ

proxy

org.omg.CosNotifyChannelAdmin.ConsumerAdmin.obtain_notification_pull_supplier()で取得したチャネルのオブジェクトリファレンス

復帰値

正常終了した場合は、ありません。
異常終了した場合は、例外が発生します。

ユーザ例外の場合は、以下の例外が発生します。

org.omg.CosEventComm.Disconnected

イベントチャネルに接続されていません。
イベントチャネル生成時にコネクション情報を自動回収する処理を有効とした場合(esmkchnlコマンド実行時に-autodisconオプションを指定した場合)は、CORBAサービスのクライアント側無通信監視時間超過によりコネクションが切断された可能性があります。継続して通信する場合は、イベントチャネルへの接続から行ってください。

システム例外の場合は、“メッセージ集”の“イベントサービスから通知される例外情報/マイナーコード”および“CORBAサービスから通知される例外情報/マイナーコード”を参照し、発生したシステム例外およびマイナーコードに対する対処を行ってください。