当前页面: 在线文档首页 > JavaTM 2 Platform Standard Edition 5.0 API 规范中文版
java.rmi.activation
提交错误或意见
有关更多的 API 参考资料和开发人员文档，请参阅 Java 2 SDK SE 开发人员文档。该文档包含更详细的、面向开发人员的描述，以及总体概述、术语定义、使用技巧和工作代码示例。
ActivationSystem (Java 2 Platform SE 5.0) - JavaTM 2 Platform Standard Edition 5.0 API 规范中文版
|
JavaTM 2 Platform Standard Ed. 5.0 |
|||||||||
| 上一个类 下一个类 | 框架 无框架 | |||||||||
| 摘要： 嵌套 | 字段 | 构造方法 | 方法 | 详细信息： 字段 | 构造方法 | 方法 | |||||||||
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)
setActivationGroupDesc
ActivationGroupDesc setActivationGroupDesc(ActivationGroupID id, ActivationGroupDesc desc) throws ActivationException, UnknownGroupException, RemoteException
- 为具有激活组标识符
id的对象设置激活组描述符desc。此更改将在该组的后续激活中生效。- 参数：
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)
|
JavaTM 2 Platform Standard Ed. 5.0 |
|||||||||
| 上一个类 下一个类 | 框架 无框架 | |||||||||
| 摘要： 嵌套 | 字段 | 构造方法 | 方法 | 详细信息： 字段 | 构造方法 | 方法 | |||||||||
提交错误或意见
有关更多的 API 参考资料和开发人员文档，请参阅 Java 2 SDK SE 开发人员文档。该文档包含更详细的、面向开发人员的描述，以及总体概述、术语定义、使用技巧和工作代码示例。
版权所有 2004 Sun Microsystems, Inc. 保留所有权利。 请遵守许可证条款。另请参阅文档重新分发政策。