compact2, compact3

java.rmi

Class Naming

java.lang.Object

java.rmi.Naming

public final class Naming
extends Object

的 Naming类提供用于存储和远程对象注册表获得远程对象的引用方法。 Naming类的每个方法作为一个参数的名称，URL格式的 java.lang.String（无计划的组成部分）的形式：

/主机：端口/名称

在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)

方法摘要

Modifier and Type	Method and Description
static void	bind(String name, Remote obj) 将指定的 name到远程对象。
static String[]	list(String name) 返回绑定在注册表中的数组的数组。
static Remote	lookup(String name) 返回一个引用，一个存根，对具有指定 name有关远程对象。
static void	rebind(String name, Remote obj) 重新绑定指定一个新名字，远程对象。
static void	unbind(String name) 破坏与远程对象关联的指定名称的绑定。

Methods inherited from class 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有关远程对象。

参数

name在URL格式的名称（无计划的组成部分）

结果

用于远程对象的引用

异常

NotBoundException如果名字不是当前绑定

RemoteException如果注册表无法联系

AccessException -如果这个操作是不允许的

MalformedURLException -如果名字不是一个适当的格式化的URL

从以下版本开始：

JDK1.1

bind

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

将指定的 name到远程对象。

参数

name在URL格式的名称（无计划的组成部分）

obj为远程对象的引用（通常是一个存根）

异常

AlreadyBoundException如果名字已绑定

MalformedURLException -如果名字不是一个适当的格式化的URL

RemoteException如果注册表无法联系

AccessException -如果这个操作是不允许的（如果来自于非本地主机，例如）

从以下版本开始：

JDK1.1

unbind

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

破坏与远程对象关联的指定名称的绑定。

参数

name在URL格式的名称（无计划的组成部分）

异常

NotBoundException如果名字不是当前绑定

MalformedURLException -如果名字不是一个适当的格式化的URL

RemoteException如果注册表无法联系

AccessException -如果这个操作是不允许的（如果来自于非本地主机，例如）

从以下版本开始：

JDK1.1

rebind

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

重新绑定指定一个新名字，远程对象。任何现有的绑定名称被替换。

参数

name在URL格式的名称（无计划的组成部分）

obj -新的远程对象的名字联想

异常

MalformedURLException -如果名字不是一个适当的格式化的URL

RemoteException如果注册表无法联系

AccessException -如果这个操作是不允许的（如果来自于非本地主机，例如）

从以下版本开始：

JDK1.1

list

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

返回绑定在注册表中的数组的数组。名称是格式化的（没有计划组件）字符串。数组包含在调用时在注册表中存在的名称的快照。

参数

name在URL格式注册表名称（无计划的组成部分）

结果

在注册表中绑定的一个名称数组（在适当的格式中）

异常

MalformedURLException -如果名字不是一个适当的格式化的URL

RemoteException如果注册表无法联系。

从以下版本开始：

JDK1.1