パッケージ jakarta.ejb

インターフェース EJBObject

すべてのスーパーインターフェース:
RemoteSE
public interface EJBObject extends RemoteSE
EJBObject インターフェースは、すべての Enterprise Bean のリモートインターフェースによって拡張されます。Enterprise Bean のリモートインターフェースは、Enterprise Bean オブジェクトのリモートクライアントビューを提供します。Enterprise Bean のリモートインターフェースは、リモートクライアントから呼び出し可能なビジネスメソッドを定義します。

リモートインターフェースは、jakarta.ejb.EJBObject インターフェースを継承し、Enterprise Bean 固有のビジネスメソッドを定義する必要があります。

Enterprise Bean のリモートインターフェースは、Enterprise Bean プロバイダーによって定義され、Enterprise Bean コンテナーによって実装されます。

EJB 3.0 以降の API に書き込まれた Enterprise Bean は、EJBObject インターフェースを継承するリモートインターフェースを必要としません。代わりにリモートビジネスインターフェースを使用できます。

導入:
EJB 1.0

  • 方法の概要

    修飾子と型
    メソッド
    説明
    EJBHome
    getEJBHome()
    Enterprise Bean のリモートホームインターフェースを取得します。
    Handle
    getHandle()
    Enterprise Bean オブジェクトのハンドルを取得します。
    ObjectSE
    getPrimaryKey()
    Enterprise Bean オブジェクトの主キーを取得します。
    boolean
    isIdentical(EJBObject obj)
    特定の Enterprise Bean オブジェクトが、呼び出された Enterprise Bean オブジェクトと同一かどうかをテストします。
    void
    remove()
    Enterprise Bean オブジェクトを削除します。

  • メソッドの詳細

    • getEJBHome

      EJBHome getEJBHome() throws RemoteExceptionSE
      Enterprise Bean のリモートホームインターフェースを取得します。リモートホームインターフェースは、Enterprise Bean の作成、検索、削除、ホームビジネスメソッドを定義します。
      戻り値:
      Enterprise Bean のホームインターフェースへの参照。
      例外:
      RemoteExceptionSE - システムレベルの障害が原因でメソッドが失敗した場合にスローされます。

    • getPrimaryKey

      ObjectSE getPrimaryKey() throws RemoteExceptionSE
      Enterprise Bean オブジェクトの主キーを取得します。

      このメソッドは、エンティティ Bean で呼び出すことができます。セッション Bean でこのメソッドを呼び出そうとすると、RemoteException になります。

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

      戻り値:
      Enterprise Bean オブジェクトの主キー。
      例外:
      RemoteExceptionSE - システムレベルの障害が原因でメソッドが失敗した場合、またはセッション Bean で呼び出された場合にスローされます。

    • remove

      void remove() throws RemoteExceptionSE, RemoveException
      Enterprise Bean オブジェクトを削除します。
      例外:
      RemoteExceptionSE - システムレベルの障害が原因でメソッドが失敗した場合にスローされます。
      RemoveException - Enterprise Bean またはコンテナーは、オブジェクトの破棄を許可しません。

    • getHandle

      Handle getHandle() throws RemoteExceptionSE
      Enterprise Bean オブジェクトのハンドルを取得します。このハンドルは、後で別の Java 仮想マシンにある Enterprise Bean オブジェクトへの参照を再取得するために後で使用できます。
      戻り値:
      Enterprise Bean オブジェクトのハンドル。
      例外:
      RemoteExceptionSE - システムレベルの障害が原因でメソッドが失敗した場合にスローされます。

    • isIdentical

      boolean isIdentical(EJBObject obj) throws RemoteExceptionSE
      特定の Enterprise Bean オブジェクトが、呼び出された Enterprise Bean オブジェクトと同一かどうかをテストします。
      パラメーター:
      obj - 呼び出されたオブジェクトとの同一性をテストするオブジェクト。
      戻り値:
      指定された Enterprise Bean オブジェクトが呼び出されたオブジェクトと同一である場合は true、そうでない場合は false。
      例外:
      RemoteExceptionSE - システムレベルの障害が原因でメソッドが失敗した場合にスローされます。