JNDI 配置：JBoss + MySQL
一、JNDI 名词解释
JNDI 是Java 命名和目录接口（Java Naming and Directory Interface，JNDI）的简称.从一开始就一直是 Java 2 平台企业版（JEE）的核心技术之一。在JMS，JMail,JDBC,EJB等技术中，就大量应用的这种技术。
命名服务：它提供了为给定的数据集创建一个标准名字的能力。它允许把名称同Java对象或资源关联起来，而不必指出对象或资源的物理ID。基本的名字操作包含在Context接口中。
目录服务：目录服务是一种特殊类型的数据库，与SQL Server、Access、Oracle等关系数据库管理系统相反，构造目录服务的目的是为了处理基于行为的事务，并且使用一种关系信息模型。基本的目录服务操作包含在DirContext接口中。
一个服务提供者就是一组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
