Registry

Registry 实现可以选择限制对其中的某些或全部方法的访问（例如，可以限制改变注册表绑定的方法来限制对本地主机发起的调用）。如果 Registry 方法选择拒绝对给定调用的访问，则其实现可能抛出 AccessException，抛出的这一异常（因为它扩展 RemoteException）可能会在远程客户端捕获它时包装在 ServerException 中。

在 Registry 中用于绑定的名称是纯字符串，不是经过分析的。在 Registry 中存储其远程引用的服务可能希望将包名称用作名称绑定中的前缀，以减少注册表中可能的名称冲突。

从以下版本开始：: JDK1.1
另请参见：: LocateRegistry

字段摘要
`static int`	`REGISTRY_PORT` 已知的注册表端口。

方法摘要
`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` 绑定。

字段详细信息

REGISTRY_PORT

static final int REGISTRY_PORT

已知的注册表端口。

另请参见：: 常量字段值

方法详细信息

lookup

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

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

参数：: name - 要查找的远程引用的名称
返回：: 对远程对象的引用
抛出：: NotBoundException - 如果当前未绑定 name; RemoteException - 如果与注册表的远程通信失败；如果异常是包含 AccessException 的 ServerException，则注册表拒绝调用方对执行此操作的访问。; AccessException - 如果此注册表是本地的，并且它拒绝调用方对执行此操作的访问; NullPointerException - 如果 name 为 null

bind

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

绑定对此注册表中指定 name 的远程引用。

参数：: name - 与该远程引用相关的名称; obj - 对远程对象（通常是一个 stub）的引用
抛出：: AlreadyBoundException - 如果已经绑定了 name; RemoteException - 如果与注册表的远程通信失败；如果异常是包含 AccessException 的 ServerException，则注册表拒绝调用方对执行此操作的访问（例如，发起的操作来自非本地主机）; AccessException - 如果此注册表是本地的，并且它拒绝调用方对执行此操作的访问; NullPointerException - 如果 name 为 null，或者如果 obj 为 null

unbind

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

移除此注册表中指定的 name 绑定。

参数：: name - 要移除的绑定名称
抛出：: NotBoundException - 如果当前未绑定 name; RemoteException - 如果与注册表的远程通信失败；如果异常是包含 AccessException 的 ServerException，则注册表拒绝调用方对执行此操作的访问（例如，发起的操作来自非本地主机）; AccessException - 如果此注册表是本地的，并且它拒绝调用方对执行此操作的访问; NullPointerException - 如果 name 为 null

rebind

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

用提供的远程引用替换此注册表中指定的 name 绑定。如果存在指定 name 的现有绑定，则会丢弃此现有的绑定。

参数：: name - 与该远程引用相关的名称; obj - 对远程对象（通常是一个 stub）的引用
抛出：: RemoteException - 如果与注册表的远程通信失败；如果异常是包含 AccessException 的 ServerException，则注册表拒绝调用方对执行此操作的访问（例如，发起的操作来自非本地主机）; AccessException - 如果此注册表是本地的，并且它拒绝调用方对执行此操作的访问; NullPointerException - 如果 name 为 null，或者如果 obj 为 null

list

String[] list()
              throws RemoteException,
                     AccessException

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

返回：: 此注册表中绑定名称的数组
抛出：: RemoteException - 如果与注册表的远程通信失败；如果异常是包含 AccessException 的 ServerException，则注册表拒绝调用方对执行此操作的访问。; AccessException - 如果此注册表是本地的，并且它拒绝调用方对执行此操作的访问

概述

软件包

类

使用

树

已过时

索引

帮助

Java^TM 2 Platform
Standard Ed. 5.0

上一个类 下一个类

框架 无框架

摘要：嵌套 | 字段 | 构造方法 | 方法

详细信息：字段 | 构造方法 | 方法

提交错误或意见
有关更多的 API 参考资料和开发人员文档，请参阅 Java 2 SDK SE 开发人员文档。该文档包含更详细的、面向开发人员的描述，以及总体概述、术语定义、使用技巧和工作代码示例。