compact2, compact3

java.rmi.activation

Class Activatable

java.lang.Object

java.rmi.server.RemoteObject

java.rmi.server.RemoteServer

java.rmi.activation.Activatable

All Implemented Interfaces:

Serializable， Remote

public abstract class Activatable
extends RemoteServer

的 Activatable类提供了远程对象，需要持久的存取时间，可以通过激活支持系统。

对于构造函数和静态exportObject方法，为远程对象的存根出口得到了UnicastRemoteObject。

试图将明确该类的实例将失败。

从以下版本开始：

一点二

Field Summary

Fields inherited from class java.rmi.server.RemoteObject

ref

构造方法摘要

构造方法

Modifier	Constructor and Description
protected	Activatable(ActivationID id, int port) 用于在指定的端口上激活/导出对象的构造函数。
protected	Activatable(ActivationID id, int port, RMIClientSocketFactory csf, RMIServerSocketFactory ssf) 用于在指定的端口上激活/导出对象的构造函数。
protected	Activatable(String location, MarshalledObject<?> data, boolean restart, int port) 通过注册激活描述符构建一个激活的远程对象（与指定的位置数据，并重新启动模式）为研究对象，并指定端口输出对象。
protected	Activatable(String location, MarshalledObject<?> data, boolean restart, int port, RMIClientSocketFactory csf, RMIServerSocketFactory ssf) 通过注册激活描述符构建一个激活的远程对象（与指定的位置数据，并重新启动模式）为研究对象，并指定端口输出对象，并指定客户机和服务器套接字工厂。

方法摘要

Modifier and Type	Method and Description
static Remote	exportObject(Remote obj, ActivationID id, int port) 出口可激活远程对象的RMI运行时使对象可以接收来电。
static Remote	exportObject(Remote obj, ActivationID id, int port, RMIClientSocketFactory csf, RMIServerSocketFactory ssf) 出口可激活远程对象的RMI运行时使对象可以接收来电。
static ActivationID	exportObject(Remote obj, String location, MarshalledObject<?> data, boolean restart, int port) 为指定的对象注册一个激活描述符（具有指定的位置、数据和重新启动模式），并用指定的端口输出对象。
static ActivationID	exportObject(Remote obj, String location, MarshalledObject<?> data, boolean restart, int port, RMIClientSocketFactory csf, RMIServerSocketFactory ssf) 为指定的对象注册一个激活描述符（具有指定的位置、数据和重新启动模式），并用指定的端口和指定的客户端和服务器套接字工厂输出对象。
protected ActivationID	getID() 返回对象的激活标识符。
static boolean	inactive(ActivationID id) 通知与相应的活化 id对象激活系统。
static Remote	register(ActivationDesc desc) 登记一个激活远程对象，一个对象描述符可以启动需求。
static boolean	unexportObject(Remote obj, boolean force) 删除远程对象，对象，从RMI运行时。
static void	unregister(ActivationID id) 撤销与 id激活描述符之前的注册。

Methods inherited from class java.rmi.server.RemoteServer

getClientHost, getLog, setLog

Methods inherited from class java.rmi.server.RemoteObject

equals, getRef, hashCode, toString, toStub

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Constructor Detail

Activatable

protected Activatable(String location,
                      MarshalledObject<?> data,
                      boolean restart,
                      int port)
               throws ActivationException,
                      RemoteException

通过注册激活描述符构建一个激活的远程对象（与指定的位置数据，并重新启动模式）为研究对象，并指定端口输出对象。

注：使用Activatable构造函数，登记和出口可激活远程对象的强烈劝阻因为注册和出口远程对象的行为是不保证是原子。相反，应用程序应该注册一个激活描述符并分别导出一个远程对象，以便异常能够被正确处理。

此方法调用exportObject方法与该对象，并指定位置，数据，启动模式，和端口。随后调用getID()将激活标识符返回调用exportObject。

参数

location的位置为该对象类

data -对象的初始化数据

port -端口上的对象是出口（匿名端口，如果端口= 0）

