パッケージ 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

    • メソッドの詳細

      • 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