java.rmi.activation

接口
异常
所有超级接口:
Remote

public interface ActivationSystem
     
extends Remote

ActivationSystem 为注册组和在那些组中要被激活的“可激活”对象提供一种方式。ActivationSystemActivator 紧密协作,通过 ActivationSystemActivationMonitor 来激活注册的对象,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)
          为具有激活标识符 id 的对象设置激活描述符 desc
 ActivationGroupDesc setActivationGroupDesc(ActivationGroupID id, ActivationGroupDesc desc)
          为具有激活组标识符 id 的对象设置激活组描述符 desc
 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,或者该组与指定组 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)

setActivationGroupDesc

ActivationGroupDesc setActivationGroupDesc(ActivationGroupID id,
                                           ActivationGroupDesc desc)
                                           throws ActivationException,
                                                  UnknownGroupException,
                                                  RemoteException
为具有激活组标识符 id 的对象设置激活组描述符 desc。此更改将在该组的后续激活中生效。

参数:
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)