模块 java.rmi

软件包 java.rmi.activation

Interface ActivationSystem

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)