compact2, compact3

java.rmi.activation

Class ActivationDesc

java.lang.Object

java.rmi.activation.ActivationDesc

All Implemented Interfaces:

Serializable

public final class ActivationDesc
extends Object
implements Serializable

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

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

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

从以下版本开始：

1.2

另请参见：

Activatable ， Serialized Form

构造方法摘要

构造方法

Constructor and Description
ActivationDesc(ActivationGroupID groupID, String className, String location, MarshalledObject<?> data) 为类名为className的对象构造一个对象描述符，该对象 className可以从代码 location加载，其初始化信息为 data 。
ActivationDesc(ActivationGroupID groupID, String className, String location, MarshalledObject<?> data, boolean restart) 为类名为className的对象构造一个对象描述符，该对象 className可以从代码 location加载，其初始化信息为 data 。
ActivationDesc(String className, String location, MarshalledObject<?> data) 为类名为className的对象构造一个对象 className ，可以从代码 location加载，其初始化信息为 data 。
ActivationDesc(String className, String location, MarshalledObject<?> data, boolean restart) 为类名为className的对象构造一个对象 className ，可以从代码 location加载，其初始化信息为 data 。

方法摘要

Modifier and Type	Method and Description
boolean	equals(Object obj) 比较两个激活描述符的内容相等性。
String	getClassName() 返回此描述符指定的对象的类名。
MarshalledObject<?>	getData() 返回一个包含由该描述符指定的对象的初始化/激活数据的“编组对象”。
ActivationGroupID	getGroupID() 返回由此描述符指定的对象的组标识符。
String	getLocation() 返回由此描述符指定的对象的代码位置。
boolean	getRestartMode() 返回与此激活描述符关联的对象的“重启”模式。
int	hashCode() 返回相同的hashCode类似的 ActivationDesc s。

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, toString, wait, wait, wait

构造方法详细信息

ActivationDesc

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

为类名为className的对象构造一个对象className ，可以从代码location加载，其初始化信息为data 。 如果使用此构造方法，则groupID默认为此虚拟机的ActivationGroup的当前ID。 具有相同ActivationGroupID所有对象在同一虚拟机中被激活。

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

如果此虚拟机没有当前激活组，此构造函数将抛出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的对象构造一个对象className ，可以从代码location加载，其初始化信息为data 。 如果使用这种形式的构造函数，那么groupID默认为此虚拟机的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的对象构造一个对象描述符，该对象className可以从代码location加载，其初始化信息为data 。 具有相同groupID所有对象在相同的Java VM中被激活。

请注意，使用此构造函数创建的描述符指定的对象只会根据需要激活（默认情况下，重新启动模式为false ）。 如果可激活的对象需要重新启动服务，请使用ActivationDesc构造函数中的一个，该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的对象构造一个对象描述符，该对象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