| |||||||||
| 摘要： 嵌套 | 字段 | 构造方法 | 方法 | 详细信息： 字段 | 构造方法 | 方法 | ||||||||
java.rmi.activation
接口 ActivationSystem
- 所有超级接口：
- Remote
public interface ActivationSystem
- extends Remote
ActivationSystem 为注册组和在那些组中要被激活的“可激活”对象提供一种方式。ActivationSystem 与 Activator 紧密协作，通过 ActivationSystem 和 ActivationMonitor 来激活注册的对象，ActivationMonitor 获取有关活动的和不活动的对象以及不活动组的信息。
- 从以下版本开始：
- 1.2
- 另请参见：
Activator,ActivationMonitor
| 字段摘要 | |
|---|---|
static int | SYSTEM_PORT查找激活系统的端口。 |
| 方法摘要 | |
|---|---|
ActivationMonitor | activeGroup(ActivationGroupID id, ActivationInstantiator group, long incarnation)通过回调来通知激活系统该组现在是活动的。 |
ActivationDesc | getActivationDesc(ActivationID id)为具有该激活标识符 id 的对象返回激活描述符。 |
ActivationGroupDesc | getActivationGroupDesc(ActivationGroupID id)为具有该激活组标识符 id 的组返回激活组描述符。 |
ActivationGroupID | registerGroup(ActivationGroupDesc desc)注册激活组。 |
ActivationID | registerObject(ActivationDesc desc)registerObject 方法用于注册一个激活描述符 desc，并且为可激活的远程对象获取一个激活标识符。 |
ActivationDesc | setActivationDesc(ActivationID id, ActivationDesc desc)为具有激活标识符 id 的对象设置激活描述符 desc。 |
ActivationGroupDesc | setActivationGroupDesc(ActivationGroupID id, ActivationGroupDesc desc)为具有激活组标识符 id 的对象设置激活组描述符 desc。 |
void | shutdown()关闭此激活系统。 |
void | unregisterGroup(ActivationGroupID id)移除激活组。 |
void | unregisterObject(ActivationID id)移除前面通过 ActivationSystem 注册的激活 id 和描述符；该对象无法再通过对象的激活 id 被激活。 |
| 字段详细信息 |
|---|
SYSTEM_PORT
static final int SYSTEM_PORT
- 查找激活系统的端口。
- 另请参见：
- 常量字段值
| 方法详细信息 |
|---|
registerObject
ActivationID registerObject(ActivationDesc desc) throws ActivationException, UnknownGroupException, RemoteException
registerObject方法用于注册一个激活描述符desc，并且为可激活的远程对象获取一个激活标识符。ActivationSystem为描述符desc指定的对象创建一个ActivationID（激活标识符），并且在稳定的存储器中记录激活描述符及其关联的标识符，以便将来使用。当Activator接收一个针对指定标识符的activate请求时，激活器为指定的标识符查找激活描述符（前面已注册），并且使用该信息来激活对象。- 参数：
desc- 对象的激活描述符- 返回：
- 能用于激活对象的激活 id
- 抛出：
ActivationException- 如果注册失败（如，数据库更新失败等）。UnknownGroupException- 如果在desc中引用的组未通过此系统注册RemoteException- 如果远程调用失败- 从以下版本开始：
- 1.2
unregisterObject
void unregisterObject(ActivationID id) throws ActivationException, UnknownObjectException, RemoteException
- 移除前面通过
ActivationSystem注册的激活 id 和描述符；该对象无法再通过对象的激活 id 被激活。 - 参数：
id- 对象的激活 id（来自前面的注册）- 抛出：
ActivationException- 如果取消注册失败（如，数据库更新失败等）。UnknownObjectException- 如果对象未知（未注册）RemoteException- 如果远程调用失败- 从以下版本开始：
- 1.2
registerGroup
ActivationGroupID registerGroup(ActivationGroupDesc desc) throws ActivationException, RemoteException
- 注册激活组。一个激活组必须在对象能在该组中注册之前通过
ActivationSystem来注册。 - 参数：
desc- 组描述符- 返回：
- 该组的标识符
- 抛出：
ActivationException- 如果组注册失败RemoteException- 如果远程调用失败- 从以下版本开始：
- 1.2
activeGroup
ActivationMonitor activeGroup(ActivationGroupID id, ActivationInstantiator group, long incarnation) throws UnknownGroupException, ActivationException, RemoteException
- 通过回调来通知激活系统该组现在是活动的。此调用由
ActivationGroup.createGroup方法在内部进行，以通知ActivationSystem该组现在是活动的。 - 参数：
id- 激活组的标识符group- 组的初始化程序incarnation- 组的代号- 返回：
- 激活组的监视器
- 抛出：
UnknownGroupException- 如果组未注册ActivationException- 如果该指定id的组已经是活动的，并且该组不等于指定group，或者该组与指定组group具有不同的incarnationRemoteException- 如果远程调用失败- 从以下版本开始：
- 1.2
unregisterGroup
void unregisterGroup(ActivationGroupID id) throws ActivationException, UnknownGroupException, RemoteException
- 移除激活组。一个激活组进行此回调，以通知激活器该组应当被移除（销毁）。如果此调用成功完成，则对象无法再在该组中注册或激活。该组及其相关对象的所有信息都将从系统中移除。
- 参数：
id- 激活组的标识符- 抛出：
ActivationException- 如果取消注册失败（如，数据库更新失败等）。UnknownGroupException- 如果组未注册RemoteException- 如果远程过程调用失败- 从以下版本开始：
- 1.2
shutdown
void shutdown()
throws RemoteException- 关闭此激活系统。销毁由此激活守护程序生成的所有组，并退出激活守护程序。
- 抛出：
RemoteException- 如果联络/关闭激活守护程序失败- 从以下版本开始：
- 1.2
setActivationDesc
ActivationDesc setActivationDesc(ActivationID id, ActivationDesc desc) throws ActivationException, UnknownObjectException, UnknownGroupException, RemoteException
- 为具有激活标识符
id的对象设置激活描述符desc。此更改将在该对象的后续激活中生效。 - 参数：
id- 可激活对象的激活标识符desc- 可激活对象的激活描述符- 返回：
- 激活描述符的前一个值
- 抛出：
UnknownGroupException- 与desc关联的组不是一个注册组UnknownObjectException- 激活id未被注册ActivationException- 一般失败（如，不能更新日志）RemoteException- 如果远程调用失败- 从以下版本开始：
- 1.2
- 另请参见：
getActivationDesc(java.rmi.activation.ActivationID)