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

3.20.3 com.fujitsu.ObjectDirector.EventService.EventFactoryクラス

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

名前

com.fujitsu.ObjectDirector.EventService.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

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

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モデル

復帰値

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

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

3.20.3.2 com.fujitsu.ObjectDirector.EventService.EventFactory.create_channel()

名前

com.fujitsu.ObjectDirector.EventService.EventFactory.create_channel

形式

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_channel(
         String   key,
         com.fujitsu.ObjectDirector.EventService.EventFactoryPackage.Option data,
         com.fujitsu.ObjectDirector.EventService.EventFactoryPackage.EventProperty property,
         org.omg.CORBA.boolean   create);
}

機能説明

イベントチャネルを生成し、生成したイベントチャネルのオブジェクトリファレンスを返します。本メソッドは、生成するチャネルに対してホスト名、ポート番号を変更する場合に使用します。
EventFactoryのオブジェクトリファレンスは、org.omg.CORBA.ORB.resolve_initial_references()のobject_nameパラメタに以下の値を指定して獲得します。
  EventFactory.ObjectId_Factory

パラメタ

key

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

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モデル

property

以下の値を指定します。無効なnameが指定された場合、該当レコードは無効となります。また、HostNameとPortNumberのどちらか一方が設定されている場合、指定されたレコードは無効となります。
なお、イベントチャネルがすでに生成されている場合、本パラメタの値は無視されます。

メンバ(name)

データ型(value)

設定値

HostName

string

ホスト名(64文字以内)、またはIPアドレスを指定します。

PortNumber

unsigned short

ポート番号を指定します

create

イベントチャネルが生成された場合は、trueが設定されます。
すでに存在した場合は、falseが設定されます。

復帰値

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

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

注意事項

3.20.3.3 com.fujitsu.ObjectDirector.EventService.EventFactory.get_event_channel()

名前

com.fujitsu.ObjectDirector.EventService.EventFactory.get_event_channel

形式

import  com.fujitsu.ObjectDirector.EventService.*;
import  com.fujitsu.ObjectDirector.EventService.EventFactoryPackage.*;
public  interface EventFactory extends org.omg.CORBA.Object {
     public  org.omg.CosEventChannelAdmin.EventChannel  get_event_channel(
              String    key)
              throws com.fujitsu.ObjectDirector.EventService.EventFactoryPackage.ChannelNotFound;
}

機能説明

EventFactoryのオブジェクトリファレンスは、org.omg.CORBA.ORB.resolve_initial_references()のobject_nameパラメタに以下の値を指定して獲得します。
  EventFactory.ObjectId_Factory

パラメタ

key

獲得するイベントチャネル名。

復帰値

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

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

com.fujitsu.ObjectDirector.EventService.EventFactoryPackage.ChannelNotFound

指定されたイベントチャネルは存在しません。

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