ActivationSystem - [ Java参考文档 ] - 在线原生手册

目录搜索

文字

概述

软件包

类

使用

树

已过时

索引

帮助

Java^TM 2 Platform
Standard Ed. 6

上一个类 下一个类

框架 无框架

摘要：嵌套 | 字段 | 构造方法 | 方法

详细信息：字段 | 构造方法 | 方法

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)

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)

概述

软件包

类

使用

树

已过时

索引

帮助

Java^TM 2 Platform
Standard Ed. 6

上一个类 下一个类

框架 无框架

摘要：嵌套 | 字段 | 构造方法 | 方法

详细信息：字段 | 构造方法 | 方法

提交错误或意见
有关更多的 API 参考资料和开发人员文档，请参阅 Java 2 SDK SE 开发人员文档。该文档包含更详细的、面向开发人员的描述，以及总体概述、术语定义、使用技巧和工作代码示例。

java.rmi.activation 接口 ActivationSystem

SYSTEM_PORT

registerObject

unregisterObject

registerGroup

activeGroup

unregisterGroup

shutdown

setActivationDesc

setActivationGroupDesc

getActivationDesc

getActivationGroupDesc

java.rmi.activation
接口 ActivationSystem