一、JNDI 名词解释
JNDI 是Java 命名和目录接口(Java Naming and Directory Interface,JNDI)的简称.从一开始就一直是 Java 2 平台企业版(JEE)的核心技术之一。在JMS,JMail,JDBC,EJB等技术中,就大量应用的这种技术。
命名服务:它提供了为给定的数据集创建一个标准名字的能力。它允许把名称同Java对象或资源关联起来,而不必指出对象或资源的物理ID。基本的名字操作包含在Context接口中。
目录服务:目录服务是一种特殊类型的数据库,与SQL Server、Access、Oracle等关系数据库管理系统相反,构造目录服务的目的是为了处理基于行为的事务,并且使用一种关系信息模型。基本的目录服务操作包含在DirContext接口中。
JNDI 的架构与实现
JNDI 的服务提供者
一个服务提供者就是一组Java类的集合,它支持开发者同目录服务进行通信,其方式类似于JDBC驱动程序与数据库之间的通信方式。能够用于JNDI的服务提供者必须实现Context接口或Context的扩展接口Directory- Context。
在使用JNDI时,读者只需要了解JNDI,而服务提供者才关注实际的网络协议、编码/解码值等细节。
当下载SDK软件开发包时,同时就下载了Sun公司的一些现有的服务提供者。这些服务提供者包括LDAP、NIS、COS(CORBA对象服务)、RMI注册及文件系统的提供者。如:hashtableObj.put(Context.INITIAL_CONTEXT_FACTORY,"com.sun.jndi.ldap.ldapCtx- Fatory")就是表示使用Sun LDAP服务提供者。当然如果要使用IBM服务提供者时就可以用com.ibm.jndi.LDAPCtxFatory来代替com.sun.jndi.ldap.ldapCtxFatory。
JNDI 的包
JNDI 包含5个包
· javax.naming:主要用于命名操作,它包含了命名服务的类和接口,该包定义了Context接口和InitialContext类;
· javax.naming.directory:主要用于目录操作,它定义了DirContext接口和InitialDir- Context类;
· javax.naming.event:在命名目录服务器中请求事件通知;
· javax.naming.ldap:提供LDAP支持;
· javax.naming.spi:允许动态插入不同实现,为不同命名目录服务供应商的开发人员提供开发和实现的途径,以便应用程序通过JNDI可以访问相关服务。
常用的 JNDI 操作
常用的JNDI操作如下:
void bind(String sName,Object object),绑定:把名称同对象关联的过程。 void rebind(String sName,Object object),重新绑定:用来把对象同一个已经存在的名称重新绑定。一般使用rebind()而不使用bind(),因为当有重名的时候rebind()不会出现异常,而bind()会报异常。 void unbind(String sName),释放:用来把对象从目录中释放出来。 void lookup(String sName,Object object),查找:返回目录总的一个对象。 void rename(String sOldName,String sNewName),重命名:用来修改对象名称绑定的名称。 NamingEnumeration listBindings(String sName),清单:返回绑定在特定上下文中指定属性名对象的清单列表,它返回名字、类和对象本身,它用于那些需要对
具体使用情况如下:
//得到初始目录环境的一个引用 Context cntxt = new InitialContext(); //返回绑定在特定上下文中指定属性名对象的清单列表 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(); }
NamingEnumeration list(String sName)与listBindings(String sName)相似,只是它只返回一系列名字/类映射,它主要是用于上下文浏览应用。
二、JNDI 配置
配置 JNDI 资源
复制 JBoss 文档的数据库引用的数据源定义模板到 JBoss 服务器。 $DOC_HOME/docs/examples/jca/mysql-ds.xml ---> $Server_HOME/server/default/deploy.
修改 mysql-ds.xml 文件的内容,使之能通过JDBC正确访问你的MySQL数据库,如下:
<?xml version="1.0" encoding="UTF-8"?> <datasources> <local-tx-datasource> <jndi-name>MySqlDS</jndi-name> <connection-url>jdbc:mysql://localhost:3306/demo</connection-url> <driver-class>com.mysql.jdbc.Driver</driver-class> <user-name>root</user-name> <password>rootpassword</password> <exception-sorter-class-name>org.jboss.resource.adapter.jdbc.vendor.MySQLExceptionSorter</exception-sorter-class-name> <metadata> <type-mapping>mySQL</type-mapping> </metadata> </local-tx-datasource> </datasources>
配置 JNDI 资源引用
为了让 JNDI 解析 java:comp/env/jdbc/mydatasource
引用,必须把 <resource-ref>
标签插入 web.xml 文件(Web 应用程序的部署描述符)
<resource-ref>: 资源引用,一般声明管理资源,如数据库驱动程序、JavaMail 会话、自定义类工厂等。
<resource-env-ref>: 资源环境引用,在Servlet 2.4里用来简化设置不需认证信息的资源环境,一般声明与资源相关的被管理对象,如环境参数、resource-ref变量。
<resource-ref> <res-ref-name>jdbc/mydatasource</res-ref-name> <jndi-name>java:MySqlDS</jndi-name> // 指向真实的 JNDI name <res-type>javax.sql.DataSource</res-type> <res-auth>Container</res-auth> </resource-ref>
<resource-ref>
入口告诉 servlet 容器,部署人员要在 组件命名上下文(component naming context) 中设置一个叫做 jdbc/mydatasource
的资源。组件命名上下文由前缀 java:comp/env/
表示,所以完全限定的本地资源名称是: java:comp/env/jdbc/mydatasource
.
使用 JNDI 得到数据源
Connection conn=null; try { Context ctx=new InitialContext(); Object datasourceRef=ctx.lookup("java:comp/env/jdbc/mydatasource"); DataSource ds=(Datasource)datasourceRef; Connection c=ds.getConnection(); /* use the connection */ c.close(); } catch(Exception e) { e.printStackTrace(); } finally { if(conn!=null) { try { conn.close(); } catch(SQLException e) { } } }
外部资源链接:
详解JNDI的lookup资源引用java:/comp/env
Apache Tomcat 5.5 Servlet/JSP 容器