compact2, compact3

java.rmi.registry

Interface Registry

All Superinterfaces:

Remote

public interface Registry
extends Remote

Registry是远程接口的一个简单的远程对象注册表，用于存储和检索远程对象绑定任意字符串名称提供方法。的 bind， unbind，和 rebind方法用于在注册表中修改名字的绑定，和 lookup和 list方法用于查询当前名称绑定。

在典型的用法，一Registry使RMI客户引导：它提供了一个客户端获得一个初始的远程对象引用的一个简单的方法。因此，注册表的远程对象的实现通常是一个著名的地址输出，如著名的ObjID和TCP端口号（默认是1099）。

的LocateRegistry类提供了构建引导参考一Registry在远程地址的API（见静getRegistry方法）和用于创建和出口Registry在当前虚拟机在一个特定的本地地址（见静createRegistry方法）。

一个Registry实现可以选择限制访问的一些或所有的方法（例如，方法，突变处的绑定可以被限制为从本地主机的电话）。如果一个Registry方法选择拒绝访问，对于一个给定的调用，实现可抛AccessException，它（因为它延伸RemoteException）将被包裹在一个ServerException当被远程客户端。

用于在Registry绑定的名字是纯字符串，而不是解析。一种服务，将参考一Registry不妨使用包名作为结合减少注册表中的名称冲突的可能性的名称前缀。

从以下版本开始：

JDK1.1

另请参见：

LocateRegistry

Field Summary

Fields

Modifier and Type	Field and Description
static int	REGISTRY_PORT 注册的众所周知的端口。

方法摘要

Modifier and Type	Method and Description
void	bind(String name, Remote obj) 结合在这个注册表指定的 name远程引用。
String[]	list() 返回绑定在该注册表中的数组的名称。
Remote	lookup(String name) 返回远程引用绑定到该注册表指定的 name。
void	rebind(String name, Remote obj) 替换为指定的 name结合在注册表中提供的远程引用。
void	unbind(String name) 删除绑定在这个注册表中指定的 name。

Field Detail

REGISTRY_PORT

static final int REGISTRY_PORT

注册的众所周知的端口。

另请参见：

Constant Field Values

方法详细信息

lookup

Remote lookup(String name)
       throws RemoteException,
              NotBoundException,
              AccessException

返回远程引用绑定到该注册表指定的 name。

参数

name -查找远程引用的名称

结果

一个远程对象的引用

异常

NotBoundException -如果 name尚未绑定

RemoteException -如果注册表远程通信失败；如果是一个例外， ServerException含有 AccessException，然后注册表拒绝接入执行此操作

AccessException -如果此注册表局部否认接入执行此操作

如果是 null name NullPointerException

bind

void bind(String name,
          Remote obj)
   throws RemoteException,
          AlreadyBoundException,
          AccessException

结合在这个注册表指定的 name远程引用。

参数

name -名称与远程参考副

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

异常

如果 name AlreadyBoundException已绑定

RemoteException -如果注册表远程通信失败；如果是一个例外， ServerException含有 AccessException，然后注册表拒绝接入执行此操作（如果来自于非本地主机，例如）

AccessException -如果此注册表局部否认接入执行此操作

NullPointerException -如果 name是 null，或者如果 obj是 null

unbind

void unbind(String name)
     throws RemoteException,
            NotBoundException,
            AccessException

删除绑定在这个注册表中指定的 name。

参数

name -绑定的名称删除

异常

NotBoundException -如果 name尚未绑定

RemoteException -如果注册表远程通信失败；如果是一个例外， ServerException含有 AccessException，然后注册表拒绝接入执行此操作（如果来自于非本地主机，例如）

AccessException -如果此注册表局部否认接入执行此操作

如果是 null name NullPointerException

rebind

void rebind(String name,
            Remote obj)
     throws RemoteException,
            AccessException

替换为指定的 name结合在注册表中提供的远程引用。如果有一个现有的结合为指定的 name，就丢弃。

参数

name -名称与远程参考副

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

异常

RemoteException -如果注册表远程通信失败；如果是一个例外， ServerException含有 AccessException，然后注册表拒绝接入执行此操作（如果来自于非本地主机，例如）

AccessException -如果此注册表局部否认接入执行此操作

NullPointerException -如果 name是 null，或者如果 obj是 null

list

String[] list()
       throws RemoteException,
              AccessException

返回绑定在该注册表中的数组的名称。该数组将包含在给定调用该方法时绑定在该注册表中的名称的快照。

结果

绑定在该注册表中的名称的数组

异常

RemoteException -如果注册表远程通信失败；如果是一个例外， ServerException含有 AccessException，然后注册表拒绝接入执行此操作

AccessException -如果此注册表局部否认接入执行此操作