-
- All Superinterfaces:
-
Remote
public interface ActivationSystem extends Remote
ActivationSystem
提供了一种注册组的方法,以及在这些组中激活的“可激活”对象。 所述ActivationSystem
与密切合作Activator
,其激活经由注册的对象ActivationSystem
和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)
为具有激活标识符的对象desc
设置激活描述符id
。ActivationGroupDesc
setActivationGroupDesc(ActivationGroupID id, ActivationGroupDesc desc)
为具有激活组标识符的对象desc
设置激活组描述符id
。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
或该基团具有不同的incarnation
比指定group
-
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
为具有激活标识符的对象desc
设置激活描述符id
。 更改将在后续激活对象时生效。- 参数
-
id
- 可激活对象的激活标识符 -
desc
- 可激活对象的激活描述符 - 结果
- 激活描述符的先前值
- 异常
-
UnknownGroupException
- 与desc
相关联的组不是注册组 -
UnknownObjectException
- 激活id
未注册 -
ActivationException
- 一般故障(例如,无法更新日志) -
RemoteException
- 如果远程呼叫失败 - 从以下版本开始:
- 1.2
- 另请参见:
-
getActivationDesc(java.rmi.activation.ActivationID)
-
setActivationGroupDesc
ActivationGroupDesc setActivationGroupDesc(ActivationGroupID id, ActivationGroupDesc desc) throws ActivationException, UnknownGroupException, RemoteException
为具有激活组标识符的对象desc
设置激活组描述符id
。 该更改将在随后激活该组时生效。- 参数
-
id
- 激活组的激活组标识符 -
desc
- 激活组的激活组描述符 - 结果
- 激活组描述符的先前值
- 异常
-
UnknownGroupException
- 与id
关联的组不是注册组 -
ActivationException
- 一般故障(例如,无法更新日志) -
RemoteException
- 如果远程呼叫失败 - 从以下版本开始:
- 1.2
- 另请参见:
-
getActivationGroupDesc(java.rmi.activation.ActivationGroupID)
-
getActivationDesc
ActivationDesc getActivationDesc(ActivationID id) throws ActivationException, UnknownObjectException, RemoteException
返回具有激活标识符的对象的激活描述符id
。- 参数
-
id
- 可激活对象的激活标识符 - 结果
- 激活描述符
- 异常
-
UnknownObjectException
- 如果未注册id
-
ActivationException
- 一般失败 -
RemoteException
- 如果远程呼叫失败 - 从以下版本开始:
- 1.2
- 另请参见:
-
setActivationDesc(java.rmi.activation.ActivationID, java.rmi.activation.ActivationDesc)
-
getActivationGroupDesc
ActivationGroupDesc getActivationGroupDesc(ActivationGroupID id) throws ActivationException, UnknownGroupException, RemoteException
返回具有激活组标识符的组的激活组描述符id
。- 参数
-
id
- 组的激活组标识符 - 结果
- 激活组描述符
- 异常
-
UnknownGroupException
- 如果未注册id
-
ActivationException
- 一般失败 -
RemoteException
- 如果远程呼叫失败 - 从以下版本开始:
- 1.2
- 另请参见:
-
setActivationGroupDesc(java.rmi.activation.ActivationGroupID, java.rmi.activation.ActivationGroupDesc)
-
-