エミッターを取得する場合は、少なくとも 1 つのエミッター・ファクトリー・プロファイルが構成されている必要があります。
始める前に
エミッター・ファクトリー・プロファイルごとに、エミッター・ファクトリーが自動的に作成されます。
エミッター・ファクトリーには、エミッター・ファクトリー・プロファイルの JNDI 名を使用してアクセスできます。
このタスクを実行する理由および時期
エミッターを取得するには、以下の手順を使用します。
このタスクの手順
- エミッターに使用するエミッター・ファクトリーの名前を指定して、JNDI 検索を実行します。 これは、
管理者がエミッター・ファクトリー・プロファイルを定義するときに指定した JNDI 名です。
- エミッター・ファクトリーの getEmitter() メソッドを呼び出します。 戻されるオブジェクトは、
指定したエミッター・ファクトリー・プロファイルで定義されたオプションに従って構成されたエミッターです。
エミッター・ファクトリーがエミッターを取得できない場合は、EmitterException 例外がスローされます。
注: イベント・ソースが、セキュアな環境で実行されている J2EE クライアント・アプリケーションで、
使用しているエミッター・プロファイルが非同期伝送プロファイルを指定している場合は、
エミッターを取得するときに JMS のユーザー名およびパスワードを指定する必要があります。
そのためには、getEmitter(String, String) メソッドを使用して、使用する JMS のユーザー名およびパスワードを渡します。
詳しくは、com.ibm.events.emitter クラスの Javadoc 資料を参照してください。
例
以下のコード・フラグメントでは、
Default プロファイルを使用し、構成されたエミッターを取得します。
import javax.naming.*
import com.ibm.events.emitter.*
Context context = new InitialContext();
EmitterFactory emitterFactory =
(EmitterFactory) context.lookup("com/ibm/events/configuration/emitter/Default");
Emitter emitter = emitterFactory.getEmitter();