パッケージ jakarta.ejb
インターフェース SessionBean
- すべてのスーパーインターフェース:
EnterpriseBean,SerializableSE
SessionBean インターフェースは、Enterprise Bean コンテナーがセッションの Bean インスタンスにインスタンスのライフサイクルイベントを通知するために使用するメソッドを定義します。
EJB 3.0 の時点で、セッション Bean クラスがこのインターフェースを実装する必要はなくなりました。
- 導入:
- EJB 1.0
方法の概要
修飾子と型メソッド説明voidステートフルセッション Bean インスタンスが「パッシブ」状態からアクティブ化されると、アクティブ化メソッドが呼び出されます。voidステートフルセッション Bean インスタンスが「パッシブ」状態になる前に、passivate メソッドが呼び出されます。voidコンテナーは、セッションオブジェクトの存続期間が終了する前にこのメソッドを呼び出します。void関連するセッションコンテキストを設定します。
メソッドの詳細
setSessionContext
関連するセッションコンテキストを設定します。コンテナーは、インスタンスの作成後にこのメソッドを呼び出します。セッション 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
コンテナーは、セッションオブジェクトの存続期間が終了する前にこのメソッドを呼び出します。これは、クライアントが削除操作を呼び出した結果、またはコンテナーがタイムアウト後にセッションオブジェクトを終了することを決定したときに発生します。このメソッドは、トランザクションコンテキストなしで呼び出されます。
- 例外:
EJBException- メソッドによってスローされ、システムレベルのエラーが原因の障害を示します。RemoteExceptionSE- この例外は、Enterprise Bean 1.0 仕様用に記述された Enterprise Bean に下位互換性を提供するためにメソッドシグネチャーで定義されています。EJB 1.1 仕様用に記述された Enterprise Bean は、この例外の代わりに jakarta.ejb.EJBException をスローする必要があります。EJB2.0 以降の仕様用に記述された Enterprise Bean は、この例外の代わりに jakarta.ejb.EJBException をスローする必要があります。
ejbActivate
ステートフルセッション 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
ステートフルセッション 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 をスローする必要があります。