restart -如果是真的，目的是重新启动（激活）时激活重新启动或对象的激活组是一个意外的崩溃后重新启动；如果为假，对象只是启动需求。指定要 true不强迫一个新注册的对象的初始直接激活 restart；初始激活懒惰。

异常

ActivationException如果对象注册失败。

RemoteException如果下列失败：a）与激活系统或B注册对象）到RMI运行时输出对象。

UnsupportedOperationException -当且仅当激活是不被实施的支持。

从以下版本开始：

一点二

Activatable

protected Activatable(String location,
                      MarshalledObject<?> data,
                      boolean restart,
                      int port,
                      RMIClientSocketFactory csf,
                      RMIServerSocketFactory ssf)
               throws ActivationException,
                      RemoteException

通过注册激活描述符构建一个激活的远程对象（与指定的位置数据，并重新启动模式）为研究对象，并指定端口输出对象，并指定客户机和服务器套接字工厂。

注：使用Activatable构造函数，登记和出口可激活远程对象的强烈劝阻因为注册和出口远程对象的行为是不保证是原子。相反，应用程序应该注册一个激活描述符并分别导出一个远程对象，以便异常能够被正确处理。

此方法调用exportObject方法与该对象，并指定位置，数据，启动模式，港口，和客户机和服务器套接字工厂。随后调用getID()将激活标识符返回调用exportObject。

参数

location的位置为该对象类

data -对象的初始化数据

restart -如果是真的，目的是重新启动（激活）时激活重新启动或对象的激活组是一个意外的崩溃后重新启动；如果为假，对象只是启动需求。指定要 true不强迫一个新注册的对象的初始直接激活 restart；初始激活懒惰。

port -端口上的对象是出口（匿名端口，如果端口= 0）

csf -调用远程对象的客户端套接字工厂

ssf -接收远程调用服务器端套接字工厂

异常

ActivationException如果对象注册失败。

RemoteException如果下列失败：a）与激活系统或B注册对象）到RMI运行时输出对象。

UnsupportedOperationException -当且仅当激活是不被实施的支持。

从以下版本开始：

一点二

Activatable

protected Activatable(ActivationID id,
                      int port)
               throws RemoteException

用于在指定的端口上激活/导出对象的构造函数。“激活”远程对象必须有一个构造函数接受两个参数：

• 对象标识符（ActivationID），并激活
• 对象的初始化数据（一个MarshalledObject）。

这个类的一个具体子类必须调用此构造函数时，激活通过上述两个参数的构造函数。作为一个副作用的建设，远程对象是“出口”到RMI运行时（在指定的port）和可接受的客户来电。

参数

id为激活对象标识符

port -上的对象是输出端口号

异常

RemoteException如果RMI运行时输出对象失败

UnsupportedOperationException -当且仅当激活是不被实施的支持

从以下版本开始：

一点二

Activatable

protected Activatable(ActivationID id,
                      int port,
                      RMIClientSocketFactory csf,
                      RMIServerSocketFactory ssf)
               throws RemoteException

用于在指定的端口上激活/导出对象的构造函数。“激活”远程对象必须有一个构造函数接受两个参数：

• 对象标识符（ActivationID），并激活
• 对象的初始化数据（一个MarshalledObject）。

这个类的一个具体子类必须调用此构造函数时，激活通过上述两个参数的构造函数。作为一个副作用的建设，远程对象是“出口”到RMI运行时（在指定的port）和可接受的客户来电。

参数

id为激活对象标识符

port -上的对象是输出端口号

csf -调用远程对象的客户端套接字工厂

ssf -接收远程调用服务器端套接字工厂

异常

RemoteException如果RMI运行时输出对象失败

UnsupportedOperationException -当且仅当激活是不被实施的支持

从以下版本开始：

一点二

方法详细信息

getID

protected ActivationID getID()

返回对象的激活标识符。该方法被保护，以便只有子类可以获得对象的标识符。

结果

对象的激活标识符

从以下版本开始：

一点二

register

public static Remote register(ActivationDesc desc)
                       throws UnknownGroupException,
                              ActivationException,
                              RemoteException

登记一个激活远程对象，一个对象描述符可以启动需求。

