Tomcat 6中配置JNDI简单示例
本想在晚上找个示例学习学习，结果一直不会弄，知道刚才看了tomcat的官方站点里面的介绍，才终于配置成功，所以大家可以参考tomcat站点上的介绍说明，还是挺不错的，除了jdbc datasource还有其他形式的，这是地址：http://tomcat.apache.org/tomcat-6.0-doc/jndi-resources-howto.html
好了，下面开始：
简单说一下我对JNDI目前的简单理解：最初我学习JDBC的时候是将连接信息用硬编码的形式写在类里面的，当然，我当时还是小白，后来为了方便就将这些信息放在一个properties文件中，这样以来，就实现了代码和配置相分离的结果。然后学习Hibernate的时候也是类似，将配置信息存放在xml中。这些方式虽然实现了分离，没错，不过还有分离的更清楚的方式，就是JNDI了，为什么说分离的更清楚？因为我们将系统部署好以后开始运行，在运行过程中要修改这些配置信息很简单吧，去部署好的项目里面找到该配置文件改就行了，不过，好的实现应该是将这些信息不放在项目中，而是放在容器中。Tomcat，JBoss等都可以，那么Administrator，deployer或者DBA需要修改信息的时候，根本就不用去动项目，而是去使用的容器里面去修改。因此，这里使用JNDI将JDBC的配置信息配置在Tomcat中可以更好的实现代码和配置分离。
示例环境：tomcat6+myeclipse6.5+SqlServer2005
- 针对单个WEB应用配置JNDI Resource
步骤：
1-因为此时需要由tomcat提供连接信息，所以这里要将SqlServer的驱动放在tomcat里面，因为我使用的是Tomcat6，所以存放的地方应该是%CATALINA_HOME%\lib。
2-在Tomcat中配置资源信息，这里配置的是JDBC连接信息，在Tomcat的server.xml文件中添加资源信息
1 <Context path="/jndi" docBase="D:\workspace\jndi\WebRoot" reloadable="true"> 2 <Resource name="jdbc/jndi_demo" 3 auth="Container" 4 type="javax.sql.DataSource" 5 username="sa" 6 password="java" 7 driverClassName="com.microsoft.sqlserver.jdbc.SQLServerDriver" 8 url="jdbc:sqlserver://localhost:1433;databaseName=demo_jndi" 9 maxActive="8" 10 maxIdle="4"/> 11 </Context>
我使用的是虚拟目录的方式部署的WEB项目，因此我将配置信息放在了Context节点下面。
在添加的Resource节点中我们配置了JDBC的相关信息，有URL，Driver，username，password还有pool的部分信息，详细属性可以参考tomcat的文档，地址上面给出了。
3-配置好JDBC信息后就可以使用这些信息了，我新建了一个Servlet来操作Connection，代码如下：
1 package servlet; 2 3 import java.sql.Connection; 4 import java.sql.PreparedStatement; 5 6 import javax.naming.Context; 7 import javax.naming.InitialContext; 8 import javax.servlet.http.HttpServlet; 9 import javax.sql.DataSource; 10 11 public class ConnectionTest extends HttpServlet { 12 13 @Override 14 public void init() { 15 16 Connection con = null; 17 PreparedStatement pst = null; 18 try { 19 Context initContext = new InitialContext(); 20 Context envContext = (Context) initContext.lookup("java:comp/env"); 21 22 DataSource ds = (DataSource) envContext.lookup("jdbc/jndi_demo"); 23 24 String sql_insert = "insert tb_user values(?,?,?)"; 25 26 con = ds.getConnection(); 27 28 pst = con.prepareStatement(sql_insert); 29 30 pst.setString(1, "zhangsan"); 31 pst.setInt(2, 1); 32 pst.setString(3, "用户张三的信息"); 33 34 int resultCount = pst.executeUpdate(); 35 36 System.out.println(resultCount); 37 38 } catch (Exception e) { 39 e.printStackTrace(); 40 System.out.println("操作失败"); 41 } finally { 42 try { 43 pst.close(); 44 con.close(); 45 } catch (Exception e) { 46 System.out.println("关闭失败"); 47 } 48 } 49 50 } 51 52 }
执行完成之后数据库中就有一条记录
--------------------------------
zhangsan 1 用户张三的信息
--------------------------------
说明执行成功！以上就是为单个WEB应用配置JDBC JNDI信息的简单过程。下面是配置可以供所有WEB应用共享的全局Resource信息
- 配置全局的JNDI数据源
将上面配置在特定应用<Context>节点下的<Resource>节点信息放到上面的<GlobalNamingResources>节点里面，即：
1 <GlobalNamingResources> 2 <!-- Editable user database that can also be used by 3 UserDatabaseRealm to authenticate users 4 --> 5 <Resource name="UserDatabase" auth="Container" 6 type="org.apache.catalina.UserDatabase" 7 description="User database that can be updated and saved" 8 factory="org.apache.catalina.users.MemoryUserDatabaseFactory" 9 pathname="conf/tomcat-users.xml" /> 10 11 12 <Resource name="jdbc/jndi_demo" 13 auth="Container" 14 type="javax.sql.DataSource" 15 username="sa" 16 password="java" 17 18 driverClassName="com.microsoft.sqlserver.jdbc.SQLServerDriver" 19 url="jdbc:sqlserver://localhost:1433;databaseName=demo_jndi" 20 maxActive="8" 21 maxIdle="4"/> 22 23 </GlobalNamingResources>
这样就将JNDI数据源Resource添加到了全局环境中，而某个WEB应用如若需要引用该全局数据源的话只需要给<Context>节点内添加以下内容即可：
1 <ResourceLink name="jdbc/jndi_demoClass" global="jdbc/jndi_demo" type="javax.sql.DataSource"/>
ResourceLink表明这里引用了一个全局数据源
其中name属性是该引用的名称，这个可以可以和全局环境中生命好的Resource里面的name不一致，但是必须和程序里面使用的名称一致
global属性指明要引用哪个全局数据源，因此这个名称必须和全局环境中的Resource的name一致。
只需要这两步就成功的配置了全局JNDI数据源。
不过官方文档里面说还要给WEB应用下WEB-INF/web.xml里面要添加下面的内容：
1 <resource-ref> 2 <description> 3 Resource reference to a factory for java.sql.Connection 4 instances that may be used for talking to a particular 5 database that is configured in the <Context> 6 configurartion for the web application. 7 </description> 8 <res-ref-name> 9 jdbc/EmployeeDB 10 </res-ref-name> 11 <res-type> 12 javax.sql.DataSource 13 </res-type> 14 <res-auth> 15 Container 16 </res-auth> 17 </resource-ref>
不过我没有添加也可以配置成功并且可以访问数据。因此不知道这个节点信息起的作用是什么，各位路过的大牛如果有知道的话劳烦告诉一下在下。
如果上面内容有不正确的地方，还希望各位大牛为在下指出，改正，或者有更好的内容也可以 给在下提示一下，让在下可以多学习学习，在此表示感谢！！！
注：本示例参考了apache tomcat的官方文档http://tomcat.apache.org/tomcat-6.0-doc/jndi-resources-howto.html
