compact2, compact3

java.rmi.activation

Interface ActivationSystem

All Superinterfaces:

Remote

public interface ActivationSystem
extends Remote

的 ActivationSystem注册组和“活化”的对象是人群中的活性提供了一种手段。的 ActivationSystem密切配合 Activator，激活注册通过 ActivationSystem对象，和 ActivationMonitor，得到有效和无效的对象的信息，和非活动组。

从以下版本开始：

一点二

另请参见：

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) 将激活ID和相关的描述符以前注册的 ActivationSystem；对象不再能通过激活对象的激活ID。

Field Detail

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 -对象的激活描述符

结果

可以用来激活对象的激活标识

异常

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

UnknownGroupException如果集团称在 desc不注册系统

RemoteException如果远程调用失败

从以下版本开始：

一点二

unregisterObject

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

将激活ID和相关的描述符以前注册的 ActivationSystem；对象不再能通过激活对象的激活ID。

参数

id -对象的激活ID（从以前的登记）

异常

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

UnknownObjectException如果对象是未知的（未注册）

RemoteException如果远程调用失败

从以下版本开始：

一点二

registerGroup

ActivationGroupID registerGroup(ActivationGroupDesc desc)
                         throws ActivationException,
                                RemoteException

注册激活组。激活组必须登记前的 ActivationSystem对象可以在组内注册。

参数

desc -组的描述符

结果

本组的标识符

异常

ActivationException如果集团注册失败

RemoteException如果远程调用失败

从以下版本开始：

一点二

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如果远程调用失败

从以下版本开始：

一点二

unregisterGroup

void unregisterGroup(ActivationGroupID id)
              throws ActivationException,
                     UnknownGroupException,
                     RemoteException

移除激活组。激活组将此回调通知激活组，该激活组应被删除（销毁）。如果此调用成功完成，对象将不能在组内注册或激活。本组和相关对象的所有信息都从系统中删除。

参数

id -活化组的标识符

异常

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

UnknownGroupException如果集团没有注册

RemoteException如果远程调用失败

从以下版本开始：

一点二

shutdown

void shutdown()
       throws RemoteException

关闭激活系统。摧毁所有组由激活守护进程催生并退出激活程序。

异常

RemoteException如果未能联系/关机激活程序

从以下版本开始：

一点二

setActivationDesc

ActivationDesc setActivationDesc(ActivationID id,
                                 ActivationDesc desc)
                          throws ActivationException,
                                 UnknownObjectException,
                                 UnknownGroupException,
                                 RemoteException

设置激活描述符， desc与激活的对象标识符， id。改变将在对象激活后生效。

参数

id -激活的对象标识符的活化

desc为激活对象激活描述符

结果

激活描述符的前一个值

异常

UnknownGroupException -组与 desc不是注册组

UnknownObjectException -活化 id没有注册

ActivationException -一般故障（例如，无法更新日志）

RemoteException如果远程调用失败

从以下版本开始：

一点二

另请参见：

getActivationDesc(java.rmi.activation.ActivationID)

setActivationGroupDesc

ActivationGroupDesc setActivationGroupDesc(ActivationGroupID id,
                                           ActivationGroupDesc desc)
                                    throws ActivationException,
                                           UnknownGroupException,
                                           RemoteException

设置激活组描述符，与活化组标识符， id对象 desc。变化将对集团随后激活生效。

参数

id -活化组标识符为活化组

desc -活化组活化组描述符

结果

激活组描述符的前值

异常

UnknownGroupException -与 id组并非注册组

ActivationException -一般故障（例如，无法更新日志）

RemoteException如果远程调用失败

从以下版本开始：

一点二

另请参见：

getActivationGroupDesc(java.rmi.activation.ActivationGroupID)

getActivationDesc

ActivationDesc getActivationDesc(ActivationID id)
                          throws ActivationException,
                                 UnknownObjectException,
                                 RemoteException

返回激活描述符，与激活的对象标识符， id。

参数

id -激活的对象标识符的活化

结果

活化的描述符

异常

UnknownObjectException -如果 id没有注册

一般故障 ActivationException -

RemoteException如果远程调用失败

从以下版本开始：

一点二

另请参见：

setActivationDesc(java.rmi.activation.ActivationID, java.rmi.activation.ActivationDesc)

getActivationGroupDesc

ActivationGroupDesc getActivationGroupDesc(ActivationGroupID id)
                                    throws ActivationException,
                                           UnknownGroupException,
                                           RemoteException

返回激活组描述符，与活化组标识符的组， id。

参数

id -活化组的组标识符

结果

激活组描述符

异常

UnknownGroupException -如果 id没有注册

ActivationException -一般故障

RemoteException如果远程调用失败

从以下版本开始：

一点二

另请参见：

setActivationGroupDesc(java.rmi.activation.ActivationGroupID, java.rmi.activation.ActivationGroupDesc)