パッケージ jakarta.ejb
インターフェース SessionBean
- すべてのスーパーインターフェース:
EnterpriseBean
,SerializableSE
public interface SessionBean extends EnterpriseBean
SessionBean インターフェースは、Enterprise Bean コンテナーがセッションの Bean インスタンスにインスタンスのライフサイクルイベントを通知するために使用するメソッドを定義します。EJB 3.0 の時点で、セッション Bean クラスがこのインターフェースを実装する必要はなくなりました。
- 導入:
- EJB 1.0
メソッドのサマリー
すべてのメソッド インスタンスメソッド 抽象メソッド 修飾子と型 メソッド 説明 void
ejbActivate()
ステートフルセッション Bean インスタンスが「パッシブ」状態からアクティブ化されると、アクティブ化メソッドが呼び出されます。void
ejbPassivate()
ステートフルセッション Bean インスタンスが「パッシブ」状態になる前に、passivate メソッドが呼び出されます。void
ejbRemove()
コンテナーは、セッションオブジェクトの存続期間が終了する前にこのメソッドを呼び出します。void
setSessionContext(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 をスローする必要があります。