java.rmi.server
類別 UnicastRemoteObject

java.lang.Object
  java.rmi.server.RemoteObject
      java.rmi.server.RemoteServer
          java.rmi.server.UnicastRemoteObject

所有已實作的介面：

Serializable, Remote

直接已知子類別：

ActivationGroup

public class UnicastRemoteObject
extends RemoteServer

用於導出帶 JRMP 的遠端物件和獲得與該遠端物件通信的 stub。

對於下面的建構子和靜態 exportObject 方法，正在導出的遠端物件的 stub 按以下方式獲得：

• 如果使用 UnicastRemoteObject.exportObject(Remote) 方法導出該遠端物件，則載入 stub 類別（通常使用 rmic 工具從遠端物件的類別預產生）並按以下方式建構 stub 類別的實例。
  • “根類別”按以下情形確定：如果遠端物件的類別直接實作擴展 Remote 的介面，則遠端物件的類別為根類別；否則，根類別為直接實作擴展 Remote 介面的遠端物件類別的最具派生能力的父級類別。
  • 要載入的 stub 類別的名稱通過連接帶有後綴 "_Stub" 的根類別的二進制名稱確定。
  • 按使用根類別的類別載入器的名稱載入 stub 類別。該 stub 類別必須擴展 RemoteStub 並且必須有公共建構子，該建構子有一個屬於型別 RemoteRef 的參數。
  • 最後，用 RemoteRef 建構 stub 類別的實例。
• 如果無法找到適當的 stub 類別，或無法載入 stub 類別，或創建 stub 實例時出現問題，則拋出 StubNotFoundException。

• 對於所有其他導出方式：
  • 如果無法載入遠端物件的 stub 類別（如上所述）或將系統屬性 java.rmi.server.ignoreStubClasses 設置為 "true"（不分大小寫），則用以下屬性建構 Proxy 實例：
    • 代理的實例由遠端物件類別的類別載入器定義。
    • 該代理實作由遠端物件類別實作的所有遠端介面。
    • 代理的調用處理程序是用 RemoteRef 建構的 RemoteObjectInvocationHandler 實例。
    • 如果無法創建代理，則拋出 StubNotFoundException。

  • 否則，將遠端物件的 stub 類別（如上所述）的實例用作 stub。

從以下版本開始：

JDK1.1

另請參見：

序列化表格

欄位摘要

從類別 java.rmi.server.RemoteObject 繼承的欄位

ref

建構子摘要

protected	UnicastRemoteObject() 使用匿名埠號創建並導出一個新 UnicastRemoteObject 物件。
protected	UnicastRemoteObject(int port) 使用提供的特定埠號創建並導出一個新 UnicastRemoteObject 物件。
protected	UnicastRemoteObject(int port, RMIClientSocketFactory csf, RMIServerSocketFactory ssf) 使用提供的特定埠號和Socket處理器創建並導出一個新 UnicastRemoteObject 物件。

方法摘要

Object	clone() 返回與初始物件不同的遠端物件的副本。
static RemoteStub	exportObject(Remote obj) 使用匿名埠號導出遠端物件，以便能夠接收傳入的調用。
static Remote	exportObject(Remote obj, int port) 使用提供的特定埠號導出遠端物件，以便能夠接收傳入的調用。
static Remote	exportObject(Remote obj, int port, RMIClientSocketFactory csf, RMIServerSocketFactory ssf) 使用由給定的Socket處理器指定的傳送方式導出遠端物件，以便能夠接收傳入的調用。
static boolean	unexportObject(Remote obj, boolean force) 從 RMI 運行時移除遠端物件 obj。

從類別 java.rmi.server.RemoteServer 繼承的方法

getClientHost, getLog, setLog

從類別 java.rmi.server.RemoteObject 繼承的方法

equals, getRef, hashCode, toString, toStub

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

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

建構子詳細資訊

UnicastRemoteObject

protected UnicastRemoteObject()
                       throws RemoteException

使用匿名埠號創建並導出一個新 UnicastRemoteObject 物件。

拋出：

RemoteException - 如果導出物件失敗

從以下版本開始：

JDK1.1

UnicastRemoteObject

protected UnicastRemoteObject(int port)
                       throws RemoteException

使用提供的特定埠號創建並導出一個新 UnicastRemoteObject 物件。

參數：

port - 遠端物件在其上接收調用的埠號號（如果 port 為 0，則選擇匿名埠號）

拋出：

RemoteException - 如果導出物件失敗

從以下版本開始：

1.2

UnicastRemoteObject

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

使用提供的特定埠號和Socket處理器創建並導出一個新 UnicastRemoteObject 物件。

參數：

port - 遠端物件在其上接收調用的埠號號（如果 port 為 0，則選擇匿名埠號）

csf - 用於調用遠端物件的客戶端Socket處理器

ssf - 用於接收遠端調用的伺服器端Socket處理器

拋出：

RemoteException - 如果導出物件失敗

從以下版本開始：

1.2

方法詳細資訊

clone

public Object clone()
             throws CloneNotSupportedException

返回與初始物件不同的遠端物件的副本。

覆寫：

類別 Object 中的 clone

返回：

新的遠端物件

拋出：

CloneNotSupportedException - 如果因為 RemoteException 複製失敗。

從以下版本開始：

JDK1.1

另請參見：

Cloneable

exportObject

public static RemoteStub exportObject(Remote obj)
                               throws RemoteException

使用匿名埠號導出遠端物件，以便能夠接收傳入的調用。

參數：

obj - 要導出的遠端物件

返回：

遠端物件的 stub

拋出：

RemoteException - 如果導出失敗

從以下版本開始：

JDK1.1

exportObject

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

使用提供的特定埠號導出遠端物件，以便能夠接收傳入的調用。

參數：

obj - 要導出的遠端物件

port - 要在其上導出物件的埠號

返回：

遠端物件的 stub

拋出：

RemoteException - 如果導出失敗

從以下版本開始：

1.2

exportObject

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

使用由給定的Socket處理器指定的傳送方式導出遠端物件，以便能夠接收傳入的調用。

參數：

obj - 要導出的遠端物件

port - 在其上導出物件的埠號

csf - 用於調用遠端物件的客戶端Socket處理器

ssf - 用於接收遠端調用的伺服器端Socket處理器

返回：

遠端物件的 stub

拋出：

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