参数

desc -对象的描述符

结果

为激活远程对象的存根

异常

UnknownGroupException -如果 desc组ID不与激活系统注册

ActivationException如果激活系统不运行

RemoteException如果远程调用失败

UnsupportedOperationException -当且仅当激活是不被实施的支持

从以下版本开始：

一点二

inactive

public static boolean inactive(ActivationID id)
                        throws UnknownObjectException,
                               ActivationException,
                               RemoteException

通知与相应的活化 id对象激活系统。如果对象是目前活跃的对象是“导出”从RMI运行时（如果没有挂起的或正在通话）所以它可以不再收到来电。这个电话通知该VM的activationgroup，对象是无效的，这，反过来，通知其activationmonitor。如果调用成功完成，随后的激活请求激活的物体会激活。手术可能仍然如果对象被认为是积极的但已经导出成功。

参数

id -对象的激活标识符

结果

如果操作成功（操作对象是否在目前已知的是主动的，要么是已经导出，或目前出口并没有挂起/执行调用成功）；假如果对象正在/执行调用在这种情况下，它不能被恢复

异常

UnknownObjectException如果对象是不知道（它可能已经无效）

ActivationException如果组不活跃

RemoteException如果电话通知班长失败

UnsupportedOperationException -当且仅当激活是不被实施的支持

从以下版本开始：

一点二

unregister

public static void unregister(ActivationID id)
                       throws UnknownObjectException,
                              ActivationException,
                              RemoteException

撤销与 id激活描述符之前的注册。一个对象可以不再被激活，通过 id。

参数

id -对象的激活标识符

异常

UnknownObjectException如果对象（ id）是未知的

ActivationException如果激活系统不运行

RemoteException如果远程调用激活系统失败

UnsupportedOperationException -当且仅当激活是不被实施的支持

从以下版本开始：

一点二

exportObject

public static ActivationID exportObject(Remote obj,
                                        String location,
                                        MarshalledObject<?> data,
                                        boolean restart,
                                        int port)
                                 throws ActivationException,
                                        RemoteException

为指定的对象注册一个激活描述符（具有指定的位置、数据和重新启动模式），并用指定的端口输出对象。

注：使用这种方法（以及Activatable构造函数，登记和出口可激活远程对象）的强烈劝阻因为注册和出口远程对象的行为是不保证是原子。相反，应用程序应该注册一个激活描述符并分别导出一个远程对象，以便异常能够被正确处理。

此方法调用exportObject方法与指定的对象、地点、数据、启动模式，和端口，并null为客户端和服务器端套接字工厂，然后返回激活标识符。

参数

obj -出口对象

location -对象的代码位置

data -对象的抽样数据

restart -如果是真的，目的是重新启动（激活）时激活重新启动或对象的激活组是一个意外的崩溃后重新启动；如果为假，对象只是启动需求。指定要 true不强迫一个新注册的对象的初始直接激活 restart；初始激活懒惰。

port -端口上的对象是出口（匿名端口，如果端口= 0）

结果

从注册激活标识符描述符，得到 desc，与激活系统错误的组

异常

ActivationException如果激活组不活跃

RemoteException如果对象注册或出口失败

UnsupportedOperationException -当且仅当激活是不被实施的支持

从以下版本开始：

一点二

exportObject

public static ActivationID exportObject(Remote obj,
                                        String location,
                                        MarshalledObject<?> data,
                                        boolean restart,
                                        int port,
                                        RMIClientSocketFactory csf,
                                        RMIServerSocketFactory ssf)
                                 throws ActivationException,
                                        RemoteException

为指定的对象注册一个激活描述符（具有指定的位置、数据和重新启动模式），并用指定的端口和指定的客户端和服务器套接字工厂输出对象。

注：使用这种方法（以及Activatable构造函数，登记和出口可激活远程对象）的强烈劝阻因为注册和出口远程对象的行为是不保证是原子。相反，应用程序应该注册一个激活描述符并分别导出一个远程对象，以便异常能够被正确处理。

