compact2, compact3

java.rmi.server

Class UnicastRemoteObject

java.lang.Object

java.rmi.server.RemoteObject

java.rmi.server.RemoteServer

java.rmi.server.UnicastRemoteObject

All Implemented Interfaces:

Serializable ， Remote

已知直接子类：

ActivationGroup

public class UnicastRemoteObject
extends RemoteServer

用于使用JRMP导出远程对象并获取与远程对象通信的存根。 存根是使用动态代理对象在运行时生成的，或者它们在构建时静态生成，通常使用rmic工具。

已弃用：静态存根。 支持静态生成的存根已被弃用。 这包括此类中需要使用静态存根的API，以及加载静态存根的运行时支持。 动态生成存根是首选的，使用以下列出的五种不推荐使用的导出对象的方式之一。 不要运行rmic来生成静态存根类。 这是不必要的，也是不推荐的。

导出远程对象有六种方式：

1. 分类UnicastRemoteObject并调用UnicastRemoteObject()构造函数。
2. 分类UnicastRemoteObject并调用UnicastRemoteObject(port)构造函数。
3. 分类UnicastRemoteObject并调用UnicastRemoteObject(port, csf, ssf)构造函数。
4. 调用exportObject(Remote)方法。 已弃用
5. 拨打exportObject(Remote, port)方法。
6. 调用exportObject(Remote, port, csf, ssf)方法。

第四种技术， exportObject(Remote) ，始终使用静态生成的存根，不推荐使用。

其他五种技术都使用以下方法：如果java.rmi.server.ignoreStubClasses属性为true （不区分大小写），或者如果无法找到静态存根，则使用Proxy对象动态生成存根。 否则，使用静态存根。

java.rmi.server.ignoreStubClasses属性的默认值为false 。

静态生成的存根通常使用rmic工具从远程对象的类rmic 。 加载一个静态存根，并且如下所述构造该存根类的一个实例。

• “根类”的确定如下：如果远程对象的类直接实现了扩展Remote的接口 ，则远程对象的类是根类; 否则，根类是远程对象的类的最多派生超类，它直接实现扩展Remote 。
• 要加载的存根类的名称是通过将根类的二进制名称与后缀_Stub 。
• 存根类使用根类的类加载器由名称加载。 存根类必须扩展为RemoteStub ，并且必须具有一个参数类型为RemoteRef的公共构造函数 。
• 最后，stub类的一个实例用RemoteRef构造 。
• 如果无法找到适当的stub类，或者无法加载存根类，或者如果创建存根实例时出现问题，则抛出StubNotFoundException 。

通过构造具有以下特征的Proxy的实例来动态生成存根：

• 代理的类由远程对象的类的类加载器定义。
• 代理实现远程对象的类实现的所有远程接口。
• 代理的调用处理程序是RemoteObjectInvocationHandler用构建的实例RemoteRef 。
• 如果无法创建代理，将抛出StubNotFoundException 。

Implementation Note:

根据使用哪种构造函数或静态方法导出对象，可以使用RMISocketFactory创建套接字。 默认情况下， RMISocketFactory创建的服务器套接字在所有网络接口上侦听。 请参阅RMISocketFactory课程和88428053399331中的RMI Socket Factories课程 。

从以下版本开始：

JDK1.1

另请参见：

Serialized Form

Field Summary

Fields inherited from class java.rmi.server.RemoteObject

ref

构造方法摘要

构造方法

Modifier	Constructor and Description
protected	UnicastRemoteObject() 使用匿名端口创建并导出新的UnicastRemoteObject对象。
protected	UnicastRemoteObject(int port) 使用特定提供的端口创建并导出新的UnicastRemoteObject对象。
protected	UnicastRemoteObject(int port, RMIClientSocketFactory csf, RMIServerSocketFactory ssf) 使用特定提供的端口和套接字工厂创建并导出新的UnicastRemoteObject对象。

方法摘要

