Module java.rmi

软件包 java.rmi.activation

Interface ActivationSystem

All Superinterfaces:

Remote

public interface ActivationSystem
extends Remote

ActivationSystem提供了一种注册组和“激活”对象在这些组内被激活的方法。 所述ActivationSystem与密切合作Activator ，其激活经由注册的对象ActivationSystem和ActivationMonitor ，其获取关于活动和非活动的对象，和不活动组的信息。

从以下版本开始：

1.2

另请参见：

Activator ， ActivationMonitor

Field Summary

Fields

Modifier and Type	Field	描述
static int	SYSTEM_PORT	查找激活系统的端口。

方法摘要

Modifier and Type	方法	描述
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 ; 该对象不能再通过对象的激活标识被激活。

字段详细信息

SYSTEM_PORT

static final int SYSTEM_PORT

查找激活系统的端口。

另请参见：

Constant Field Values

方法详细信息

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 - 对象的激活标识（从上次注册）

异常

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)