java.rmi.activation

接口
异常
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 参数 restartActivationDesc 构造方法之一。

如果此 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,对象只能按需激活。指定 restarttrue,不强制对新注册的对象立即进行一次初始激活操作;初始激活是延后的。
抛出:
ActivationException - 如果当前组不存在
从以下版本开始:
1.2

ActivationDesc

public ActivationDesc(ActivationGroupID groupID,
                      String className,
                      String location,
                      MarshalledObject<?> data)
为类名为 className 的对象构造一个对象描述符,这可从代码 location 处加载,并且其初始化信息为 data。在同一 VM 中,具有相同 groupID 的所有对象都被激活。

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

参数:
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,对象只能按需激活。指定 restarttrue,不强制对新创建的对象立即进行一次初始激活操作;初始激活是延后的。
抛出:
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