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