compact2, compact3

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 and Description
static int	SYSTEM_PORT 查找激活系统的端口。

方法摘要

Modifier and Type	Method and Description
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和关联描述ActivationSystem ; 该对象不能再通过对象的激活标识被激活。

字段详细信息

SYSTEM_PORT

static final int SYSTEM_PORT

查找激活系统的端口。

另请参见：

Constant Field Values

方法详细信息

registerObject

ActivationID registerObject(ActivationDesc desc)
                     throws ActivationException,
                            UnknownGroupException,
                            RemoteException

registerObject方法用于注册激活描述符desc ，并获得可激活远程对象的激活标识符。 所述ActivationSystem创建ActivationID为描述符，指定的对象（一个激活标识符） desc ，和记录，在稳定的储存，激活描述符及其相关联以供以后使用标识符。 当Activator收到特定标识符的activate请求时，它会查找指定标识符的激活描述符（以前注册），并使用该信息激活该对象。

参数

desc - 对象的激活描述符

结果

可用于激活对象的激活ID

异常

ActivationException - 如果注册失败（例如，数据库更新失败等）。

UnknownGroupException - 如果 desc中提到的组未在此系统中注册

RemoteException - 如果远程调用失败

从以下版本开始：

1.2

unregisterObject

void unregisterObject(ActivationID id)
               throws ActivationException,
                      UnknownObjectException,
                      RemoteException

删除先前使用ActivationSystem注册的激活ID和关联描述ActivationSystem ; 该对象不能再通过对象的激活标识被激活。

参数

id - 对象的激活标识（从上次注册）

异常

ActivationException - 如果注销失败（例如，数据库更新失败等）。

UnknownObjectException - 如果对象未知（未注册）

RemoteException - 如果远程调用失败

从以下版本开始：

1.2

registerGroup

ActivationGroupID registerGroup(ActivationGroupDesc desc)
                         throws ActivationException,
                                RemoteException

注册激活组。 必须向ActivationSystem注册激活组，才能在该组内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)