ActivationDesc

概述

软件包

类

使用

树

已过时

索引

帮助

Java^TM 2 Platform
Standard Ed. 5.0

上一个类 下一个类

框架 无框架

摘要：嵌套 | 字段 | 构造方法 | 方法

详细信息：字段 | 构造方法 | 方法

java.rmi.activation
类 ActivationDesc

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

所有已实现的接口：: Serializable

public final class ActivationDesc
extends Object
implements Serializable
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

如果此 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