|
|||||||||
摘要: 嵌套 | 字段 | 构造方法 | 方法 | 详细信息: 字段 | 构造方法 | 方法 |
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(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 。 |
|
ActivationDesc(String className, String location, MarshalledObject data) 为类名为 className 的对象构造一个对象描述符,这可从代码 location 处加载,并且其初始化信息为 data 。 |
|
ActivationDesc(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 返回相同的哈希码 |
从类 java.lang.Object 继承的方法 |
---|
clone, finalize, getClass, notify, notifyAll, toString, wait, wait, wait |
构造方法详细信息 |
---|
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