java.rmi.activation
类 ActivationDesc

java.lang.Object
  java.rmi.activation.ActivationDesc

所有已实现的接口：

Serializable

public final class ActivationDesc
     

      extends 
      Object
     
     

      implements 
      Serializable
     

激活描述符包含激活对象所必需的信息：

• 对象的组标识符，
• 对象的完全限定的类名，
• 对象的代码基（类中的位置），一个代码基 URL 路径，
• 对象的重启“模式”，以及
• 一个可包含特定于对象的初始化数据的“编组”对象。

一个描述符通过激活系统注册，可用于重建/激活描述符所指定的对象。对象描述符中的 MarshalledObject 被传入作为远程对象构造方法的第二个参数，供对象在重新初始化/激活过程中使用。

从以下版本开始：

1.2

另请参见：

Activatable, 序列化表格

ActivationDesc

public ActivationDesc(String className,
                      String location,
                      MarshalledObject<?> data)
               throws ActivationException

为类名为 className 的对象构造一个对象描述符，这可从代码 location 处加载，并且其初始化信息为 data。如果使用这种形式的构造方法， groupID 默认为此 VM 的 ActivationGroup 的当前 id。在同一 VM 中，具有相同 ActivationGroupID 的所有对象都被激活。

注意，由此构造方法所创建的描述符指定的对象将仅仅按需被激活（默认情况下，重启模式为 false）。如果一个可激活的对象需要重启服务，使用带有 boolean 参数 restart 的 ActivationDesc 构造方法之一。

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

参数：

className - 对象的完全限定包的类名

location - 对象的代码基（类被加载处）

data - 以编组形式包含的对象初始化（激活）数据。

抛出：

ActivationException - 如果当前组不存在

从以下版本开始：

1.2

ActivationDesc

public ActivationDesc(String className,
                      String location,
                      MarshalledObject<?> data,
                      boolean restart)
               throws ActivationException

为类名为 className 的对象构造一个对象描述符，这可从代码 location 处加载，并且其初始化信息为 data。如果使用这种形式的构造方法， groupID 默认为此 VM 的 ActivationGroup 的当前 id。在同一 VM 中，具有相同 ActivationGroupID 的所有对象都被激活。

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

参数：

className - 对象的完全限定包的类名

location - 对象的代码基（类被加载处）

data - 以编组形式包含的对象初始化（激活）数据。

restart - 如果为 true，则在一次意外崩溃之后，如果激活器被重启或者对象的激活组被重启，则该对象也会被重启（激活）；如果为 false，对象只能按需激活。指定 restart 为 true，不强制对新注册的对象立即进行一次初始激活操作；初始激活是延后的。

抛出：

ActivationException - 如果当前组不存在

从以下版本开始：

1.2

ActivationDesc

public ActivationDesc(ActivationGroupID groupID,
                      String className,
                      String location,
                      MarshalledObject<?> data)

为类名为 className 的对象构造一个对象描述符，这可从代码 location 处加载，并且其初始化信息为 data。在同一 VM 中，具有相同 groupID 的所有对象都被激活。

注意，由此构造方法所创建的描述符指定的对象将仅仅按需激活（默认情况下，重启模式为 false）。如果可激活对象需要重启服务，使用带有 boolean 参数 restart 的 ActivationDesc 构造方法之一。

参数：

groupID - 组的标识符（从注册 ActivationSystem.registerGroup 方法处获得）。该组指示 VM 中的对象应当被激活。

className - 对象的完全限定包的类名

location - 对象的代码基（类被加载处）

data - 以编组形式包含的对象初始化（激活）数据。

抛出：

IllegalArgumentException - 如果 groupID 为 null

从以下版本开始：

1.2

ActivationDesc

public ActivationDesc(ActivationGroupID groupID,
                      String className,
                      String location,
                      MarshalledObject<?> data,
                      boolean restart)

为类名为 className 的对象构造一个对象描述符，这可从代码的 location 处加载，并且其初始化信息为 data。在同一 VM 中，具有相同 groupID 的所有对象都被激活。

参数：

groupID - 组的标识符（从注册 ActivationSystem.registerGroup 方法中获得）。该组指示 VM 中的对象应当被激活。

className - 对象的完全限定包的类名

location - 对象的代码基（类被加载处）

data - 以编组形式包含的对象初始化（激活）数据。

restart - 如果为 true，则在一次意外崩溃之后，如果激活器被重启或者对象的激活组被重启，该对象将会被重启（激活）；如果为 false，对象只能按需激活。指定 restart 为 true，不强制对新创建的对象立即进行一次初始激活操作；初始激活是延后的。

抛出：

IllegalArgumentException - 如果 groupID 为 null

从以下版本开始：

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，这意味着该对象仅通过方法调用来按需激活。注意，如果重启模式为 true，则激活器不强制对新注册的对象立即进行一次初始激活操作；初始激活是延后的。

从以下版本开始：

1.2

equals

public boolean equals(Object obj)

比较两个激活描述符的内容相等性。

覆盖：

类 Object 中的 equals

参数：

obj - 要与之比较的 Object

返回：

如果这些 Object 相等，则返回 true；否则返回 false。

从以下版本开始：

1.2

另请参见：

Hashtable

hashCode

public int hashCode()

为类似的 ActivationDesc 返回相同的哈希码

覆盖：

类 Object 中的 hashCode

返回：

一个整数

另请参见：

Hashtable