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文件中添加资源信息

<Context path="/jndi" docBase="D:\workspace\jndi\WebRoot" reloadable="true">
	<Resource name="jdbc/jndi_demo"
            auth="Container"
            type="javax.sql.DataSource"
            username="sa"
            password="java"
            driverClassName="com.microsoft.sqlserver.jdbc.SQLServerDriver"
            url="jdbc:sqlserver://localhost:1433;databaseName=demo_jndi"
            maxActive="8"
            maxIdle="4"/>
</Context>

 

我使用的是虚拟目录的方式部署的WEB项目，因此我将配置信息放在了Context节点下面。

在添加的Resource节点中我们配置了JDBC的相关信息，有URL，Driver，username，password还有pool的部分信息，详细属性可以参考tomcat的文档，地址上面给出了。

3-配置好JDBC信息后就可以使用这些信息了，我新建了一个Servlet来操作Connection，代码如下：

package servlet;

import java.sql.Connection;
import java.sql.PreparedStatement;

import javax.naming.Context;
import javax.naming.InitialContext;
import javax.servlet.http.HttpServlet;
import javax.sql.DataSource;

public class ConnectionTest extends HttpServlet {

	@Override
	public void init() {

		Connection con = null;
		PreparedStatement pst = null;
		try {
			Context initContext = new InitialContext();
			Context envContext = (Context) initContext.lookup("java:comp/env");

			DataSource ds = (DataSource) envContext.lookup("jdbc/jndi_demo");

			String sql_insert = "insert tb_user values(?,?,?)";

			con = ds.getConnection();

			pst = con.prepareStatement(sql_insert);

			pst.setString(1, "zhangsan");
			pst.setInt(2, 1);
			pst.setString(3, "用户张三的信息");

			int resultCount = pst.executeUpdate();

			System.out.println(resultCount);

		} catch (Exception e) {
			e.printStackTrace();
			System.out.println("操作失败");
		} finally {
			try {
				pst.close();
				con.close();
			} catch (Exception e) {
				System.out.println("关闭失败");
			}
		}

	}

}

 

执行完成之后数据库中就有一条记录

--------------------------------

zhangsan 1 用户张三的信息

--------------------------------

说明执行成功！以上就是为单个WEB应用配置JDBC JNDI信息的简单过程。下面是配置可以供所有WEB应用共享的全局Resource信息

•  配置全局的JNDI数据源

将上面配置在特定应用<Context>节点下的<Resource>节点信息放到上面的<GlobalNamingResources>节点里面，即：

<GlobalNamingResources>
    <!-- Editable user database that can also be used by
         UserDatabaseRealm to authenticate users
    -->
    <Resource name="UserDatabase" auth="Container"
              type="org.apache.catalina.UserDatabase"
              description="User database that can be updated and saved"
              factory="org.apache.catalina.users.MemoryUserDatabaseFactory"
              pathname="conf/tomcat-users.xml" />


	<Resource name="jdbc/jndi_demo"
            auth="Container"
            type="javax.sql.DataSource"
            username="sa"
            password="java"
            driverClassName="com.microsoft.sqlserver.jdbc.SQLServerDriver"
            url="jdbc:sqlserver://localhost:1433;databaseName=demo_jndi"
            maxActive="8"
            maxIdle="4"/>

  </GlobalNamingResources>

 

这样就将JNDI数据源Resource添加到了全局环境中，而某个WEB应用如若需要引用该全局数据源的话只需要给<Context>节点内添加以下内容即可：

<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里面要添加下面的内容：

<resource-ref>
  <description>
    Resource reference to a factory for java.sql.Connection
    instances that may be used for talking to a particular
    database that is configured in the <Context>
    configurartion for the web application.
  </description>
  <res-ref-name>
    jdbc/EmployeeDB
  </res-ref-name>
  <res-type>
    javax.sql.DataSource
  </res-type>
  <res-auth>
    Container
  </res-auth>
</resource-ref>

 

不过我没有添加也可以配置成功并且可以访问数据。因此不知道这个节点信息起的作用是什么，各位路过的大牛如果有知道的话劳烦告诉一下在下。

 

 

如果上面内容有不正确的地方，还希望各位大牛为在下指出，改正，或者有更好的内容也可以 给在下提示一下，让在下可以多学习学习，在此表示感谢！！！

注：本示例参考了apache tomcat的官方文档http://tomcat.apache.org/tomcat-6.0-doc/jndi-resources-howto.html