パッケージ jakarta.ejb

インターフェース EJBHome

すべてのスーパーインターフェース:
RemoteSE
public interface EJBHome extends RemoteSE
EJBHome インターフェースは、すべての Enterprise Bean のリモートホームインターフェースによって拡張される必要があります。Enterprise Bean のリモートホームインターフェースは、リモートクライアントが Enterprise Bean オブジェクトを作成、検索、削除できるようにするメソッドを定義します。

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

EJB 3.0 以降の API に書き込まれる Enterprise Bean は、ホームインターフェースを必要としません。

導入:
EJB 1.0

  • 方法の概要

    修飾子と型
    メソッド
    説明
    EJBMetaData
    getEJBMetaData()
    Enterprise Bean の EJBMetaData インターフェースを取得します。
    HomeHandle
    getHomeHandle()
    リモートホームオブジェクトのハンドルを取得します。
    void
    remove(Handle handle)
    ハンドルで識別される Enterprise Bean オブジェクトを削除します。
    void
    remove(ObjectSE primaryKey)
    主キーで識別される Enterprise Bean オブジェクトを削除します。

  • 方法の詳細

    • remove

      void remove(Handle handle) throws RemoteExceptionSE, RemoveException
      ハンドルで識別される Enterprise Bean オブジェクトを削除します。
      パラメーター:
      handle - 削除する Enterprise Bean オブジェクトのハンドル
      例外:
      RemoveException - Enterprise Bean またはコンテナーが、クライアントがオブジェクトを削除することを許可していない場合にスローされます。
      RemoteExceptionSE - システムレベルの障害が原因でメソッドが失敗した場合にスローされます。

    • remove

      void remove(ObjectSE primaryKey) throws RemoteExceptionSE, RemoveException
      主キーで識別される Enterprise Bean オブジェクトを削除します。

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

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

      パラメーター:
      primaryKey - 削除する Enterprise Bean オブジェクトの主キー
      例外:
      RemoveException - Enterprise Bean またはコンテナーが、クライアントがオブジェクトを削除することを許可していない場合にスローされます。
      RemoteExceptionSE - システムレベルの障害が原因でメソッドが失敗した場合にスローされます。

    • getEJBMetaData

      EJBMetaData getEJBMetaData() throws RemoteExceptionSE
      Enterprise Bean の EJBMetaData インターフェースを取得します。EJBMetaData インターフェースにより、クライアントは Enterprise Bean に関する情報を取得できます。

      EJBMetaData インターフェースを介して取得できる情報は、ツールで使用することを目的としています。

      戻り値:
      Enterprise Bean の EJBMetaData インターフェース。
      例外:
      RemoteExceptionSE - システムレベルの障害が原因でメソッドが失敗した場合にスローされます。

    • getHomeHandle

      HomeHandle getHomeHandle() throws RemoteExceptionSE
      リモートホームオブジェクトのハンドルを取得します。ハンドルを後で使用して、おそらく別の Java 仮想マシンでリモートホームオブジェクトへの参照を再取得できます。
      戻り値:
      リモートホームオブジェクトのハンドル。
      例外:
      RemoteExceptionSE - システムレベルの障害が原因でメソッドが失敗した場合にスローされます。
      導入:
      EJB 1.1