模块  java.naming

Package javax.naming

提供用于访问命名服务的类和接口。

该包定义了Java命名和目录接口的命名操作(JNDI)。 JNDI为使用Java编程语言编写的应用程序提供命名和目录功能。 它旨在独立于任何特定的命名或目录服务实现。 因此,可以以通用方式访问各种服务 - 新的,新兴的和已经部署的服务。

上下文

此包定义了上下文的概念,由Context接口表示。 上下文由一组名称到对象绑定组成 Context是查找,绑定,解除绑定和重命名对象以及创建和销毁子上下文的核心接口。

lookup()是最常用的操作。 您提供lookup()要查找的对象的名称,并返回绑定到该名称的对象。 例如,以下代码片段查找打印机并将文档发送到要打印的打印机对象:

Printer printer = (Printer)ctx.lookup("treekiller");printer.print(report);

名称

Context接口中的每个命名方法都有两个重载:一个接受Name参数,另一个接受字符串名称。 Name是一个表示通用名称的接口 - 零个更多组件的有序序列。 对于这些方法,可以使用Name表示复合名称CompositeName ),以便您可以使用跨多个名称空间的名称来命名对象。

接受Name的重载对于需要操作名称的应用程序非常有用:组合它们,比较组件等等。 接受字符串名称的重载可能对简单应用程序更有用,例如那些只是简单地读取名称并查找相应对象的应用程序。

绑定

Binding类表示名称到对象的绑定。 它是一个元组,包含绑定对象的名称,对象类的名称以及对象本身。

Binding类实际上是NameClassPair的子类, NameClassPair包含对象的名称和对象的类名。 当您只需要有关对象类的信息并且不想支付获取对象的额外成本时, NameClassPair非常有用。

参考

对象以不同方式存储在命名和目录服务中。 如果对象存储支持存储Java对象,则它可能支持以序列化形式存储对象。 但是,某些命名和目录服务不支持存储Java对象。 此外,对于目录中的某些对象,Java程序只是访问它们的一组应用程序。 在这种情况下,序列化的Java对象可能不是最合适的表示形式。 JNDI定义了一个引用 ,由Reference类表示,其中包含有关如何构造对象副本的信息。 JNDI将尝试将从目录中查找的引用转换为它们所代表的Java对象,以便JNDI客户端错误地认为目录中存储的内容是Java对象。

初始背景

在JNDI中,所有命名和目录操作都是相对于上下文执行的。 没有绝对的根源。 因此,JNDI定义了一个初始上下文 InitialContext ,它为命名和目录操作提供了一个起点。 一旦有了初始上下文,就可以使用它来查找其他上下文和对象。

例外

JNDI定义了在执行命名和目录操作过程中可以抛出的异常的类层次结构。 此类层次结构的根是NamingException 对处理特定异常感兴趣的程序可以捕获异常的相应子类。 否则,程序应该捕获NamingException

包装规格

JNDI API规范和相关文档可在JNDI documentation中找到。
从以下版本开始:
1.3