分类：
2008-09-24 21:45:11
JNDI（The Naming and Directory Interface，命名和目录接口）是一组在Java应用中访问命名和目录服务的API.命名服务将名称和对象联系起来，使得我们可以用名称访问对象。目录服务是一种命名服务，在这种服务里，对象不但有名称，还有属性。
命名或目录服务使你可以集中共有信息，这一点在网络应用中是重要的，因为这使得这样的应用更协调、更容易管理。例如，可以将打印机设置在目录服务中，以便被与打印机有关的应用使用。
我们知道jndi是java的命名和目录服务的api，为什么要有它了，是因为我们在网络条件下可能要查找和使用一些分布式的资源。好比我们现在使用的操作系统，它本身有一个类似于jndi的东西，这样我们才能找到和存放一些资源，如文件等。例如windows系统的分区和目录，它就是一个目录服务，还有linux的以文件夹的方式也是相当于一个目录服务；DNS就是一个命名服务等等，这些应用都有jndi的影子。考虑在网络条件下，我们要查找一个资源，我们不知道它所在的机器是什么操作系统，采用的什么目录和命名模式，所以sun提供了一个更高层次的接口，即jndi，让我们查找和使用资源是忽略这些不同的地方。否则试想一下以windows的目录结构试着去匹配linux的目录结构肯定是不行的。
本文用代码示例的方式给出了一个快速教程，使你可以开始使用JNDI.它：
l 提供了JNDI概述 l 描述了JNDI的特点 l 体验了一下用JNDI开发应用 l 表明了如何利用JNDI访问LDAP，例如，Sun ONE 目录 l 表明了如何利用JNDI访问J2EE服务 l 提供了示例代码，你可以将其改编为自己的应用
JNDI概述
我们大家每天都不知不觉地使用了命名服务。例如，当你在web浏览器输入URL，时，DNS（Domain Name System，域名系统）将这个符号URL名转换成通讯标识（IP地址）。命名系统中的对象可以是DNS记录中的名称、应用服务器中的EJB组件（Enterprise JavaBeans Component）、LDAP（Lightweight Directory Access Protocol）中的用户Profile.
目录服务是命名服务的自然扩展。两者之间的关键差别是目录服务中对象可以有属性（例如，用户有email地址），而命名服务中对象没有属性。因此，在目录服务中，你可以根据属性搜索对象。JNDI允许你访问文件系统中的文件，定位远程RMI注册的对象，访问象LDAP这样的目录服务，定位网络上的EJB组件。
对于象LDAP 客户端、应用launcher、类浏览器、网络管理实用程序，甚至地址薄这样的应用来说，JNDI是一个很好的选择。
JNDI架构
JNDI架构提供了一组标准的独立于命名系统的API，这些API构建在与命名系统有关的驱动之上。这一层有助于将应用与实际数据源分离，因此不管应用访问的是LDAP、RMI、DNS、还是其他的目录服务。换句话说，JNDI独立于目录服务的具体实现，只要你有目录的服务提供接口（或驱动），你就可以使用目录。如图1所示。 图1：JNDI架构
关于JNDI要注意的重要一点是，它提供了应用编程接口（application programming interface，API）和服务提供者接口（service provider interface，SPI）。这一点的真正含义是，要让你的应用与命名服务或目录服务交互，必须有这个服务的JNDI服务提供者，这正是JNDI SPI发挥作用的地方。服务提供者基本上是一组类，这些类为各种具体的命名和目录服务实现了JNDI接口？很象JDBC驱动为各种具体的数据库系统实现了JDBC接口一样。作为一个应用开发者，你不必操心JNDI SPI.你只需要确认你要使用的每一个命名或目录服务都有服务提供者。
J2SE和JNDI
Java 2 SDK 1.3及以上的版本包含了JNDI.对于JDK 1.1和1.2也有一个标准的扩展。Java 2 SDK 1.4.x的最新版本包括了几个增强和下面的命名/目录服务提供者：
l LDAP（Lightweight Directory Access Protocol）服务提供者 l CORBA COS（Common Object Request Broker Architecture Common Object Services）命名服务提供者 l RMI（Java Remote Method Invocation）注册服务提供者 l DNS（Domain Name System）服务提供者
更多的服务提供者
可以在如下网址找到可以的服务提供者列表：
/products/jndi/serviceproviders.html 特别有意思的或许是如下网址提供的 注册表JNDI服务提供者： 这个服务提供者使你可以访问 XP/2000/NT/Me/9x的windows注册表。
也可以在如下网址JNDI/LDAP Booster Pack：/products/jndi/ 这个Booster Pack包含了对流行的LDAP控制的支持和扩展。它代替了与LDAP 1.2.1服务提供者捆绑在一起的booster pack.关于控制和扩展的更多信息可以在如下网站看到： /products/jndi/tutorial/ldap/ext/index.html 另一个有趣的服务提供者是Sun的支持DSML v2.0（Directory Service Markup Language，目录服务标记语言）的服务提供者。DSML的目的是在目录服务和XML之间架起一座桥梁。
JNDI API
JNDI API由5个包组成：
l Javax.naming：包含了访问命名服务的类和接口。例如，它定义了Context接口，这是命名服务执行查询的入口。 l Javax.naming.directory：对命名包的扩充，提供了访问目录服务的类和接口。例如，它为属性增加了新的类，提供了表示目录上下文的DirContext接口，定义了检查和更新目录对象的属性的方法。 l Javax.naming.event：提供了对访问命名和目录服务时的时间通知的支持。例如，定义了NamingEvent类，这个类用来表示命名/目录服务产生的事件，定义了侦听NamingEvents的NamingListener接口。 l Javax.naming.ldap：这个包提供了对LDAP 版本3扩充的操作和控制的支持，通用包javax.naming.directory没有包含这些操作和控制。 l Javax.naming.spi：这个包提供了一个方法，通过javax.naming和有关包动态增加对访问命名和目录服务的支持。这个包是为有兴趣创建服务提供者的开发者提供的。
JNDI 上下文
正如在前面提到的，命名服务将名称和对象联系起来。这种联系称之为绑定（binding）。一组这样的绑定称之为上下文（context），上下文提供了解析（即返回对象的查找操作）。其他操作包括：名称的绑定和取消绑定，列出绑定的名称。注意到一个上下文对象的名称可以绑定到有同样的命名约定的另一个上下文对象。这称之为子上下文。例如，如果UNIX中目录/home是一个上下文，那么相对于这个目录的子目录就是子上下文？例如，/home/guests中guests就是home的子上下文。在JNDI中，上下文用接口javax.naming.Context表示，这个接口是与命名服务交互的关键接口。在Context（或稍后讨论的
DirContext）接口中的每一个命名方法都有两种重载形式：
l Lookup（String name）：接受串名 l Lookup（javax.naming.Name）：接受结构名，例如，CompositeName（跨越了多个命名系统的名称）或CompondName（单个命名系统中的名称）；它们都实现了Name接口。Compound name的一个例子是：cn=mydir，cn=Q Mahmoud，ou=People，composite name的一个例子是：cn=mydir，cn=Q Mahmoud，ou=People/myfiles/max.txt（这里，myfiles/max.txt是表示第二部分的文件名） Javax.naming.InitialContext是实现了Context接口的类。用这个类作为命名服务的入口。为了创建InitialContext对象，构造器以java.util.Hashtable或者是其子类（例如，Properties）的形式设置一组属性。下面给出了一个例子：
Hashtable env = new Hashtable（）； // select a service provider factory env.put（Context.INITIAL_CONTEXT_FACTORY， "com.sun.jndi.fscontext.RefFSContext"）； // create the initial context Context contxt = new InitialContext（env）；
INITIAL_CONTEXT_FACTORY指定了JNDI服务提供者中工厂类（factory class）的名称。Factory负责为其服务创建适当的InitialContext对象。在上面的代码片断中，为文件系统服务提供者指定了工厂类。表1给出了所支持的服务提供者的工厂类。要注意的是文件系统服务提供者的工厂类需要从Sun公司单独，J2SE 1.4.x没有包含这些类。
表1：上下文INITIAL_CONTEXT_FACTORY的值 Name Service Provider Factory File System com.sun.jndi.fscontext.RefFSContextFactory LDAP com.sun.jndi.ldap.LdapCtxFactory RMI com.sun.jndi.rmi.registry.RegistryContextFactory CORBA com.sun.jndi.cosnaming.CNCtxFactory DNS com.sun.jndi.dns.DnsContextFactory
为了用名称从命名服务或目录中取得或解析对象，使用Context的lookup方法：Object obj=contxt.lookup（name）。Lookup方法返回一个对象，这个对象表示的是你想要找的上下文的儿子。
jndi配置属性的含义
有关tomcat配置jndi的一些简单介绍：
先说流程：（根据tomcat有关jndi的文档，这个文档应该是针对单个项目配置，下面有比较好的可以配置全局使用的例子）
1.先安装jdbc驱动，这一步很简单，只需将对应数据库驱动放到tomcat对应common/lib目录下就行了；
2.修改对应项目的WEB-INF/web.xml文件，用来声明你的jndi名字以供你的项目使用：
在你的web.xml文件中加入如下代码：
Resource reference to a factory for java.sql.Connection instances that may be used for talking to a particular database that is configured in the server.xml file. jdbc/EmployeeDB javax.sql.DataSource Container
3.对应java代码中获得连接方法：（代码摘要）
Context initCtx = new InitialContext();
Context envCtx = (Context) initCtx.lookup("java:comp/env");
DataSource ds = (DataSource)
envCtx.lookup("jdbc/EmployeeDB");
Connection conn = ds.getConnection();
... use this connection to access the database ...
conn.close();
4.配置你的tomcat资源工厂：
在WEB-INF目录下新建文件context.xml，内容如下：
...
这里使用HypersonicSQL database JDBC driver作为例子
元素的属性如下：
属性 描述 name 指定Resource的JNDI的名字 auth 指定管理Resource的Manager，由两个可选值：Container和Application。Container表示由容器来创建和管理 Resource，Application表示由WEB应用来创建和管理Resource。如果在web application deployment descriptor中使用 type 指定Resource所属的java类名
属性 描述 name 指定ResourceParams的JNDI的名字，必须和Resource的name保持一致 factory 指定生成DataSource对象的factory的类名 maxActive 指定数据库连接池中处于活动状态的数据库连接最大数目，0表示不受限制 maxIdle 指定数据库连接池中处于空闲状态的数据库连接的最大数目，0表示不受限制 maxWait 指定数据库连接池中的数据库连接处于空闲状态的最长时间（单位为毫秒），超过这一事件，将会抛出异常。-1表示可以无限期等待。 username 指定连接数据库的用户名 password 指定连接数据库的密码 driverClassName 指定连接数据库的JDBC驱动程序 url 指定连接数据库的URL
属性 描述 description 对所引用的资源的说明 res-ref-name 指定所引用资源的JNDI名字，与 res-type 指定所引用资源的类名字，与 res-auth 指定所引用资源的Manager，与
另:tomcat5.5的配制方法为:
maxActive="100" maxIdle="30" maxWait="10000"
username="用户名" password="密码" driverClassName="oracle.jdbc.driver.OracleDriver"
url="jdbc:oracle:thin:@ip:端口:sid"/>
JNDI是J2EE中一个很重要的标准，通常我们是在J2EE编程中用到，Tomcat中提供了在JSP和Servelt中直接使用JNDI的方法，主要是通过dbcp连接池，下面谈一下我在Tomcat5.5中配置和使用JNDI的方法。本文的对象是对j2ee编程有所了解的读者，或者已经看过了我的Blog：tomcat的基本配置说明
一、先在自己应用程序WEB-INF目录下的web.xml添加以下语句：
然后在tomcat目录/conf/server.xml文件里相应的
添加如下子元素：
url="jdbc:pointbase:server://localhost/acme（数据库连接url）" bitscn.com中国网管联盟
username="root（用户名）" password="root（密码）" maxActive="20（连接池dbcp的相关配置）" maxIdle="10" maxWait="10000"/>
注意，要把你的驱动拷到common/lib下，我用的是pointbase因此我拷的是pbclient44.jar到了common/lib下（对pointbase感兴趣的读者可以看我的另一篇文章pointbase数据库学习，里面也提到了我为什么是用pointbase数据库作为讲解）。
二、例子：以下是我的假设的项目ACMEWeb：
在相应程序的web.xml里添加
.....
然后再server.xml里修改：
文章出处：