javax.rmi
類別 PortableRemoteObject

java.lang.Object
  javax.rmi.PortableRemoteObject

public class PortableRemoteObject
extends Object

伺服器實作對象可以從 javax.rmi.PortableRemoteObject 繼承，也可以實作一個遠端介面，然後使用 exportObject 方法將其本身註冊為伺服器物件。toStub 方法採用伺服器實作，並返回一個可用於存取該伺服器物件的 stub。連接方法使 Remote 物件準備好進行遠端通信。unexportObject 方法用於註銷伺服器物件，使之可用於垃圾回收。narrow 方法採用一個物件參考或抽象介面型別，並嘗試使其變窄以適合給定的介面。如果該操作成功，結果將是一個指定型別的物件，否則將拋出一個異常。

建構子摘要

protected

PortableRemoteObject() 通過調用 exportObject(this) 初始化該物件。

方法摘要

static void	connect(Remote target, Remote source) 使 Remote 物件準備好進行遠端通信。
static void	exportObject(Remote obj) 準備伺服器物件，以接收遠端調用。
static Object	narrow(Object narrowFrom, Class narrowTo) 檢查以確保遠端或抽象介面型別的物件可以強制轉換為所需的型別。
static Remote	toStub(Remote obj) 返回給定伺服器物件的 stub。
static void	unexportObject(Remote obj) 從運行時註銷伺服器物件，允許物件用於垃圾回收。

從類別 java.lang.Object 繼承的方法

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

建構子詳細資訊

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

返回給定伺服器物件的 stub。

參數：

obj - 需要 stub 的伺服器物件。必須為 PortableRemoteObject 的一個子類別，或者以前已經是調用 exportObject(java.rmi.Remote) 的目標。

返回：

該物件的最常派生的 stub。

拋出：

NoSuchObjectException - 如果找不到給定伺服器物件的 stub。

unexportObject

public static void unexportObject(Remote obj)
                           throws NoSuchObjectException

從運行時註銷伺服器物件，允許物件用於垃圾回收。

參數：

obj - 要撤消導出的物件。

拋出：

NoSuchObjectException - 如果當前未導出遠端物件。

narrow

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

檢查以確保遠端或抽象介面型別的物件可以強制轉換為所需的型別。

參數：

narrowFrom - 要檢查的物件。

narrowTo - 所需的型別。

返回：

可以強制轉換為所需型別的物件。

拋出：

ClassCastException - 如果 narrowFrom 不能強制轉換為 narrowTo。

connect

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

使 Remote 物件準備好進行遠端通信。在遠端方法調用上，當物件作為一個參數發送或接收時，這通常是隱式發生的，但是在某些情況下，通過進行顯式調用執行此操作較為有用。有關更多資訊，請參閱 Stub#connect 方法。

參數：

target - 要連接的物件。

source - 以前連接的物件。

拋出：

RemoteException - 如果 source 未連接，或者如果 target 已經連接到與 source 不同的 ORB。