JNDI 学习(转)
基于JNDI的应用开发
JNDI（The Java Naming and Directory Interface，Java命名和目录接口）是一组在Java应用中访问命名和目录服务的API.命名服务将名称和对象联系起来，使得我们可以用名称访问对象。目录服务是一种命名服务，在这种服务里，对象不但有名称，还有属性。
命名或目录服务使你可以集中存储共有信息，这一点在网络应用中是重要的，因为这使得这样的应用更协调、更容易管理。例如，可以将打印机设置存储在目录服务中，以便被与打印机有关的应用使用。
JNDI概述
我们大家每天都不知不觉地使用了命名服务。例如，当你在web浏览器输入URL，http://java.sun.com时，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）服务提供者
更多的服务提供者
可以在如下网址找到可以下载的服务提供者列表：
http://java.sun.com/products/jndi/serviceproviders.html 特别有意思的或许是如下网址提供的Windows 注册表JNDI服务提供者：http://cogentlogic.com/cocoon/CogentLogicCorporation/JNDI.xml 这个服务提供者使你可以访问Windows XP/2000/NT/Me/9x的windows注册表。
也可以在如下网址下载JNDI/LDAP Booster Pack：http://java.sun.com/products/jndi/ 这个Booster Pack包含了对流行的LDAP控制的支持和扩展。它代替了与LDAP 1.2.1服务提供者捆绑在一起的booster pack.关于控制和扩展的更多信息可以在如下网站看到： http://java.sun.com/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）接口中的每一个命名方法都有两种重载形式：
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总体的理解： jndi(java naming and directory Interface)它提供了一套使用命名和目录服务的接口。用户可以通过它来使用命名和目录服务。就像jdbc一样。jndi包括命名服务和目录服务两部分，其中目录服务包含目录对象directory object，它包含若干属性对象。提供了对属性的很多操作。
命名和目录服务： 命名和目录服务我们一直在使用，如操作系统的文件系统，它给我们提供对文件的操作，查询，添加删除等功能。DNS服务将url同ip地址绑定在了一起。命名和目录系统的最主要的功能是将name和对象绑定。在它的基础之上还提供更多的功能如lookup,search.而且存储的对象是有一定层次结构的。使用这样的服务我们可以对对象更加有效的管理和操作。
命名服务将一个名称映射到一个对象。RMI Registry和CORBA Naming Service都是命名服务。
目录服务也存放对象，但目录服务识别这些对象的相关属性。可以用项目属性来搜索目录。
在20世纪90年代早期，轻量级的目录访问协议（LightWeightDiretoryAccessProtocol，LDAP）被作为一种标准的目录协议被开发出来，JNDI能够访问LDAP。
j2se为jndi提供了5个扩展包：
javax.naming；为访问命名服务提供的api
javax.naming.directory；为访问目录服务提供了基本的接口
javax.naming.event；支持命名和目录服务中的事件通知
javax.naming.ldap； 支持ldap的包，
javax.naming.spi；提供了不同命名和目录服务可以挂接他们的实现的方法。
context: context是一套name-to-object的绑定(bindings),可以理解为层次或目录，它还可已包括下一层subContext。在使用命名和目录服务时获得initial context是对整个名字空间操作的入口。在目录服务中是DirContext.
-------------------------------
JNDI(Java Naming and Directory Interface)是一个应用程序设计的API，为开发人员提供了查找和访问各种命名和目录服务的通用、统一的接口，类似JDBC都是构建在抽象层上。
JNDI可访问的现有的目录及服务有：
DNS、XNam 、Novell目录服务、LDAP(Lightweight Directory Access Protocol 轻型目录访问协议)、 CORBA对象服务、文件系统、Windows XP/2000/NT/Me/9x的注册表、RMI、DSML v1&v2、NIS。
JNDI优点：
包含了大量的命名和目录服务，使用通用接口来访问不同种类的服务；可以同时连接到多个命名或目录服务上；建立起逻辑关联，允许把名称同Java对象或资源关联起来，而不必指导对象或资源的物理ID。
JNDI程序包：
javax.naming：命名操作；
javax.naming.directory：目录操作；
javax.naming.event：在命名目录服务器中请求事件通知；
javax.naming.ldap：提供LDAP支持；
javax.naming.spi：允许动态插入不同实现。
利用JNDI的命名与服务功能来满足企业级APIs对命名与服务的访问，诸如EJBs、JMS、JDBC 2.0以及IIOP上的RMI通过JNDI来使用CORBA的命名服务。
JNDI与JDBC：
JNDI提供了一种统一的方式，可以用在网络上查找和访问服务。通过指定一个资源名称，该名称对应于数据库或命名服务中的一个纪录，同时返回数据库连接建立所必须的信息。
代码示例：
try{
Context cntxt = new InitialContext();
DataSource ds = (DataSource) cntxt.lookup("jdbc/dpt");
}
catch(NamingException ne){
...
}
JNDI与JMS：
消息通信是软件组件或应用程序用来通信的一种方法。JMS就是一种允许应用程序创建、发送、接收、和读取消息的JAVA技术。
代码示例：
try{
Properties env = new Properties();
InitialContext inictxt = new InitialContext(env);
TopicConnectionFactory connFactory = (TopicConnectionFactory) inictxt.lookup("TTopicConnectionFactory");
...
}
catch(NamingException ne){
...
}
访问特定目录：举个例子，人是个对象，他有好几个属性，诸如这个人的姓名、电话号码、电子邮件地址、邮政编码等属性。通过getAttributes()方法
Attribute attr = directory.getAttributes(personName).get("email");
String email = (String)attr.get();
通过使用JNDI让客户使用对象的名称或属性来查找对象：
foxes = directory.search("o=Wiz,c=US", "sn=Fox", controls);
通过使用JNDI来查找诸如打印机、数据库这样的对象，查找打印机的例子：
Printer printer = (Printer)namespace.lookup(printerName);
printer.print(document);
浏览命名空间：
NamingEnumeration list = namespace.list("o=Widget, c=US");
while (list.hasMore()) {
NameClassPair entry = (NameClassPair)list.next();
display(entry.getName(), entry.getClassName());
}
参考资料：
http://java.sun.com/products/jndi/examples.html
http://java.sun.com/products/jndi/serviceproviders.html
常用的JNDI操作：
void bind(String sName,Object object);――绑定：把名称同对象关联的过程
void rebind(String sName,Object object);――重新绑定：用来把对象同一个已经存在的名称重新绑定
void unbind(String sName);――释放：用来把对象从目录中释放出来
void lookup(String sName,Object object);――查找：返回目录总的一个对象
void rename(String sOldName,String sNewName);――重命名：用来修改对象名称绑定的名称
NamingEnumeration listBinding(String sName);――清单：返回绑定在特定上下文中对象的清单列表
NamingEnumeration list(String sName);
代码示例：重新得到了名称、类名和绑定对象。
NamingEnumeration namEnumList = ctxt.listBinding("cntxtName");
...
while ( namEnumList.hasMore() ) {
Binding bnd = (Binding) namEnumList.next();
String sObjName = bnd.getName();
String sClassName = bnd.getClassName();
SomeObject objLocal = (SomeObject) bnd.getObject();
}
--------------------------------------------------------------------------------------------------------------------------------------------------------
了解名字服务和目录服务的相关概念，有助于更好的使用JNDI。
Naming service
名字服务定义了如何将名字与对象关联，并通过名字如何找到对象的方法。典型的例子如：DNS将域名与IP关联，文件系统将文件名与文件相关联。在名字服务中，主要的概念：
- 名字（Names），在名字系统中实际对象的代号，如文件名，域名等，它会被用来查找关联的对象。不同的系统中会有不同的命名规范，如文件系统采用“\”来表示层级，而DNS则使用“.”。
- 绑定（Bindings），名字和实际对象的关联。
- 引用和地址（References and Addresses），当对象不能直接被存储在名字系统时，就必须使用引用，通过引用找到实际的对象。在系统中，保存的引用的内容被称为地址。引用还有另一个用处：在名字系统中，缺少象关系数据库中外键的概念。通过使用引用，可以作为外键的一个取代办法。
- 上下文（Context），它是一个名字-对象集合，提供了与名字系统交互的主要操作，如查找、绑定、去绑定。子上下文（subcontext）与它的关系类似文件系统中目录和子目录的关系，子上下文被包含在一个上下文中，通过父上下文中的一个名字与子上下文关联。
- 名字系统和名字空间（Naming Systems and Namespaces），名字系统是相同类型的上下文的集合，它提供名字服务；名字空间，是名字系统中的名字集合，如文件系统的文件名和目录。
Directory service
目录服务是名字服务的扩展，它除了关联名字和对象，还允许对象包含属性。目录系统通常以层次结构组织数据。在目录服务中的主要概念：
- 属性（Attributes），它属于目录对象，它是（名字，值）对，属性可以有多个值。
- 目录和目录服务（Directories and Directory Services），目录是目录对象的集合；目录服务则提供与目录相关的服务，创建、删除和修改存放在目录中的对象的属性。
- 查找和查找过滤器（Searches and Search Filters），获取目录对象的操作就是查找；过滤器是类似查找条件的对象。
基本使用
² 注册JNDI提供者
在使用JNDI之前，需要先获取JNDI的提供者，并在系统注册它。与JNDI相关的系统属性在javax.naming.Context中定义，常用的属性：
- java.naming.factory.initial，服务提供者用来创建InitialContext的类名。
- java.naming.provider.url，用来配置InitialContext的初始url
- java.naming.factory.object，用来创建name-to-object映射的类，用于NameClassPair和References。
- java.naming.factory.state，用来创建jndi state的类
对于目录服务，由于一般需要安全设置，还通常使用：
- java.naming.security.authentication，安全类型，三个值：none，simple或strong。
- java.naming.security.principal，认证信息。
- java.naming.security.credentials，证书信息。
- java.naming.security.protocol，安全协议名。
使用System.setProperty注册，如果程序不显示说明，那么java会在classpath内查找jdni.properties文件来完成注册。jdni.properties例子：
java.naming.factory.initial=com.codeline.db.MockInitialContextFactory
² 连接服务
注册之后，就可以实施服务连接了。对于名字服务由InitialContext开始，目录服务则使用InitialDirContext。它们分别实现了Context和DirContext，这两个接口分别对应名字服务和目录服务的接口，也是JNDI中最重要的两个接口。
- 连接名字服务：
2 com.sun.jndi.fscontext.FSContextFactory");
3InitialContext ctx = new InitialContext();
4
5
- 连接目录服务：
2 env.put(Context.INITIAL_CONTEXT_FACTORY, "com.sun.jndi.ldap.LdapCtxFactory");
3 env.put(Context.PROVIDER_URL, "ldap://myserver.com/");
4 env.put(Context.SECURITY_AUTHENTICATION, "simple");
5 //登录ldap server需要的用户名
6 env.put(Context.SECURITY_PRINCIPAL, "ldapuser");
7 //登录ldap server需要的密码
8 env.put(Context.SECURITY_CREDENTIALS, "mypassword");
9InitialDirContext ctx = new InitialDirContext(env);
- 多服务提供者：如果应用包含多个服务提供者，在连接时略有不同。以名字服务为例：
2 env.put(Context.INITIAL_CONTEXT_FACTORY,
3"com.sun.jndi.rmi.registry.RegistryContextFactory");
4 env.put(Context.PROVIDER_URL, "rmi://myserver.com:1099");
5 //使用不同的构造函数
6InitialContext ctx = new InitialContext(env);
² 查找对象
不论名字服务还是目录服务，都是使用lookup来查找对象的。除了可以使用String作为参数之外，lookup还可使用Name接口作为参数。
如果想要获得上下文中所有的对象名字，就使用lis返回NameClassPair列表。NameClassPair包含对象名字和对象类名。如果想要获得实际的对象实例列表，就使用listBindings，它返回Binding列表。Binding是NameClassPair的子类，它包含对象的实例。
- list
2while (list.hasMore()) {
3 NameClassPair nc = (NameClassPair)list.next();
4 System.out.println(nc);
5}
- listBindings
2while (bindings.hasMore()) {
3 Binding bd = (Binding)bindings.next();
4 System.out.println(bd.getName() + ": " + bd.getObject());
5}
² 对象绑定
- 使用bind添加绑定
2ctx.bind("favorite", fruit);
- 使用rebind修改绑定
2ctx.rebind("favorite", fruit);
- 使用unbind去除绑定。
² 对象改名
使用rename可以给一个在上下文中的对象改名
² 获取属性
属性相关的接口是Attribute和Attributes，它们都在javax.naming.directory包内。通过DirContext的getAttributes方法就可以获得对象的属性集合，然后使用Attributes的get方法获得对应的属性，最后通过Attribute的get方法就可以获得属性值。
2Context user = (Context)ctx.lookup(dn);
3//获得所有属性
4Attributes attrs = user.getAttributes("");
5Attribute test= attrs .get("test");
6Object testValue= test.get();
上例中获得的是user的所有属性，在实际使用过程中，考虑网络带宽的影响，可以设置获取要获取的属性列表：
2Attributes attrs = user.getAttributes("", reqd_attrs);
² 查找和过滤
使用search方法完成。
2 //构造条件
3 BasicAttributes search_attrs = new BasicAttributes();
4 search_attrs.put("initials", initials);
5 search_attrs.put("sn", surname);
6 search_attrs.put("c", country);
7 if(phone != null)
8 search_attrs.put("phonenumber", phone);
9 NamingEnumeration results = initial_ctx.search("ou=Customer,o=ExampleApp", search_attrs);
10 LinkedList found = new LinkedList();
11 while(results.hasMore()) {
12 SearchResults sr = (SearchResults)results.next();
13 String name = sr.getName();
14 Object ctx = sr.getObject();
15 if((ctx == null) || !(ctx instanceof DirContext))
16 found.add(initial_ctx.lookup(name));
17 else
18 found.add(ctx);
19 }
20 DirContext[] ret_val = new DirContext[found.size()];
21 found.toArray(ret_val);
22 return ret_val;
23 }
DirContext接口主要过滤方式：
1.使用过滤字符串
2NamingEnumeration results = initial_ctx.search("ou=Customer, o=ExampleApp",search_attrs,reqd_attrs);
2.使用SearchControls，获得更多的控制
2ctrls.setCountLimit(20);
3ctrls.setTimeLimit(5000);
4ctrls.setSearchScope(SearchControls.SUBTREE_SCOPE);
5NamingEnumeration results = initial_ctx.search("cat=books,ou=Products,
6o=ExampleApp","title=*Java*",ctrls);
² 修改属性
使用DirContext和InitialDirContext的modifyAttributes方法完成。所谓的修改过程，实际就是先构造要修改的属性列表，然后使用上述方法提交。对于属性包含多个值时，需要把属性的不修改的值也要包含，否则服务器会认为那些值不再需要而删除它们。
2 BasicAttributes mod_attrs = new BasicAttributes();
3 if(address != null)
4 mod_attrs.put("address", address);
5 if(country != null)
6 mod_attrs.put("c", country);
7 if(phone != null)
8 mod_attrs.put("phonenumber", phone);
9 if(mod_attrs.size() != 0)
10 initial_ctx.modifyAttributes(dn, DirContext.REPLACE_ATTRIBUTE, mod_attrs);
11}
使用ModificationItem，也可一次进行多个不同的修改操作：
ModificationItem[] mod_items = new ModificationItems[2];
Attribute email = new BasicAttribute("rfc822mailalias", new_email);
ModificationItem email_mod = new ModificationItem(DirContext.ADD_ATTRIBUTE, email);
Attribute addr = new BasicAttribute("address", address);
ModificationItem addr_mod = new ModificationItem(DirContext.REPLACE_ATTRIBUTE, addr);
mod_items[0] = email_mod;
mod_items[1] = addr_mod;
initial_ctx.modifyAttributes(dn, mod_items);
² 创建上下文
使用createSubcontext方法完成。
2attrs.put("initials", initials);
3attrs.put("sn", surname);
4attrs.put("rfc822mailalias", email);
5if(address != null)
6 attrs.put("address", address);
7if(country != null)
8 attrs.put("c", country);
9if(phone != null)
10 attrs.put("phonenumber", phone);
11initial_ctx.createSubcontext(dn, attrs);
² 删除上下文
使用destroySubcontext方法完成。
