モジュール java.rmi
パッケージ java.rmi.activation

インタフェースActivationInstantiator

  • すべてのスーパー・インタフェース:
    Remote
    既知のすべての実装クラス:
    ActivationGroup, ActivationGroup_Stub
    public interface ActivationInstantiator
extends Remote
    ActivationInstantiatorは、起動可能なオブジェクトのインスタンスを生成します。 ActivationGroupの具象サブクラスでは、グループ内でのオブジェクトの作成を処理するためnewInstanceを実装しています。
    導入されたバージョン:
    1.2
    関連項目:
    ActivationGroup

    • メソッドの詳細

      • newInstance

        MarshalledObject<? extends Remote> newInstance​(ActivationID id,
                                               ActivationDesc desc)
                                        throws ActivationException,
                                               RemoteException
        アクティベータは、インスタンシエータのnewInstanceメソッドを呼び出して、グループの中に、起動識別子がidで、記述子がdescのオブジェクトを作成し直します。 インスタンシエータは、次の処理を行います。
        • 記述子のgetClassNameメソッドを使って、オブジェクトのクラスを決定する
        • getLocationメソッドを使って記述子から取得した、コードの位置からクラスをロードする
        • オブジェクトのクラスの特別な起動コンストラクタを呼び出して、クラスのインスタンスを生成する。このコンストラクタは、ActivationID、およびオブジェクト固有の初期化データが格納されているMarshalledObjectの、2つの引数をとる
        • インスタンシエータが作成したリモート・オブジェクトのスタブが格納されている、MarshalledObjectを返す

        アクティベーションを成功させるには、次のいずれかの要件を満たす必要があります。それ以外の場合はActivationExceptionがスローされます:

        • 起動するクラスと特別なコンストラクタは共にパブリックであり、クラスはexportedから少なくともjava.rmiモジュールまでのパッケージにあります。または
        • アクティブ化するクラスは、openから少なくともjava.rmiモジュールまでのパッケージ内にあります。
        パラメータ:
        id - オブジェクトの起動識別子
        desc - オブジェクトの記述子
        戻り値:
        リモート・オブジェクトのスタブの直列化表現を含む、整列化されたオブジェクト
        例外:
        ActivationException - オブジェクトの起動に失敗した場合
        RemoteException - リモート呼出しが失敗した場合
        導入されたバージョン:
        1.2