- java.lang.Object
-
- java.rmi.activation.ActivationDesc
-
- 实现的所有接口
-
Serializable
public final class ActivationDesc extends Object implements Serializable
激活描述符包含激活对象所需的信息:- 对象的组标识符,
- 对象的完全限定类名,
- 对象的代码位置(类的位置),代码库URL路径,
- 对象的重启“模式”,以及
- 一个“编组”对象,可以包含对象特定的初始化数据。
在激活系统中注册的描述符可用于重新创建/激活描述符指定的对象。 对象描述符中的
MarshalledObject
作为第二个参数传递给远程对象的构造函数,以便在重新初始化/激活期间使用该对象。- 从以下版本开始:
- 1.2
- 另请参见:
-
Activatable
, Serialized Form
-
-
构造方法摘要
构造方法 构造器 描述 ActivationDesc(String className, String location, MarshalledObject<?> data)
为类名为className
的对象构造一个对象描述符,该对象可以从代码location
加载,其初始化信息为data
。ActivationDesc(String className, String location, MarshalledObject<?> data, boolean restart)
为类名为className
的对象构造一个对象描述符,该对象可以从代码location
加载,其初始化信息为data
。ActivationDesc(ActivationGroupID groupID, String className, String location, MarshalledObject<?> data)
为类名为className
的对象构造一个对象描述符,该对象可以从代码location
加载,其初始化信息为data
。ActivationDesc(ActivationGroupID groupID, String className, String location, MarshalledObject<?> data, boolean restart)
为类名为className
的对象构造一个对象描述符,该对象可以从代码location
加载,其初始化信息为data
。
-
方法摘要
所有方法 实例方法 具体的方法 变量和类型 方法 描述 boolean
equals(Object obj)
比较两个激活描述符的内容相等性。String
getClassName()
返回此描述符指定的对象的类名。MarshalledObject<?>
getData()
返回“编组对象”,其中包含此描述符指定的对象的初始化/激活数据。ActivationGroupID
getGroupID()
返回此描述符指定的对象的组标识符。String
getLocation()
返回此描述符指定的对象的代码位置。boolean
getRestartMode()
返回与此激活描述符关联的对象的“重新启动”模式。int
hashCode()
为类似的ActivationDesc
返回相同的hashCode。
-
-
-
构造方法详细信息
-
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)
比较两个激活描述符的内容相等性。
-
-