| |||||||||
摘要: 嵌套 | 字段 | 构造方法 | 方法 | 详细信息: 字段 | 构造方法 | 方法 |
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
具有不同的incarnation
RemoteException
- 如果远程调用失败- 从以下版本开始:
- 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)