模块  java.rmi
软件包  java.rmi.activation

Class ActivationDesc

  • 实现的所有接口
    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所有对象都在同一VM中激活。

        请注意，由此构造函数创建的描述符指定的对象将仅按需激活（默认情况下，重新启动模式为false ）。 如果可激活对象需要重新启动服务，请使用采用布尔参数restart的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的当前标识。 具有相同ActivationGroupID所有对象都在同一VM中激活。

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

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

      • ActivationDesc

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

        请注意，由此构造函数创建的描述符指定的对象将仅按需激活（默认情况下，重新启动模式为false ）。 如果可激活对象需要重新启动服务，请使用采用布尔参数restart的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，则在重新启动激活器或在意外崩溃后重新启动对象的激活组时，将重新启动（重新激活）对象; 如果为false，则仅在需要时激活对象。 指定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()
        返回与此激活描述符关联的对象的“重新启动”模式。
        结果
        如果在守护程序启动或对象的组在意外崩溃后重新启动时，通过激活守护程序重新启动与此激活描述符关联的可激活对象，则为true;否则为false。 否则返回false，表示该对象仅通过方法调用按需激活。 请注意，如果重启模式为true ，则激活器不会强制立即激活新注册的对象; 初始激活是懒惰的。
        从以下版本开始：
        1.2

      • equals

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

      • hashCode

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