Module  java.rmi
软件包  java.rmi.activation

Class ActivationDesc

  • All Implemented Interfaces:
    Serializable 

    public final class ActivationDesc
extends Object
implements Serializable
    激活描述符包含激活对象所需的信息：
    • 对象的组标识符，
    • 该对象的全限定类名，
    • 对象的代码位置（类的位置），代码库URL路径，
    • 对象的重启“模式”，并且，
    • 一个可以包含对象特定初始化数据的“编组”对象。

    可以使用激活系统注册的描述符来重新创建/激活由描述符指定的对象。 对象描述符中的MarshalledObject作为第二个参数传递给远程对象的构造函数，以便在重新初始化/激活期间使用对象。

    从以下版本开始：
    1.2
    另请参见：
    Activatable ， Serialized Form

    • 构造方法详细信息

      • ActivationDesc

        public ActivationDesc​(String className,
                      String location,
                      MarshalledObject<?> data)
               throws ActivationException
        为类名为className的对象构造一个对象描述符，可以从代码location加载，其初始化信息为data 。 如果使用此构造方法，则groupID默认为此VM的当前标识为ActivationGroup 。 具有相同ActivationGroupID所有对象在同一个虚拟机中被激活。

        请注意，使用此构造函数创建的描述符指定的对象只能根据需要激活（默认情况下，重新启动模式为false ）。 如果可激活的对象需要重新启动服务，请使用ActivationDesc构造函数中的一个，该构造函数采用布尔参数restart 。

        如果此VM没有当前激活组，此构造函数将抛出ActivationException 。 要创建ActivationGroup使用ActivationGroup.createGroup方法。

        参数
        className - 对象的完全包限定类名
        location - 对象的代码位置（从该类加载的位置）
        data - 对象的初始化（激活）数据以编组形式包含。
        异常
        ActivationException - 如果当前组不存在
        UnsupportedOperationException - 当且仅当此实现不支持激活时
        从以下版本开始：
        1.2

      • ActivationDesc

        public ActivationDesc​(String className,
                      String location,
                      MarshalledObject<?> data,
                      boolean restart)
               throws ActivationException
        为类名为className的对象构造一个对象描述符，可以从代码location加载，其初始化信息为data 。 如果使用了此形式的构造函数，那么groupID默认为此VM的ActivationGroup的当前ID。 具有相同ActivationGroupID所有对象在同一虚拟机中被激活。

        如果此虚拟机没有当前激活组，此构造函数将抛出ActivationException 。 要创建一个ActivationGroup使用ActivationGroup.createGroup方法。

        参数
        className - 对象的完全包合格类名
        location - 对象的代码位置（从该类加载的位置）
        data - 对象的初始化（激活）数据以编组形式包含。
        restart - 如果为true，则当激活程序重新启动或者在意外崩溃后重新启动对象的激活组时，对象将重新启动（重新激活）; 如果是虚假的，对象只能按需激活。 指定restart为true不强制初始立即激活新注册的对象; 初始激活是懒惰的。
        异常
        ActivationException - 如果当前组不存在
        UnsupportedOperationException - 当且仅当此实现不支持激活时
        从以下版本开始：
        1.2

      • ActivationDesc

        public ActivationDesc​(ActivationGroupID groupID,
                      String className,
                      String location,
                      MarshalledObject<?> data)
        为类名为className的对象构造一个对象描述符，该对象描述符可以从代码location加载，其初始化信息为data 。 具有相同groupID所有对象在同一个Java VM中被激活。

        请注意，使用此构造函数创建的描述符指定的对象只能根据需要激活（默认情况下，重新启动模式为false ）。 如果可激活的对象需要重新启动服务，请使用ActivationDesc构造函数中的一个，该构造函数采用布尔参数restart 。

        参数
        groupID - 组的标识符（从注册ActivationSystem.registerGroup方法获得）。 该组指示应激活对象的VM。
        className - 对象的完全包装合格的类名
        location - 对象的代码位置（从该类加载的位置）
        data - 对象的初始化（激活）数据以编组形式包含。
        异常
        IllegalArgumentException - 如果 groupID为空
        UnsupportedOperationException - 当且仅当此实现不支持激活时
        从以下版本开始：
        1.2

      • ActivationDesc

        public ActivationDesc​(ActivationGroupID groupID,
                      String className,
                      String location,
                      MarshalledObject<?> data,
                      boolean restart)
        为类名为className的对象构造一个对象描述符，可以从代码location加载，其初始化信息为data 。 具有相同groupID所有对象在相同的Java VM中被激活。
        参数
        groupID - 组的标识符（从注册ActivationSystem.registerGroup方法获得）。 该组指示应激活对象的VM。
        className - 对象的完全包装合格的类名
        location - 对象的代码位置（从该类加载的位置）
        data - 对象的初始化（激活）数据以编组形式包含。
        restart - 如果为true，则当激活器重新启动或者在意外崩溃后重新启动对象的激活组时，对象将重新启动（重新激活）; 如果是虚假的，对象只能按需激活。 指定restart是true不会强制新登记对象的初始立即激活; 初始激活是懒惰的。
        异常
        IllegalArgumentException - 如果 groupID为空
        UnsupportedOperationException - 当且仅当此实现不支持激活时
        从以下版本开始：
        1.2

    • 方法详细信息

      • getGroupID

        public ActivationGroupID getGroupID​()
        返回由此描述符指定的对象的组标识符。 组提供了将对象聚合到单个Java虚拟机中的方法。 RMI使用相同的虚拟机中的groupID创建/激活对象。
        结果
        组标识符
        从以下版本开始：
        1.2

      • getClassName

        public String getClassName​()
        返回此描述符指定的对象的类名。
        结果
        类名
        从以下版本开始：
        1.2

      • getLocation

        public String getLocation​()
        返回由此描述符指定的对象的代码位置。
        结果
        代码位置
        从以下版本开始：
        1.2

      • getData

        public MarshalledObject<?> getData​()
        返回一个包含由该描述符指定的对象的初始化/激活数据的“编组对象”。
        结果
        对象具体的“初始化”数据
        从以下版本开始：
        1.2

      • getRestartMode

        public boolean getRestartMode​()
        返回与此激活描述符关联的对象的“重启”模式。
        结果
        如果与该激活描述符相关联的可激活对象在守护程序出现时或者在意外崩溃后重新启动对象的组，则通过激活守护程序重新启动; 否则返回false，这意味着该对象仅通过方法调用按需激活。 请注意，如果重新启动模式为true ，则激活器不强制初始立即激活新注册的对象; 初始激活是懒惰的。
        从以下版本开始：
        1.2

      • equals

        public boolean equals​(Object obj)
        比较两个激活描述符的内容相等性。
        重写：
        equals在 Object
        参数
        obj - 要比较的对象
        结果
        如果这些对象相等则为true; 否则为假。
        从以下版本开始：
        1.2
        另请参见：
        Hashtable

      • hashCode

        public int hashCode​()
        返回相同的hashCode类似的 ActivationDesc s。
        重写：
        hashCode在 Object
        结果
        一个整数
        另请参见：
        Hashtable