java.rmi
類別 Naming

java.lang.Object
  java.rmi.Naming

public final class Naming
extends Object

Naming 類別提供在物件註冊表中存儲和獲得遠端對遠端物件參考的方法。Naming 類別的每個方法都可將某個名稱作為其一個參數，該名稱是使用以下形式的 URL 格式（沒有 scheme 元件）的 java.lang.String：

    //host:port/name
 

其中 host 是註冊表所在的主機（遠端或本地），port 是註冊表接受調用的埠號號，name 是未經註冊表解釋的簡單字元串。host 和 port 兩者都是可選項。如果省略了 host，則主機預設為本地主機。如果省略了 port，則埠號預設為 1099，該埠號是 RMI 的註冊表 rmiregistry 使用的“著名”埠號。

為遠端物件 綁定 名稱是指為遠端物件關聯或註冊一個名稱，以後可以使用該名稱來尋找該遠端物件。可以使用 Naming 類別的 bind 或 rebind 方法將遠端對象與某個名稱相關聯。

一旦遠端物件向本地主機上 RMI 註冊表註冊（綁定），遠端（或本地）主機上的調用方可以通過名稱尋找遠端物件，獲得其參考，並在該物件上調用遠端方法。註冊表可由在一個主機上運行的所有伺服器共享，需要時個別伺服器進程也可以創建和使用自己的註冊表（有關詳細資訊，請參見 java.rmi.registry.LocateRegistry.createRegistry）。

從以下版本開始：

JDK1.1

另請參見：

Registry, LocateRegistry, LocateRegistry.createRegistry(int)

方法摘要

static void	bind(String name, Remote obj) 將指定 name 綁定到遠端物件。
static String[]	list(String name) 返回在註冊表中綁定的名稱所組成的陣列。
static Remote	lookup(String name) 返回與指定 name 關聯的遠端物件的參考（一個 stub）。
static void	rebind(String name, Remote obj) 將指定名稱重新綁定到一個新的遠端物件。
static void	unbind(String name) 銷毀與遠端物件關聯的指定名稱的綁定。

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

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

方法詳細資訊

lookup

public static Remote lookup(String name)
                     throws NotBoundException,
                            MalformedURLException,
                            RemoteException

返回與指定 name 關聯的遠端物件的參考（一個 stub）。

參數：

name - 使用 URL 格式（不含 scheme 元件）的名稱

返回：

遠端物件的參考

拋出：

NotBoundException - 如果當前未綁定名稱

RemoteException - 如果無法聯繫註冊表

AccessException - 如果不允許執行此操作

MalformedURLException - 如果名稱不是適當格式化的 URL

從以下版本開始：

JDK1.1

bind

public static void bind(String name,
                        Remote obj)
                 throws AlreadyBoundException,
                        MalformedURLException,
                        RemoteException

將指定 name 綁定到遠端物件。

參數：

name - 使用 URL 格式（不含 scheme 元件）的名稱

obj - 遠端物件的參考（通常是一個 stub）

拋出：

AlreadyBoundException - 如果已經綁定了名稱

MalformedURLException - 如果該名稱不是適當格式化的 URL

RemoteException - 如果無法聯繫註冊表

AccessException - 如果不允許進行此操作（例如，如果起源於非本地主機）

從以下版本開始：

JDK1.1

unbind

public static void unbind(String name)
                   throws RemoteException,
                          NotBoundException,
                          MalformedURLException

銷毀與遠端物件關聯的指定名稱的綁定。

參數：

name - 使用 URL 格式（不含 scheme 元件）的名稱

拋出：

NotBoundException - 如果當前未綁定名稱

MalformedURLException - 如果該名稱不是適當格式化的 URL

RemoteException - 如果無法聯繫註冊表

AccessException - 如果不允許進行此操作（例如，如果起源於非本地主機）

從以下版本開始：

JDK1.1

rebind

public static void rebind(String name,
                          Remote obj)
                   throws RemoteException,
                          MalformedURLException

將指定名稱重新綁定到一個新的遠端物件。 將替換任何現有綁定。

參數：

name - 使用 URL 格式（不含 scheme 元件）

obj - 將與名稱關聯的新遠端物件

拋出：

MalformedURLException - 如果該名稱不是適當格式化的 URL

RemoteException - 如果無法聯繫註冊表

AccessException - 如果不允許執行此操作（例如，如果起源於非本地主機）

從以下版本開始：

JDK1.1

list

public static String[] list(String name)
                     throws RemoteException,
                            MalformedURLException

返回在註冊表中綁定的名稱所組成的陣列。該名稱為 URL 格式（不含 scheme 元件）的字元串。該陣列包含在調用時出現在註冊表中的名稱快照。

參數：

name - 使用 URL 格式（不含 scheme 元件）的註冊表名稱

返回：

在註冊表中綁定的名稱（使用適當格式）所組成的陣列

拋出：

MalformedURLException - 如果該名稱不是適當格式化的 URL

RemoteException - 如果無法聯繫註冊表。

從以下版本開始：

JDK1.1