パッケージ jakarta.ejb

インターフェース EntityContext

  • すべてのスーパーインターフェース:
    EJBContext
    public interface EntityContext
extends EJBContext
    EntityContext インターフェースは、エンティティ Bean インスタンスのコンテナー提供のランタイムコンテキストへのアクセスをインスタンスに提供します。インスタンスが作成された後、コンテナーは EntityContext インターフェースをエンティティ Bean インスタンスに渡します。

    EntityContext インターフェースは、インスタンスの存続期間中、インスタンスに関連付けられたままになります。インスタンスのライフサイクル中にコンテナーがインスタンスを別の Enterprise Bean オブジェクトに割り当てるため、インスタンスが EntityContext インターフェースを使用して取得する情報（getPrimaryKey() メソッドの結果など）が変更される可能性があることに注意してください。

    注意 : EJB 3.2 では、エンティティ Bean のサポートはオプションです。

    導入:
    EJB 2.0

    • メソッドの詳細

      • getEJBLocalObject

        EJBLocalObject getEJBLocalObject()
                          throws IllegalStateExceptionSE
        現在インスタンスに関連付けられている Enterprise Bean ローカルオブジェクトへの参照を取得します。

        エンティティ Bean のインスタンスは、インスタンスがエンタープライズ Bean ローカルオブジェクト ID、つまり ejbActivate、ejbPassivate、ejbPostCreate、ejbRemove、ejbLoad、ejbStore、ビジネスメソッドに関連付けられている場合にのみ、このメソッドを呼び出すことができます。

        インスタンスは、たとえば、メソッドの引数または結果でそれ自体への参照を渡したい場合に、このメソッドを使用できます。

        戻り値:
        現在インスタンスに関連付けられている Enterprise Bean ローカルオブジェクト。
        例外:
        IllegalStateExceptionSE - インスタンスがこのメソッドを呼び出すことを許可しない状態にあるときにインスタンスがこのメソッドを呼び出す場合、またはインスタンスにローカルインターフェースがない場合。
        導入:
        EJB 2.0

      • getEJBObject

        EJBObject getEJBObject()
                throws IllegalStateExceptionSE
        インスタンスに現在関連付けられている Enterprise Bean オブジェクトへの参照を取得します。

        エンティティ Bean のインスタンスは、インスタンスがエンタープライズ Bean オブジェクト ID、つまり ejbActivate、ejbPassivate、ejbPostCreate、ejbRemove、ejbLoad、ejbStore、ビジネスメソッドに関連付けられている場合にのみ、このメソッドを呼び出すことができます。

        インスタンスは、たとえば、メソッドの引数または結果でそれ自体への参照を渡したい場合に、このメソッドを使用できます。

        戻り値:
        現在インスタンスに関連付けられている Enterprise Bean オブジェクト。
        例外:
        IllegalStateExceptionSE - インスタンスがこのメソッドを呼び出せない状態のときにインスタンスがこのメソッドを呼び出す場合、またはインスタンスにリモートインターフェースがない場合にスローされます。

      • getPrimaryKey

        ObjectSE getPrimaryKey()
              throws IllegalStateExceptionSE
        現在このインスタンスに関連付けられている Enterprise Bean オブジェクトの主キーを取得します。

        エンティティ Bean のインスタンスは、インスタンスがエンタープライズ Bean オブジェクト ID、つまり ejbActivate、ejbPassivate、ejbPostCreate、ejbRemove、ejbLoad、ejbStore、ビジネスメソッドに関連付けられている場合にのみ、このメソッドを呼び出すことができます。

        注意 : このメソッドの結果は、getEJBObject().getPrimaryKey() の結果と同じです。

        戻り値:
        現在インスタンスに関連付けられている主キー。
        例外:
        IllegalStateExceptionSE - インスタンスがこのメソッドを呼び出すことを許可しない状態にあるときに、インスタンスがこのメソッドを呼び出す場合にスローされます。