javax.rmi

Class PortableRemoteObject

java.lang.Object

javax.rmi.PortableRemoteObject

public class PortableRemoteObject
extends Object

服务器实现的对象可以继承javax.rmi.portableremoteobject也可以实现一个远程接口，然后使用exportobject法登记本身作为一个服务器对象。该方法以实现tostub服务器返回一个存根，可用于访问服务器对象。该连接方法使远程对象准备远程通信。的unexportobject方法用于注销服务器对象，使其成为可用于垃圾收集。窄的方法需要一个对象引用或抽象的接口类型，并试图缩小它，以符合给定的接口。如果操作成功，结果将是指定类型的对象，否则将引发异常。

构造方法摘要

构造方法

Modifier	Constructor and Description
protected	PortableRemoteObject() 初始化对象通过调用 exportObject(this)。

方法摘要

Modifier and Type	Method and Description
static void	connect(Remote target, Remote source) 使远程对象准备远程通信。
static void	exportObject(Remote obj) 使一个服务器对象准备好接收远程调用。
static Object	narrow(Object narrowFrom, 类 narrowTo) 检查以确保远程或抽象接口类型的对象可以被转换为所需类型。
static Remote	toStub(Remote obj) 返回给定服务器对象的存根。
static void	unexportObject(Remote obj) 撤销从运行一个服务器对象，使该对象就会被垃圾回收。

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

PortableRemoteObject

protected PortableRemoteObject()
                        throws RemoteException

初始化对象通过调用 exportObject(this)。

异常

如果出口不 RemoteException。

方法详细信息

exportObject

public static void exportObject(Remote obj)
                         throws RemoteException

使一个服务器对象准备好接收远程调用。注意，子portableremoteobject不需要调用这个方法，因为它是所谓的构造函数。

参数

obj -服务器对象的出口。

异常

如果出口不 RemoteException。

toStub

public static Remote toStub(Remote obj)
                     throws NoSuchObjectException

返回给定服务器对象的存根。

参数

obj -服务器对象的存根是必需的。必须是类portableremoteobject或先前已被一个叫 exportObject(java.rmi.Remote)目标。

结果

用于对象的最派生的存根。

异常

NoSuchObjectException如果存根不能位于给定的服务器对象。

unexportObject

public static void unexportObject(Remote obj)
                           throws NoSuchObjectException

撤销从运行一个服务器对象，使该对象就会被垃圾回收。

参数

obj -可以不导出对象。

异常

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

narrow

public static Object narrow(Object narrowFrom,
                            类 narrowTo)
                     throws ClassCastException

检查以确保远程或抽象接口类型的对象可以被转换为所需类型。

参数

narrowFrom -检查对象。

narrowTo -所需类型。

结果

一个可以被转换为所需类型的对象。

异常

ClassCastException -如果narrowfrom不能抛去narrowto。

connect

public static void connect(Remote target,
                           Remote source)
                    throws RemoteException

使远程对象准备远程通信。通常情况下，当对象被发送或接收到远程方法调用的参数时，会隐式发生，但在某些情况下，通过调用一个显式调用来执行此操作是非常有用的。更多信息见 Stub.connect(org.omg.CORBA.ORB)方法。

参数

target -连接对象。

source -先前连接的对象。

异常

RemoteException -如果 source未连接或如果 target已经连接到一个不同的球比 source。