Modifier and Type	Method and Description
Object	clone() 返回与原始对象不同的远程对象的克隆。
static RemoteStub	exportObject(Remote obj) 已弃用 此方法已被弃用，因为它仅支持静态存根。 改用exportObject(Remote, port)或exportObject(Remote, port, csf, ssf) 。
static Remote	exportObject(Remote obj, int port) 使用特定提供的端口导出远程对象以使其可用于接收来电。
static Remote	exportObject(Remote obj, int port, RMIClientSocketFactory csf, RMIServerSocketFactory ssf) 使用给定套接字工厂指定的传输导出远程对象以使其可用于接收来电。
static boolean	unexportObject(Remote obj, boolean force) 从RMI运行时中删除远程对象obj。

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

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

构造方法详细信息

UnicastRemoteObject

protected UnicastRemoteObject()
                       throws RemoteException

使用匿名端口创建并导出新的UnicastRemoteObject对象。

导出的对象与使用RMISocketFactory类创建的服务器套接字。

异常

RemoteException - 如果导出对象失败

从以下版本开始：

JDK1.1

UnicastRemoteObject

protected UnicastRemoteObject(int port)
                       throws RemoteException

使用特定提供的端口创建并导出新的UnicastRemoteObject对象。

导出的对象与使用RMISocketFactory类创建的服务器套接字。

参数

port - 远程对象接收呼叫的端口号（如果 port为零，则选择一个匿名端口）

异常

RemoteException - 如果无法导出对象

从以下版本开始：

1.2

UnicastRemoteObject

protected UnicastRemoteObject(int port,
                              RMIClientSocketFactory csf,
                              RMIServerSocketFactory ssf)
                       throws RemoteException

使用特定提供的端口和套接字工厂创建并导出新的UnicastRemoteObject对象。

插座工厂可能是null ，在这种情况下，使用相应的客户端或服务器套接字创建方法RMISocketFactory 。

参数

port - 远程对象接收呼叫的端口号（如果 port为零，则选择匿名端口）

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

ssf - 用于接收远程呼叫的服务器端套接字工厂

异常

RemoteException - 如果无法导出对象

从以下版本开始：

1.2

方法详细信息

clone

public Object clone()
             throws CloneNotSupportedException

返回与原始对象不同的远程对象的克隆。

重写：

clone在类别 Object

结果

新的远程对象

异常

CloneNotSupportedException - 如果由于RemoteException导致克隆失败。

从以下版本开始：

JDK1.1

另请参见：

Cloneable

exportObject

@Deprecated
public static RemoteStub exportObject(Remote obj)
                                           throws RemoteException

已弃用 此方法已被弃用，因为它仅支持静态存根。 改用exportObject(Remote, port)或exportObject(Remote, port, csf, ssf) 。

导出远程对象使其可用于使用匿名端口接收来电。 此方法将始终返回静态生成的存根。

导出的对象与使用RMISocketFactory类创建的服务器套接字。

参数

obj - 要导出的远程对象

结果

远程对象存根

异常

RemoteException - 如果导出失败

从以下版本开始：

JDK1.1

exportObject

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

使用特定提供的端口导出远程对象以使其可用于接收来电。

导出的对象与使用RMISocketFactory类创建的服务器套接字。

参数

obj - 要导出的远程对象

port - 导出对象的端口

结果

远程对象存根

异常

RemoteException - 如果导出失败

从以下版本开始：

1.2

exportObject

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

使用给定套接字工厂指定的传输导出远程对象以使其可用于接收来电。

插座工厂可能是null ，在这种情况下，使用相应的客户端或服务器套接字创建方法RMISocketFactory 。

参数

obj - 要导出的远程对象

port - 导出对象的端口

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

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

结果

远程对象存根

异常

RemoteException - 如果导出失败

从以下版本开始：

1.2

unexportObject

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

从RMI运行时中删除远程对象obj。 如果成功，对象不能再接受传入的RMI调用。 如果force参数为true，即使有远程对象的挂起调用或远程对象仍在进行调用，该对象也被强制取消导出。 如果force参数为false，则只有当对象没有待处理或正在进行调用时，对象才会取消导出。

参数

obj - 要取消导出的远程对象

force - 如果为true，即使有待处理或正在进行的调用，也会取消运行对象; 如果为false，则只有在没有待处理或正在进行的调用时，才会取消对象的输出

结果

如果操作成功，则为true，否则为false

异常

NoSuchObjectException - 如果远程对象当前未导出

从以下版本开始：

1.2