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工具。加载一个静态存根，并构造一个存根类的实例如下所述。

• “根类”决定如下：如果远程对象的类实现一个接口直接延伸Remote，然后远程对象的类是根类；否则，根类派生的类是最该远程对象的类实现一个接口直接延伸Remote。
• 要加载的存根类的名字将与后缀_Stub根类的二进制名称确定。
• 存根类使用根类的类装载器加载。存根类必须扩展RemoteStub，必须有一个具有一个参数的公共构造函数RemoteRef型。
• 最后，该存根类的一个实例是一个RemoteRef构造。
• 如果适当的存根类不能被发现，或者如果存根类无法加载，或发生问题时创建存根实例，一个StubNotFoundException抛出。

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

• 代理的类是由远程对象类的类装载器定义的。
• 代理实现了远程对象类实现的所有远程接口。
• 代理的调用处理程序是一个RemoteObjectInvocationHandler实例与RemoteRef构造。
• 如果代理不能被创建，一个StubNotFoundException将抛出。

Implementation Note:

这取决于构造函数或静态方法用于输出一个对象， RMISocketFactory可用于创建套接字。默认情况下，服务器套接字创建 RMISocketFactory监听所有网络接口。看到 RMISocketFactory类在 Java RMI Specification截面 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运行时。

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

Constructor Detail

UnicastRemoteObject

protected UnicastRemoteObject()
                       throws RemoteException

制造和出口的一个新unicastremoteobject对象使用匿名端口。

对象是一个服务器端的套接字出口使用RMISocketFactory类创建。

异常

RemoteException -如果没有出口对象

从以下版本开始：

JDK1.1

UnicastRemoteObject

protected UnicastRemoteObject(int port)
                       throws RemoteException

制造和出口的一个新unicastremoteobject对象使用特别提供的端口。

对象是一个服务器端的套接字出口使用RMISocketFactory类创建。

参数

port -端口号上的远程对象接收电话（如果 port是零，一个匿名的端口选择）

异常

RemoteException -如果没有出口对象

从以下版本开始：

一点二

UnicastRemoteObject

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

制造和出口的一个新unicastremoteobject对象使用特定端口和套接字工厂提供。

也可以null插座厂，在这种情况下，相应的客户端或服务器套接字的创建方法RMISocketFactory代替。

参数

port -端口号上的远程对象接收电话（如果 port是零，一个匿名的端口选择）

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

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

异常

RemoteException -如果没有出口对象

从以下版本开始：

一点二

方法详细信息

clone

public Object clone()
             throws CloneNotSupportedException

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

重写：

clone 方法重写，继承类 Object

结果

新的远程对象

异常

CloneNotSupportedException如果由于一个异常克隆失败。

从以下版本开始：

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

从以下版本开始：

一点二

exportObject

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

输出远程对象，使其可接收到传入的调用，使用指定的套接字工厂指定的传输。

也可以null插座厂，在这种情况下，相应的客户端或服务器套接字的创建方法RMISocketFactory代替。

参数

obj -出口远程对象

port -出口对象的端口

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

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

结果

远程对象的存根

异常

如果出口不 RemoteException

从以下版本开始：

一点二

unexportObject

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

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

参数

obj -被导出，远程对象

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

结果

如果操作成功，则为假

异常

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

从以下版本开始：

一点二