パッケージ jakarta.ejb.spi

インターフェース HandleDelegate


  • public interface HandleDelegate
    HandleDelegate インターフェースは、Enterprise Bean コンテナーによって実装されます。これは、jakarta.ejb.Handle および jakarta.ejb.HomeHandle のポータブル実装で使用されます。Enterprise Bean コンポーネントまたはクライアントコンポーネントでは使用されません。ストリームへの EJBObject および EJBHome 参照を直列化および逆直列化するメソッドを提供します。

    HandleDelegate オブジェクトは、予約名 "java:comp/HandleDelegate" での JNDI ルックアップによって取得されます。

    導入:
    EJB 2.0
    • メソッドの詳細

      • writeEJBObject

        void writeEJBObject​(EJBObject ejbObject,
                            ObjectOutputStreamSE ostream)
                     throws IOExceptionSE
        ハンドルに対応する EJBObject 参照を直列化します。

        このメソッドは、ポータブル Handle 実装クラスの writeObject メソッドから呼び出されます。ostream オブジェクトは、Handle クラスの writeObject メソッドに渡されたものと同じオブジェクトです。

        パラメーター:
        ejbObject - 直列化される EJBObject 参照。
        ostream - 出力ストリーム。
        例外:
        IOExceptionSE - システムレベルの障害のため、EJBObject を直列化できませんでした。
      • readEJBObject

        EJBObject readEJBObject​(ObjectInputStreamSE istream)
                         throws IOExceptionSE,
                                ClassNotFoundExceptionSE
        ハンドルに対応する EJBObject 参照を逆直列化します。

        readEJBObject メソッドは、ポータブル Handle 実装クラスの readObject メソッドから呼び出されます。istream オブジェクトは、Handle クラスの readObject メソッドに渡されたものと同じオブジェクトです。readEJBObject が呼び出されるとき、istream は、EJBObject 参照を読み取ることができるストリーム内の場所を指している必要があります。コンテナーは、EJBObject 参照が逆直列化の直後に呼び出しを実行できることを確認する必要があります。

        パラメーター:
        istream - 入力ストリーム。
        戻り値:
        デシリアライズされた EJBObject 参照。
        例外:
        IOExceptionSE - システムレベルの障害のため、EJBObject を逆直列化できませんでした。
        ClassNotFoundExceptionSE - 一部のクラスが見つからなかったため、EJBObject を逆直列化できませんでした。
      • writeEJBHome

        void writeEJBHome​(EJBHome ejbHome,
                          ObjectOutputStreamSE ostream)
                   throws IOExceptionSE
        HomeHandle に対応する EJBHome 参照を直列化します。

        このメソッドは、ポータブル HomeHandle 実装クラスの writeObject メソッドから呼び出されます。ostream オブジェクトは、Handle クラスの writeObject メソッドに渡されたものと同じオブジェクトです。

        パラメーター:
        ejbHome - 直列化される EJBHome 参照。
        ostream - 出力ストリーム。
        例外:
        IOExceptionSE - システムレベルの障害のため、EJBObject を直列化できませんでした。
      • readEJBHome

        EJBHome readEJBHome​(ObjectInputStreamSE istream)
                     throws IOExceptionSE,
                            ClassNotFoundExceptionSE
        HomeHandle に対応する EJBHome 参照をデシリアライズします。

        readEJBHome メソッドは、ポータブル HomeHandle 実装クラスの readObject メソッドから呼び出されます。istream オブジェクトは、HomeHandle クラスの readObject メソッドに渡されたものと同じオブジェクトです。readEJBHome が呼び出されると、istream は、EJBHome 参照を読み取ることができるストリーム内の場所を指している必要があります。コンテナーは、EJBHome 参照が逆直列化の直後に呼び出しを実行できることを確認する必要があります。

        パラメーター:
        istream - 入力ストリーム。
        戻り値:
        デシリアライズされた EJBHome リファレンス。
        例外:
        IOExceptionSE - システムレベルの障害のため、EJBHome を逆直列化できませんでした。
        ClassNotFoundExceptionSE - 一部のクラスが見つからなかったため、EJBHome を逆直列化できませんでした。