介绍JNDI的简单概念&简单示例

 

JNDI: The Java Naming and Directory Interface

什么是JNDI ？

The Java Naming and Directory Interface是访问不同名字和目录服务的统一API接口。

不同的服务使用不同的名字格式。

Java程序需要以相同的格式访问数据库，文件，目录，对象和网络。

JNID有两部分接口：应用程序接口和提供服务的接口。在应用程序中使用API来访问名字或目录服务，在一个新的服务中使用SPI来提供服务。

JNDI 结构

名字服务（Naming Services）

名字服务提供一种方法，映射标识符到实体或对象。

你需要知道的几条基本条款：

绑定：绑定是将一个不可分割的名字（"原子"名字）与一个对象联系起来。像DNS，我们用名字www.yahoo.com与IP地址216.32.74.53联系起来，一个文件对象用文件名afile.txt联系起来。

名字空间；名字空间包含一组名字，但名字空间内每个名字是唯一的。一个文件目录就是一个简单的名字空间，如目录C:/temp，在这个目录下，不能有两个相同名字的文件，但是，不同目录下的两个文件可能有相同的名字。

复合名字：复合名字是用名字空间构成的唯一名字，有一个或多个"原子"名字构成，取决于所在的名字空间。文件路径就是一个复合名字，比如我们用C:/temp/myfile.txt，我们可以看到，这个名字由根目录名（C:/），临时目录名（temp）和一个文件名（myfile.txt）构成，这3个名字复合起来表示一个唯一的名字。

组合名字：组合名字能跨越多个名字空间。一个URL就是一个组合名字，如果你看见http://www.npu.edu/index.htm，你使用http服务连接到服务器，然后使用另一个名字空间/index.htm来访问一个文件。

目录服务

目录服务提供一组分成等级的目录对象，具有可搜索的能力。

在目录服务中存储的对象可以是任何能用一组属性描述的对象，每个对象都可通过一组属性来描述该对象的能力。例如，一个Person对象可能有height，hair color，age，sex等属性。目录服务还可提供根据要求来搜索的能力，如我们可以使用Person的age属性，搜索20-25岁间的Person对象，目录服务将返回符合条件的Persion对象。这通常被称作基于内容的搜索。

在客户端使用JNDI：

u       创建一个java.util.Hashtable或者java.util.Properties的实例。

u       添加变量到Hashtable或Properties对象：

由naming server提供的JNDI class类名。

包含aming server位置的URL。

安全信任书。

u       通过Hashtable或Properites或jndi属性文件创建一个InitialContext对象。

 

示例：

1. import java.util.*;
2. import javax.naming.*;
3. ...
4. env.put(Context.INITIAL_CONTEXT_FACTORY, "weblogic.jndi.WLInitialContextFactory");
5. env.put(Context.PROVIDER_URL,"t3://localhost:7001");
6. InitialContext ctx = new InitialContext(env);

环境变量	相应的常量	说明
java.naming.factory.initial	Context.INITIAL_CONTEXT_FACTORY	Context Factory 类名，由服务提供商给出。
java.naming.provider.url	Context.PROVIDE_URL	初始化地址。
java.naming.security. principal	Context.SECURITY_PRINCIPAL	服务使用者信息。
java.naming.security. credentials	Context.SECURITY_CREDENTIAL	口令。

更多的配置示例：

1. Hashtable env = new Hashtable();
2. env.put (Context.INITIAL_CONTEXT_FACTORY,
3. "weblogic.jndi.WLInitialContextFactory");
4. env.put(Context.PROVIDER_URL, "t3://localhost:7001");
5. env.put(Context.SECURITY_PRINCIPAL, "system");
6. env.put(Context.SECURITY_CREDENTIALS, "password here");
7. Properties env = new Properties();
8. env.setProperties ("java.naming.factory.initial",
9. "weblogic.jndi.WLInitialContextFactory");
10. env.setProperties("java.naming.provider.url" , "t3://localhost:7001");
11. env.setProperties("java.naming.security.principal" , "tommy");
12. env.setProperties("java.naming.security.credentials" ,"password here");

创建InitialContext ：
Class Name: javax.naming.InitialContext
Interfaces that it implements: javax.naming.Context
Constructors:
    public InitialContext();
    public InitialContext(Hashtable configuration);
    public InitialContext(Properties configuration);

以上所有方法都可能抛出NamingException。

一个Binding 示例：

1. public static InitialContext getInitialContext() throws NamingException {
2.      Hashtable env = new Hashtable();
3.      env.put(Context.INITIAL_CONTEXT_FACTORY,
4.           "weblogic.jndi.WLInitialContextFactory");
5.      env.put(Context.PROVIDER_URL,"t3://localhost:7001");
6.      InitialContext context = new InitialContext(env);
7.      return context;
8.  }
9.  //Obtain the initial context
10.  InitialContext initialContext = getInitialContext();
11.  //Create a Bank object.
12.  Bank myBank = new Bank();
13.  //Bind the object into the JNDI tree.
14.  initialContext.rebind("theBank",myBank);

一个Lookup 示例：

1. public static InitialContext getInitialContext() throws NamingException {
2.     Hashtable env = new Hashtable();
3.     env.put(Context.INITIAL_CONTEXT_FACTORY,
4.          "weblogic.jndi.WLInitialContextFactory");
5.     env.put(Context.PROVIDER_URL,"t3://localhost:7001");
6.     InitialContext context = new InitialContext(env);
7.     return context;
8. }
9. //Obtain the initial context
10. InitialContext initialContext = getInitialContext();
11. //Lookup an existing Bank object.
12. Bank myBank = (Bank) initialContext.lookup("theBank");

可能发生的NamingException ：
AuthenticationException
CommunicationException
InvalidNameException
NameNotFoundException
NoInitialContextException
枚举所有名字对象：
NamingEnumeration Declaration:

1. public interface NamingEnumeration extends Enumeration {
2.     public boolean hashMore() throws NamingException;
3.     public Object next() throws NamingException;
4.     public void close() throws NamingException; //jndi 1.2
5. }
6. try {
7.     ...
8.     NamingEnumeration enum = ctx.list("");
9.     while (enum.hasMore()) {
10.         NameClassPair ncp = (NameClassPair) enum.next();
11.         System.out.println("JNDI name is:" + ncp.getName());
12.     }
13. }
14. catch (NamingException e) {...}

最后的示例：

1. import java.util.*;
2. import javax.naming.*;
3. import javax.naming.directory.*;
4. import java.io.*;
5. public class ListAll {
6.     public static void main(java.lang.String[] args) {
7.         Hashtable env = new Hashtable();
8.         env.put(Context.INITIAL_CONTEXT_FACTORY,
9.             "weblogic.jndi.WLInitialContextFactory");
10.         env.put(Context.PROVIDER_URL, "t3://localhost:7001");
11.         try {
12.             InitialContext ctx = new InitialContext(env);
13.             NamingEnumeration enum = ctx.listBindings("");
14.             while(enum.hasMore()) {
15.                 Binding binding = (Binding) enum.next();
16.                 Object obj = (Object) binding.getObject();
17.                 System.out.println(obj);
18.             }
19.         } catch (NamingException e) {
20.         System.out.println(e);
21.         }
22.     } // end main
23. 
    
24. } // end List