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

Class ActivationDesc

  • 实现的所有接口
    Serializable

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

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

    从以下版本开始:
    1.2
    另请参见:
    ActivatableSerialized Form
    • 构造方法详细信息

      • ActivationDesc

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

        请注意,由此构造函数创建的描述符指定的对象将仅按需激活(默认情况下,重新启动模式为false )。 如果可激活对象需要重新启动服务,请使用采用布尔参数restartActivationDesc构造函数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,则仅在需要时激活对象。 指定restarttrue不会强制新登记对象的初始立即激活; 初始激活是懒惰的。
        异常
        ActivationException - 如果当前组不存在
        UnsupportedOperationException - 当且仅当此实现不支持激活时
        从以下版本开始:
        1.2
      • ActivationDesc

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

        请注意,由此构造函数创建的描述符指定的对象将仅按需激活(默认情况下,重新启动模式为false )。 如果可激活对象需要重新启动服务,请使用采用布尔参数restartActivationDesc构造函数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,则仅在需要时激活对象。 指定restarttrue不会强制新登记对象的初始立即激活; 初始激活是懒惰的。
        异常
        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