パッケージ jakarta.ejb

インターフェース SessionBean

すべてのスーパーインターフェース:
EnterpriseBeanSerializableSE

public interface SessionBean extends EnterpriseBean
SessionBean インターフェースは、Enterprise Bean コンテナーがセッションの Bean インスタンスにインスタンスのライフサイクルイベントを通知するために使用するメソッドを定義します。

EJB 3.0 の時点で、セッション Bean クラスがこのインターフェースを実装する必要はなくなりました。

導入:
EJB 1.0
  • 方法の概要

    修飾子と型
    メソッド
    説明
    void
    ステートフルセッション Bean インスタンスが「パッシブ」状態からアクティブ化されると、アクティブ化メソッドが呼び出されます。
    void
    ステートフルセッション Bean インスタンスが「パッシブ」状態になる前に、passivate メソッドが呼び出されます。
    void
    コンテナーは、セッションオブジェクトの存続期間が終了する前にこのメソッドを呼び出します。
    void
    関連するセッションコンテキストを設定します。
  • メソッドの詳細

    • setSessionContext

      void setSessionContext(SessionContext ctx) throws EJBException, RemoteExceptionSE
      関連するセッションコンテキストを設定します。コンテナーは、インスタンスの作成後にこのメソッドを呼び出します。

      セッション Bean インスタンスは、コンテキスト変数への参照をインスタンス変数に保存する必要があります。

      このメソッドは、トランザクションコンテキストなしで呼び出されます。

      パラメーター:
      ctx - インスタンスの SessionContext インターフェース。
      例外:
      EJBException - メソッドによってスローされ、システムレベルのエラーが原因の障害を示します。
      RemoteExceptionSE - この例外は、Enterprise Bean 1.0 仕様用に作成されたアプリケーションに下位互換性を提供するためにメソッドシグネチャーで定義されています。EJB 1.1 仕様用に記述された Enterprise Bean は、この例外の代わりに jakarta.ejb.EJBException をスローする必要があります。EJB2.0 以降の仕様用に記述された Enterprise Bean は、この例外の代わりに jakarta.ejb.EJBException をスローする必要があります。
    • ejbRemove

      void ejbRemove() throws EJBException, RemoteExceptionSE
      コンテナーは、セッションオブジェクトの存続期間が終了する前にこのメソッドを呼び出します。これは、クライアントが削除操作を呼び出した結果、またはコンテナーがタイムアウト後にセッションオブジェクトを終了することを決定したときに発生します。

      このメソッドは、トランザクションコンテキストなしで呼び出されます。

      例外:
      EJBException - メソッドによってスローされ、システムレベルのエラーが原因の障害を示します。
      RemoteExceptionSE - この例外は、Enterprise Bean 1.0 仕様用に記述された Enterprise Bean に下位互換性を提供するためにメソッドシグネチャーで定義されています。EJB 1.1 仕様用に記述された Enterprise Bean は、この例外の代わりに jakarta.ejb.EJBException をスローする必要があります。EJB2.0 以降の仕様用に記述された Enterprise Bean は、この例外の代わりに jakarta.ejb.EJBException をスローする必要があります。
    • ejbActivate

      void ejbActivate() throws EJBException, RemoteExceptionSE
      ステートフルセッション Bean インスタンスが「パッシブ」状態からアクティブ化されると、アクティブ化メソッドが呼び出されます。インスタンスは、ejbPassivate メソッドで以前にリリースしたリソースを取得する必要があります。

      このメソッドは、トランザクションコンテキストなしで呼び出されます。

      例外:
      EJBException - メソッドによってスローされ、システムレベルのエラーが原因の障害を示します。
      RemoteExceptionSE - この例外は、Enterprise Bean 1.0 仕様用に記述された Enterprise Bean に下位互換性を提供するためにメソッドシグネチャーで定義されています。EJB 1.1 仕様用に記述された Enterprise Bean は、この例外の代わりに jakarta.ejb.EJBException をスローする必要があります。EJB2.0 以降の仕様用に記述された Enterprise Bean は、この例外の代わりに jakarta.ejb.EJBException をスローする必要があります。
    • ejbPassivate

      void ejbPassivate() throws EJBException, RemoteExceptionSE
      ステートフルセッション Bean インスタンスが「パッシブ」状態になる前に、passivate メソッドが呼び出されます。インスタンスは、ejbActivate メソッドで後で再取得できるリソースを解放する必要があります。

      パッシベートメソッドが完了した後、インスタンスは、コンテナーが Java 直列化プロトコルを使用してインスタンス化された状態を外部化および保存できる状態になっている必要があります。

      このメソッドは、トランザクションコンテキストなしで呼び出されます。

      例外:
      EJBException - メソッドによってスローされ、システムレベルのエラーが原因の障害を示します。
      RemoteExceptionSE - この例外は、Enterprise Bean 1.0 仕様用に記述された Enterprise Bean に下位互換性を提供するためにメソッドシグネチャーで定義されています。EJB 1.1 仕様用に記述された Enterprise Bean は、この例外の代わりに jakarta.ejb.EJBException をスローする必要があります。EJB2.0 以降の仕様用に記述された Enterprise Bean は、この例外の代わりに jakarta.ejb.EJBException をスローする必要があります。