パッケージ jakarta.ejb

インターフェース SessionBean

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

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

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

    導入:
    EJB 1.0
    • メソッドのサマリー

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

      • 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 をスローする必要があります。