Interstage Application Server リファレンスマニュアル（API編）

3.20.3.1 com.fujitsu.ObjectDirector.EventService.EventFactory.create()

名前

  EventFactory.create

形式

  import  com.fujitsu.ObjectDirector.EventService.*;
  import  com.fujitsu.ObjectDirector.EventService.EventFactoryPackage.*;
  public  interface EventFactory extends org.omg.CORBA.Object {
       public  org.omg.CosEventChannelAdmin.EventChannel  create(
               String   key,
               com.fujitsu.ObjectDirector.EventService.EventFactoryPackage.Option  data );
  }

機能説明

　イベントチャネルを生成し、生成したイベントチャネルのオブジェクトリファレンスを返します。
　EventFactoryのオブジェクトリファレンスは、org.omg.CORBA.ORB.resolve_initial_references()メソッドのobject_nameパラメタに以下の値を指定して獲得します。
　　EventFactory.ObjectId_Factory

パラメタ

　key

　コンシューマ/サプライヤで共通のキーワード。
　同一のキーワードを指定することにより同一のイベントチャネルのオブジェクトリファレンスが返されます。

　data

　EventFactory.Optionクラスを指定します。
　EventFactory.Optionクラスの各メンバには、以下の値を設定します。

メンバ	設定値
max_queuing	最大データ蓄積数。EventFactory.ES_DEFAULT_VALUEを指定した場合、イベントサービスの構成情報の設定で指定した“イベントチャネルに蓄積できるイベントデータ数の最大値”の値を使用します。
life_time	データ保持時間(秒)。EventFactory.ES_DEFAULT_VALUEを指定した場合、イベントサービスの構成情報の設定で指定した“蓄積したイベントデータの生存時間（秒）”の値を使用します。0を指定した場合、タイムアウト監視は行いません。
model	接続モデルとして以下の値を指定します。 EventFactoryPackage.Model.ModelAny　　　　接続時に決定 EventFactoryPackage.Model.ModelPush 　　　Pushモデル EventFactoryPackage.Model.ModelPull 　　　Pullモデル EventFactoryPackage.Model.ModelMixed　　　Mixedモデル

復帰値

　正常終了した場合は、生成したイベントチャネルのオブジェクトリファレンスが返されます。
　異常終了した場合は、例外が発生します。

　システム例外の場合は、以下の例外が発生します。

　org.omg.CORBA.NO_RESOURCES

　資源不足が発生しました。イベントファクトリで生成可能なチャネルの上限を超えた可能性があります。

　org.omg.CORBA.COMM_FAILURE

　通信異常が発生しました。

　org.omg.CORBA.NO_IMPLEMENT

　イベントファクトリが起動されていません。