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

3.21.3 CosNotifyCommモジュール

3.21.3.1 org.omg.CosNotifyComm.StructuredPushConsumer.push_structured_event()

名前

org.omg.CosNotifyComm.StructuredPushConsumer.push_structured_event

形式

import  org.omg.CosNotifyComm.*;
public  interface StructuredPushConsumer extends org.omg.CORBA.Object {
    public  void push_structured_event ( org.omg.CosNotification.StructuredEvent  data)
        throws org.omg.CosEventComm.Disconnected;
}

機能説明

dataで指定されたStructuredEvent型のイベントデータをコンシューマに送信します。

パラメタ

data

コンシューマに送信するStructuredEvent型のイベントデータ

復帰値

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

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

org.omg.CosEventComm.Disconnected

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

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

3.21.3.2 org.omg.CosNotifyComm.StructuredPullSupplier.pull_structured_event()

名前

org.omg.CosNotifyComm.StructuredPullSupplier.pull_structured_event

形式

import  org.omg.CosNotifyComm.*;
public  interface StructuredPullSupplier extends org.omg.CORBA.Object {
    public  org.omg.CosNotification.StructuredEvent pull_structured_event ()
        throws org.omg.CosEventComm.Disconnected;
}

機能説明

サプライヤにStructuredEvent型のイベントデータを要求します。イベントデータの取り出しが可能になるか、または例外が発生するまでブロックされます。なお、イベントデータが取り出せない場合に即時復帰したい場合は、org.omg.CosNotifyComm.StructuredPullSupplier.try_pull_structured_eventを使用してください。

復帰値

正常終了した場合は、サプライヤからのイベントデータが復帰します。
異常終了した場合は、例外が発生します。

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

org.omg.CosEventComm.Disconnected

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

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

3.21.3.3 org.omg.CosNotifyComm.StructuredPullSupplier.try_pull_structured_event()

名前

org.omg.CosNotifyComm.StructuredPullSupplier.try_pull_structured_event 

形式

import  org.omg.CosNotifyComm.*;
public  interface StructuredPullSupplier extends org.omg.CORBA.Object {
    public  org.omg.CosNotification.StructuredEvent try_pull_structured_event (
        org.omg.CORBA.BooleanHolder  has_event )
        throws org.omg.CosEventComm.Disconnected;
}

機能説明

サプライヤにStructuredEvent型のイベントデータを要求します。サプライヤからイベントデータが取り出せない場合は即座に復帰します。なお、イベントデータが取り出せるまでブロックしたい場合には、org.omg.CosNotifyComm.StructuredPullSupplier.pull_structured_eventを使用してください。

パラメタ

has_eventoutパラメタ

イベントデータを取り出せた場合は、trueが設定されます。
イベントデータが取り出せなかった場合は、falseが設定されます。

復帰値

正常終了した場合で、イベントデータを取り出せた場合は、サプライヤからのイベントデータが復帰します。
異常終了した場合は、例外が発生します。

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

org.omg.CosEventComm.Disconnected

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

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

注意事項

ローカルトランザクション運用中に、has_eventにCORBA_FALSEが設定された場合は、com.fujitsu.ObjectDirector.EventService.ES.ChannelUtil.local_rollback()によりキャンセルを通知する必要はありません。com.fujitsu.ObjectDirector.EventService.ES.ChannelUtil.local_commit()により完了を通知してください。
グローバルトランザクション運用中に、has_eventにCORBA_FALSEが設定された場合は、org.omg.CosTransactions.Current.rollback()によりキャンセルを通知する必要はありません。org.omg.CosTransactions.Current.commit()により完了を通知してください。

3.21.3.4 org.omg.CosNotifyComm.StructuredPushConsumer.disconnect_structured_push_consumer()

名前

org.omg.CosNotifyComm.StructuredPushConsumer.disconnect_structured_push_consumer 

形式

import  org.omg.CosNotifyComm.*;
public  interface StructuredPushConsumer extends org.omg.CORBA.Object {
    public  void disconnect_structured_push_consumer ();
}

機能説明

サプライヤからイベント通信の終了を宣言します。

復帰値

異常終了した場合は、例外が発生します。

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

3.21.3.5 org.omg.CosNotifyComm.StructuredPullSupplier.disconnect_structured_pull_supplier()

名前

org.omg.CosNotifyComm.StructuredPullSupplier.disconnect_structured_pull_supplier

形式

import  org.omg.CosNotifyComm.*;
public  interface StructuredPullSupplier extends org.omg.CORBA.Object {
    public  void disconnect_structured_pull_supplier ();
}

機能説明

コンシューマからイベント通信の終了を宣言します。

復帰値

異常終了した場合は、例外が発生します。

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

3.21.3.6 継承されて使用できるクラス

以下のクラスを継承して使用することができます。詳細については、“3.20.1 org.omg.CosEventCommクラス”を参照してください。

  1. org.omg.CosNotifyComm.PushConsumer.push

  2. org.omg.CosNotifyComm.PushConsumer.disconnect_push_consumer

  3. org.omg.CosNotifyComm.PullSupplier.pull

  4. org.omg.CosNotifyComm.PullSupplier.try_pull

  5. org.omg.CosNotifyComm.PullSupplier.disconnect_pull_supplier