java.rmi.activation

接口
异常
java.lang.Object
  继承者 java.rmi.activation.ActivationID
所有已实现的接口:
Serializable

public class ActivationID
     
extends Object
implements Serializable

激活利用特定的标识符来表示远程对象,对象能随着时间被激活。一个激活标识符(类 ActivationID 的一个实例)包含了激活一个对象所需的几部分信息:

  • 到对象激活器的远程引用(一个 RemoteRef 实例),以及
  • 对象的惟一标识符(一个 UID 实例)。

对象的激活标识符能通过利用激活系统注册一个对象获得。注册可通过以下几种方式完成:

  • 通过 Activatable.register 方法
  • 通过第一个 Activatable 构造方法(带有三个参数,并且注册和导出该对象),以及
  • 通过第一个 Activatable.exportObject 方法,它带有激活描述符、对象以及端口作为参数;此方法同时注册和导出对象。

从以下版本开始:
1.2
另请参见:
Activatable, 序列化表格

构造方法摘要
ActivationID(Activator activator)
          ActivationID 的构造方法带有单个参数 activator,这指定了一个对激活器(负责激活与此标识符相关联的对象)的远程引用。
 
方法摘要
 Remote activate(boolean force)
          激活此 id 的对象。
 boolean equals(Object obj)
          比较两个激活 id 的内容相等性。
 int hashCode()
          返回激活 id 的哈希码。
 
从类 java.lang.Object 继承的方法
clone, finalize, getClass, notify, notifyAll, toString, wait, wait, wait
 

构造方法详细信息

ActivationID

public ActivationID(Activator activator)
ActivationID 的构造方法带有单个参数 activator,这指定了一个对激活器(负责激活与此标识符相关联的对象)的远程引用。 ActivationID 的实例是全局惟一的。

参数:
activator - 对负责激活对象的激活器的引用
从以下版本开始:
1.2
方法详细信息

activate

public Remote activate(boolean force)
                throws ActivationException,
                       UnknownObjectException,
                       RemoteException
激活此 id 的对象。

参数:
force - 如果为 true,则当激活对象时强制激活器与组联络(而不是返回一个缓存引用);如果为 false,则返回一个缓存值也可以接受
返回:
对激活远程对象的引用
抛出:
ActivationException - 如果激活失败
UnknownObjectException - 如果对象未知
RemoteException - 如果远程调用失败
从以下版本开始:
1.2

hashCode

public int hashCode()
返回激活 id 的哈希码。引用同一个远程对象的两个标识符将具有相同的哈希码。

覆盖:
Object 中的 hashCode
返回:
此对象的一个哈希码值。
从以下版本开始:
1.2
另请参见:
Hashtable

equals

public boolean equals(Object obj)
比较两个激活 id 的内容相等性。如果以下两个条件都为 true,则返回 true:1) 惟一标识符相等(从内容上)和 2) 每个标识符指定的激活器都引用相同的远程对象。

覆盖:
Object 中的 equals
参数:
obj - 要与之比较的 Object
返回:
如果这些 Object 相等,则返回 true;否则返回 false
从以下版本开始:
1.2
另请参见:
Hashtable