此方法首先为指定的对象注册一个激活描述符如下。获得激活系统通过调用方法ActivationGroup.getSystem。这种方法得到的对象ActivationID通过调用激活系统的registerObject方法与ActivationDesc与指定对象的类的名字了，和指定位置，数据，并重新启动模式。如果一个异常发生在获取激活系统或注册激活描述符，则向调用方抛出异常。

其次，该方法的出口对象通过调用exportObject方法与指定的远程对象，获得注册标识符的激活，指定端口，和指定的客户机和服务器套接字工厂。如果出现异常的出口对象，注销该方法尝试激活标识符（从注册）通过调用激活系统的unregisterObject方法与激活标识符。如果出现异常注销的标识符，该异常是不容忽视的，和发生的出口对象原来的异常抛给调用者。

最后，该方法调用和激活标识和指定的远程对象的激活在VM组activeObject方法，并返回给调用者的标识激活。

参数

obj -出口对象

location -对象的代码位置

data -对象的抽样数据

restart -如果是真的，目的是重新启动（激活）时激活重新启动或对象的激活组是一个意外的崩溃后重新启动；如果为假，对象只是启动需求。指定要 true不强迫一个新注册的对象的初始直接激活 restart；初始激活懒惰。

port -端口上的对象是出口（匿名端口，如果端口= 0）

csf -调用远程对象的客户端套接字工厂

ssf -接收远程调用服务器端套接字工厂

结果

从激活系统注册描述符所获得的激活标识符

异常

ActivationException如果激活组不活跃

RemoteException如果对象注册或出口失败

UnsupportedOperationException -当且仅当激活是不被实施的支持

从以下版本开始：

一点二

exportObject

public static Remote exportObject(Remote obj,
                                  ActivationID id,
                                  int port)
                           throws RemoteException

出口可激活远程对象的RMI运行时使对象可以接收来电。对象是一个匿名的港口出口，如果 port是零。

在激活过程中，这exportObject法应明确由一个“激活”对象调用，不延长Activatable类。没有必要那样做延长Activatable类直接调用这个方法的对象是因为出口在施工对象。

参数

obj -远程对象的实现

id -对象的激活标识符

port -端口上的对象是出口（匿名端口，如果端口= 0）

结果

为激活远程对象的存根

异常

RemoteException如果出口对象失败

UnsupportedOperationException -当且仅当激活是不被实施的支持

从以下版本开始：

一点二

exportObject

public static Remote exportObject(Remote obj,
                                  ActivationID id,
                                  int port,
                                  RMIClientSocketFactory csf,
                                  RMIServerSocketFactory ssf)
                           throws RemoteException

出口可激活远程对象的RMI运行时使对象可以接收来电。对象是一个匿名的港口出口，如果 port是零。

在激活过程中，这exportObject法应明确由一个“激活”对象调用，不延长Activatable类。没有必要那样做延长Activatable类直接调用这个方法的对象是因为出口在施工对象。

参数

obj -远程对象的实现

id -对象的激活标识符

port -端口上的对象是出口（匿名端口，如果端口= 0）

csf -调用远程对象的客户端套接字工厂

ssf -接收远程调用服务器端套接字工厂

结果

为激活远程对象的存根

异常

RemoteException如果出口对象失败

UnsupportedOperationException -当且仅当激活是不被实施的支持

从以下版本开始：

一点二

unexportObject

public static boolean unexportObject(Remote obj,
                                     boolean force)
                              throws NoSuchObjectException

删除远程对象，对象，从RMI运行时。如果成功，该对象可以不再接受传入的RMI调用。如果力参数为TRUE，对象是强行导出，即使有挂起调用远程对象的远程对象调用或仍有进展。如果力参数为FALSE，对象只是导出，如果没有待定或进程调用对象。

参数

obj -被导出，远程对象

force -如果是真的，unexports对象即使有未决或进行调用；如果为假，只有unexports对象如果没有待定或进行电话

结果

如果操作成功，则为假

异常

NoSuchObjectException -如果远程对象目前不出口

UnsupportedOperationException -当且仅当激活是不被实施的支持

从以下版本开始：

一点二