Java java.rmi.activation 接口 ActivationSystem（JDK5）

所有类

java.rmi.activation
接口 ActivationSystem

所有超级接口：

Remote

public interface ActivationSystem
   
   
   
   
   
extends Remote
   
   
   
   
   

ActivationSystem 为注册组和在那些组中要被激活的“可激活”对象提供一种方式。ActivationSystem 与 Activator 紧密协作，通过 ActivationSystem 和 ActivationMonitor 来激活注册的对象，ActivationMonitor 获取有关活动的和不活动的对象以及不活动组的信息。

从以下版本开始：

1.2

另请参见：

Activator, ActivationMonitor

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)