Tomcat 6中配置JNDI简单示例

sweli

　　本想在晚上找个示例学习学习，结果一直不会弄，知道刚才看了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