Package javax.naming

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

See: 描述

接口摘要

接口	描述
Context	此接口表示一个命名上下文，它由一组名称绑定到对象绑定组成。
Name	的 Name接口代表一个通用的名字--一个有序序列元件。
NameParser	此接口用于从层次名称空间解析名称。
NamingEnumeration<T>	这个界面是枚举列表在javax.naming和javax.naming.directory封装方法返回。
Referenceable	此接口由一个对象来实现，可以为它自己提供一个参考。

类摘要

类	描述
BinaryRefAddr	这类代表一个通信端点地址的二进制形式。
Binding	这个类代表一个在上下文中找到的对象绑定的名称。
CompositeName	这类代表一个复合的名字--一个组件名称生成多个命名空间序列。
CompoundName	这个类代表一个复合名-一个层次名称空间的名称。
InitialContext	此类是执行命名操作的起始上下文。
LinkRef	此类表示的是一个引用，该引用的内容是一个名称，称为链接名称，在上下文中绑定到一个原子名称。
NameClassPair	此类表示在上下文中找到的绑定的对象名称和类名称对。
RefAddr	这类代表一个通信端点的地址。
Reference	此类表示在命名目录系统之外的一个对象的引用。
StringRefAddr	这类代表一个通信端点地址的字符串形式。

异常摘要

异常	描述
AuthenticationException	当访问命名或目录服务时，出现了一个身份验证错误时引发的异常。
AuthenticationNotSupportedException	当不支持请求的特定身份验证时引发此异常。
CannotProceedException	此异常被抛出，以指示操作无法继续进行任何操作的名称中的一个点。
CommunicationException	当客户端无法与目录或命名服务进行通信时，将引发此异常。
ConfigurationException	当有一个配置问题时，将引发此异常。
ContextNotEmptyException	当试图破坏不为空的上下文时，将引发此异常。
InsufficientResourcesException	当资源无法完成所请求的操作时，会引发此异常。
InterruptedNamingException	当调用的命名操作被中断时，引发此异常。
InvalidNameException	此异常表示指定的名称不符合命名系统的命名语法。
LimitExceededException	当一个方法因用户或系统指定的限制而异常终止时引发此异常。
LinkException	这个异常用于描述解决链接时遇到的问题。
LinkLoopException	当检测到一个循环时，这个异常将试图解决一个链接，或者一个实现链接数的实现特定的限制。
MalformedLinkException	这种异常被抛出时，一个畸形的链接是在解决或构建环节遇到。
NameAlreadyBoundException	此异常被抛出的方法表示绑定不能被添加，因为名称已绑定到另一个对象。
NameNotFoundException	当名称的一个组件不能被解决，因为它不被绑定时，将引发此异常。
NamingException	这是父类所有抛出的异常操作的上下文和DirContext接口。
NamingSecurityException	这是父类抛出的异常安全相关操作的上下文和DirContext接口。
NoInitialContextException	当没有初始上下文实现时，可以创建此异常。
NoPermissionException	当试图执行客户端没有权限的操作时引发此异常。
NotContextException	当一个命名操作指向一个需要继续操作的上下文时，这个异常将被抛出，但解决的对象不是上下文。
OperationNotSupportedException	当上下文实现不支持正在调用的操作时，引发此异常。
PartialResultException	此异常被抛出表示返回或返回的结果是部分的，并且无法完成操作。
ReferralException	这个抽象类是用来表示一个转诊的例外，这是在回应一个转诊如LDAP V3服务器返回的产生。
ServiceUnavailableException	当试图与目录或命名服务进行通信时，会引发此异常，而该服务不可用。
SizeLimitExceededException	当一个方法产生超过大小相关的限制的结果时，会引发此异常。
TimeLimitExceededException	当在指定的时间限制内不终止时，引发此异常。

Package javax.naming Description

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

此包定义命名操作的java命名和目录interface^TM（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是有用的。

工具书类

对象存储在命名和目录服务的方式不同。如果一个对象存储支持存储java对象，它可以支持存储对象的序列化格式。然而，一些命名和目录服务不支持java对象的存储。此外，对于某些对象的目录，java程序，但是一组访问他们的应用程序。在这种情况下，一个序列化的java对象可能不是最合适的表示。JNDI定义了一个参考，以 Reference类来表示，其中包含的信息如何构造一个对象的副本。JNDI将尝试引用抬头从目录到他们所代表的java对象，使客户产生错觉，JNDI是什么目录中存放的是java对象。

初始上下文

在JNDI，所有命名和目录操作相对于上下文。没有绝对的根。因此，JNDI定义了一个初始上下文， InitialContext，提供命名和目录操作的起点。一旦你有一个初始上下文，你可以用它来查找其他上下文和对象。

例外

JNDI定义例外可以被进行命名和目录操作的类层次结构。这类层次结构的根是 NamingException。程序在处理一个特定的异常感兴趣的可以捕捉异常对应的子类。否则，程序应该抓住 NamingException。

包装规格

JNDI API规范和相关文件，可以在 JNDI documentation发现。

从以下版本开始：

1.3