ページの先頭行へ戻る
 Apcoordinatorユーザーズガイド
FUJITSU Software
第4部 EJBアプリケーションの開発 > 第20章 EJB 2.x > 20.2 EJBアプリケーション > 20.2.2 セションBean特有のプログラミング
前次

20.2.2 セションBean特有のプログラミング

20.2.2.1 例外処理

EJB仕様ではEJBの実行中に発生する例外として、以下の2種類を定義しています。

ビジネスクラスで発生した例外も基本的に上記の分類に従って処理されます。

ただし、ビジネスクラスがPostprocessorインターフェイスを実装している場合は、例外はhandleExceptionメソッドで処理されます。handleExceptionメソッドが例外を発生した場合は、上記の処理に従います。handleExceptionメソッドについては、“4.2 エラー処理”を参照してください。

デバッグの目的で、セションBean内で発生したシステム例外をクライアントに通知する場合は、初期化パラメータuji.informSystemExceptionを“client”に設定してください。この設定により、システム例外はコンテナではなくクライアントに通知されます。また、システム例外が発生してもセションBeanオブジェクトは削除されません。運用時はuji.informSystemExceptionを“container”に設定して、通常どおりシステム例外がEJBコンテナに通知されるように設定してください。

20.2.2.2 エンタープライズBean環境の参照

エンタープライズBean環境(デプロイメント記述の<env-entry>で定義された値)はEJBDispatchContextのgetEnvironmentメソッドで取得できます。 以下は、ビジネスクラスのメソッドでエンタープライズBean環境を取得する例です。 

import com.fujitsu.uji.ejb.bean.EJBDispatchContext;

...

public Object search(DispatchContext context, HashMap data) {
  // エンタープライズBean環境java:comp/env/initialCountの値を取得します。
  Integer i = (Integer)((EJBDispatchContext) context).getEnvironment("initialCount");
  ...
}

EJBDispatchContextのメソッドを利用するには、ビジネスクラスのメソッドの第1引数に与えられるDispatchContextをEJBDispatchContextにキャストします。

getEnvironmentメソッドの引数にはエントリの名前からjava:comp/env/を除いた部分を指定します。上記の例ではjava:comp/env/initialCountの値が取得されます。 指定された名前が未定義の場合はnullが返ります。

ポイント

一般的なEJBと同様にIniticalContextを使ってエンタープライズBean環境を取得することも可能です。ただし、getEnvironmentメソッドを使用した場合には、ローカル呼び出し機能で呼び出された場合でもエンタープライズBean環境が取得できます。

20.2.2.3 SessionContextの取得

EJBコンテナはjavax.ejb.SessionContextインターフェイスを実装したオブジェクトをセションBeanに与えます。このSessionContextを取得するには、EJBSessionProfileのgetEJBContextメソッドを使用します。このメソッドをビジネスクラスで呼び出す例を示します。

import com.fujitsu.uji.ejb.bean.EJBSessionProfile;
import javax.ejb.SessionContext;

public Object search(DispatchContext context, HashMap data) {
  EJBSessionProfile sp = (EJBSessionProfile)context.getSessionProfile();
  SessionContext sessionContext = (SessionContext)sp.getEJBContext();
}

getEJBContextメソッドの返り値の型はSessionContextのスーパーインターフェイスであるEJBContextです。これをSessionContextにキャストして使用します。

EJBSessionProfileのメソッドを利用するには、DispatchContextのgetSessionProfileでセションクラスを取得し、それをEJBSessionProfileにキャストします。

20.2.2.4 オブジェクトのライフサイクル

アプリケーションクラス、セションクラス、ビジネスクラスのライフサイクルは以下のようになります。

クラス

インスタンスが作成されるタイミング

インスタンスの有効期間

備考

ビジネスクラス(initメソッドがtrueを返す場合)

セションBeanオブジェクト作成後、クライアントからの呼び出しを受けてビジネスクラスが初めて呼び出される時

セションBeanオブジェクトがEJBコンテナから削除されるまで

ビジネスクラス(initメソッドがfalseを返す場合)

クライアントからの呼び出しを受けてビジネスクラス呼び出される時

クライアントからの呼び出しが終了するまで

クライアントからの呼び出しがあるたびにインスタンスが作成されます。

セションクラス

セションBeanオブジェクトが作成された時(セションBeanのejbCreateメソッドが呼び出されたとき)

セションBeanオブジェクトがEJBコンテナから削除されるまで

アプリケーションクラス

同一のJVM内で最初にセションBeanのオブジェクトが作成された時(同一のJVM内で最初にセションBeanのejbCreateメソッドが呼び出された時)

全てのセションBeanインスタンスがEJBコンテナから削除されるまで

同一のJVMに存在する複数のセションBeanオブジェクトで1個のインスタンスが共有されます。

ステートフルセションBeanの場合、クライアントとセションBeanが1対1に対応します。したがって、ビジネスクラスが2回以上呼び出される場合、その呼び出し元は同一のクライアントです。 一方、ステートレスセションBeanの場合、クライアントとセションBeanは1対1で対応づけられていません。そのため、ビジネスクラスが2回以上呼び出される場合、その呼び出し元が同じクライアントであるとは限りません。

20.2.2.5 ユーザー定義ビジネスメソッドの利用

Apcoordinatorで作成したセションBeanはビジネスメソッドを1個だけ持ち、そのメソッド名はexecです。 execとはトランザクション属性などが異なるビジネスメソッドが必要な場合は、次のようにしてください。

ビジネスメソッドを追加したセションBeanクラスは次のように作成します。 

import com.fujitsu.uji.ejb.bean.UjiSessionBean;
import java.lang.reflect.InvocationTargetException;

public class OfficeEJB extends UjiSessionBean {
        public Object[] myExec(Object dataBean, String verb, Object syncData) 
            throws InvocationTargetException {
                return exec(dataBean,verb,syncData);
        }
}

これは、ビジネスメソッドmyExecを追加した例です。メソッドの引数の型、返り値の型、throws節は上記例と同じにしてください。また、上記例と同様にexecを呼び出してその返り値を返すように作成してください。execメソッドはUjiSessionBeanクラスに定義されています。

クライアントからユーザー定義のビジネスメソッドを呼び出す時には次のようにメソッド名を指定してください。

なお、セションBeanの基本的な呼び出し方法については、“EJBの呼び出し”を参照してください。

前次
Copyright FUJITSU LIMITED 2021