什么是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对象。
示例:
import java.util.*;
import javax.naming.*;
…
env.put(Context.INITIAL_CONTEXT_FACTORY, "weblogic.jndi.WLInitialContextFactory");
env.put(Context.PROVIDER_URL,"t3://localhost:7001");
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 | 口令。 |
更多的配置示例:
Hashtable env = new Hashtable();
env.put (Context.INITIAL_CONTEXT_FACTORY,
"weblogic.jndi.WLInitialContextFactory");
env.put(Context.PROVIDER_URL, "t3://localhost:7001");
env.put(Context.SECURITY_PRINCIPAL, "system");
env.put(Context.SECURITY_CREDENTIALS, "password here");
Properties env = new Properties();
env.setProperties ("java.naming.factory.initial",
"weblogic.jndi.WLInitialContextFactory");
env.setProperties("java.naming.provider.url" , "t3://localhost:7001");
env.setProperties("java.naming.security.principal" , "tommy");
env.setProperties("java.naming.security.credentials" ,"password here");
创建InitialContext:
Interfacesthatitimplements:javax.naming.Context
Constructors:
publicInitialContext();
publicInitialContext(Hashtableconfiguration);
publicInitialContext(Propertiesconfiguration);
以上所有方法都可能抛出NamingException。
一个Binding示例:
Hashtableenv=newHashtable();
env.put(Context.INITIAL_CONTEXT_FACTORY,
"weblogic.jndi.WLInitialContextFactory");
env.put(Context.PROVIDER_URL,"t3://localhost:7001");
InitialContextcontext=newInitialContext(env);
returncontext;
}
//Obtaintheinitialcontext
InitialContextinitialContext=getInitialContext();
//CreateaBankobject.
BankmyBank=newBank();
//BindtheobjectintotheJNDItree.
initialContext.rebind("theBank",myBank);
一个Lookup示例:
Hashtableenv=newHashtable();
env.put(Context.INITIAL_CONTEXT_FACTORY,
"weblogic.jndi.WLInitialContextFactory");
env.put(Context.PROVIDER_URL,"t3://localhost:7001");
InitialContextcontext=newInitialContext(env);
returncontext;
}
//Obtaintheinitialcontext
InitialContextinitialContext=getInitialContext();
//LookupanexistingBankobject.
BankmyBank=(Bank)initialContext.lookup("theBank");
可能发生的NamingException:
AuthenticationException
CommunicationException
InvalidNameException
NameNotFoundException
NoInitialContextException
枚举所有名字对象:
publicinterfaceNamingEnumerationextendsEnumeration{
publicbooleanhashMore()throwsNamingException;
publicObjectnext()throwsNamingException;
publicvoidclose()throwsNamingException;//jndi1.2
}
try{
…
NamingEnumerationenum=ctx.list("");
while(enum.hasMore()){
NameClassPairncp=(NameClassPair)enum.next();
System.out.println("JNDInameis:"+ncp.getName());
}
}
catch(NamingExceptione){…}
最后的示例:
importjavax.naming.*;
importjavax.naming.directory.*;
importjava.io.*;
publicclassListAll{
publicstaticvoidmain(java.lang.String[]args){
Hashtableenv=newHashtable();
env.put(Context.INITIAL_CONTEXT_FACTORY,
"weblogic.jndi.WLInitialContextFactory");
env.put(Context.PROVIDER_URL,"t3://localhost:7001");
try{
InitialContextctx=newInitialContext(env);
NamingEnumerationenum=ctx.listBindings("");
while(enum.hasMore()){
Bindingbinding=(Binding)enum.next();
Objectobj=(Object)binding.getObject();
System.out.println(obj);
}
}catch(NamingExceptione){
System.out.println(e);
}
}//endmain
}//endList