public interface ActivationSystem
ActivationSystem
为注册组和在那些组中要被激活的“可激活”对象提供一种方式。ActivationSystem
与 Activator
紧密协作,通过 ActivationSystem
和 ActivationMonitor
来激活注册的对象,ActivationMonitor
获取有关活动的和不活动的对象以及不活动组的信息。
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 被激活。 |
字段详细信息 |
---|
static final int SYSTEM_PORT
方法详细信息 |
---|
ActivationID registerObject(ActivationDesc desc) throws ActivationException, UnknownGroupException, RemoteException
registerObject
方法用于注册一个激活描述符
desc
,并且为可激活的远程对象获取一个激活标识符。
ActivationSystem
为描述符
desc
指定的对象创建一个
ActivationID
(激活标识符),并且在稳定的存储器中记录激活描述符及其关联的标识符,以便将来使用。当
Activator
接收一个针对指定标识符的
activate
请求时,激活器为指定的标识符查找激活描述符(前面已注册),并且使用该信息来激活对象。
desc
- 对象的激活描述符
ActivationException
- 如果注册失败(如,数据库更新失败等)。
UnknownGroupException
- 如果在
desc
中引用的组未通过此系统注册
RemoteException
- 如果远程调用失败
void unregisterObject(ActivationID id) throws ActivationException, UnknownObjectException, RemoteException
ActivationSystem
注册的激活 id 和描述符;该对象无法再通过对象的激活 id 被激活。
id
- 对象的激活 id(来自前面的注册)
ActivationException
- 如果取消注册失败(如,数据库更新失败等)。
UnknownObjectException
- 如果对象未知(未注册)
RemoteException
- 如果远程调用失败
ActivationGroupID registerGroup(ActivationGroupDesc desc) throws ActivationException, RemoteException
ActivationSystem
来注册。
desc
- 组描述符
ActivationException
- 如果组注册失败
RemoteException
- 如果远程调用失败
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
- 如果远程调用失败
void unregisterGroup(ActivationGroupID id) throws ActivationException, UnknownGroupException, RemoteException
id
- 激活组的标识符
ActivationException
- 如果取消注册失败(如,数据库更新失败等)。
UnknownGroupException
- 如果组未注册
RemoteException
- 如果远程过程调用失败
void shutdown() throws RemoteException
RemoteException
- 如果联络/关闭激活守护程序失败
ActivationDesc setActivationDesc(ActivationID id, ActivationDesc desc) throws ActivationException, UnknownObjectException, UnknownGroupException, RemoteException
id
的对象设置激活描述符
desc
。此更改将在该对象的后续激活中生效。
id
- 可激活对象的激活标识符
desc
- 可激活对象的激活描述符
UnknownGroupException
- 与
desc
关联的组不是一个注册组
UnknownObjectException
- 激活
id
未被注册
ActivationException
- 一般失败(如,不能更新日志)
RemoteException
- 如果远程调用失败
getActivationDesc(java.rmi.activation.ActivationID)
ActivationGroupDesc setActivationGroupDesc(ActivationGroupID id, ActivationGroupDesc desc) throws ActivationException, UnknownGroupException, RemoteException
id
的对象设置激活组描述符
desc
。此更改将在该组的后续激活中生效。
id
- 激活组的激活组标识符
desc
- 激活组的激活组描述符
UnknownGroupException
- 与
id
关联的组不是一个注册组
ActivationException
- 一般失败(如,不能更新日志)
RemoteException
- 如果远程调用失败
getActivationGroupDesc(java.rmi.activation.ActivationGroupID)
ActivationDesc getActivationDesc(ActivationID id) throws ActivationException, UnknownObjectException, RemoteException
id
的对象返回激活描述符。
id
- 可激活对象的激活标识符
UnknownObjectException
- 如果
id
未被注册
ActivationException
- 一般失败
RemoteException
- 如果远程调用失败
setActivationDesc(java.rmi.activation.ActivationID, java.rmi.activation.ActivationDesc)
ActivationGroupDesc getActivationGroupDesc(ActivationGroupID id) throws ActivationException, UnknownGroupException, RemoteException
id
的组返回激活组描述符。
id
- 该组的激活组标识符
UnknownGroupException
- 如果
id
未被注册
ActivationException
- 一般失败
RemoteException
- 如果远程调用失败
setActivationGroupDesc(java.rmi.activation.ActivationGroupID, java.rmi.activation.ActivationGroupDesc)