Tomcat中详细配置数据源及其原理解析

Tomcat中数据源的配置及原理

一：数据源介绍

数据源简介JDBC2.0提供了javax.sql.DataSource的接口，负责与数据库建立连接，实际应用时不需要编写连接数据库代码，可以直接从数据源获得数据库的连接，使得应用于数据库的耦合降低。Dataource中事先建立了多个数据库连接，这些数据库连接保持在数据库连接池中，当程序访问数据库时，只需要从连接池从取出空闲的连接，访问数据库结束，在将这些连接归还给连接池。DataSource对象由容器（Tomcat）提供，不能使用创建实例的方法来生成DataSource对象，要采用JAVA的JNDI（Java Nameing and Directory Interface，java命名和目录接口）来获得DataSource对象的引用。（另有一种说法：“其实从技术上来说，数据源连接方式是不需要目录服务的，我们同样可以通过序列化数据源对象直接访问文件系统。这点是需要明确的。”感兴趣的朋友可以试试。）JNDI是一种将对象和名字绑定的技术，对象工厂负责生产出对象，这些对象都和唯一的名字相绑定。程序中可以通过这个名字来获得对象的引用。Tomcat把DataSource作为一种可配置的JNDI资源来处理，生成DataSource对象的工厂为org.apache.comm.ons.dbcp.BasicDataSourceFactory。

二：配置数据源

在Tomcat中配置数据源其实相当简单，可以配置单个应用的数据源，也可以配置整个容器的数据源。以下详细说明如何配置单个应用的数据源。

1．准备工作

• Tomcat4.1.24 （其它版本也可以，原理相通的）
•   确认在%Tomcat _Home%/common/lib下有commons-collections.jar、commons-dbcp.jar、commons-pool.jar包（tomcat默认有这些包），如果没有，请到此地下载：http://tomcat.apache.org/ 。这三个包是必需的。
• 下载相应数据库驱动，放在%Tomcat _Home%/common/lib下。本例以oracle数据库为例，使用的驱动包为：ojdbc14.jar
•   数据库为Oracle9i
• 确认在%Tomcat _Home%/common/lib下有jndi.jar、dbc2_0-stdext.jar（tomcat默认有这些包）。

2．配置单个应用的数据源

2．1配置server.xml文件

首先打开%Tomcat _Home%/conf下 server.xml文件，在相应的<Context＞中加入<Resource>元素，在<Context>（你的应用配置上下文）中加入以下代码（以oracle为例）：

 

<Context path="/Exercise001" reloadable="true" docBase="D:/eclipse/workspace/Exercise001" workDir="D:/eclipse/workspace/Exercise001/work/org/apache/jsp" >

<!-- my dataConnectionPool seting here start-->

<Resource name="jdbc/myoracle" scope="Shareable" type="javax.sql.DataSource"/>

         <ResourceParams name="jdbc/myoracle">

                      <parameter>

                                 <name>factory</name>                                                                            

                                 <value>org.apache.commons.dbcp.BasicDataSourceFactory</value>

                      </parameter>

                      <parameter>

                                <name>maxWait</name>

                               <value>5000</value>

                      </parameter>

                      <parameter>

                                  <name>maxActive</name>

                                  <value>4</value>

                      </parameter>

                      <parameter>

                                 <name>password</name>

                                  <value>train</value>

                      </parameter>

                      <parameter>

                                  <name>url</name>                                     

                                  <value>jdbc:oracle:thin:@database-cn:1521:train007</value>

                      </parameter>

                      <parameter>

                                  <name>driverClassName</name>

 

注意：oracle9i以上加载此驱动，而其它版本加载：racle.jdbc.OracleDriver

                                  <value>oracle.jdbc.driver.OracleDriver</value>

 

                      </parameter>

                      <parameter>

                                 <name>maxIdle</name>

                                  <value>2</value>

                      </parameter>

                      <parameter>

                                  <name>username</name>

                                  <value>train</value>

                      </parameter>

           </ResourceParams>

           <!-- my datapool seting here end-->

</Context>

 

 

2．2< Resource >配置说明如下：

属性	描述
name	指定Resource的JNDI的名字
auth	指定管理Resource的Manager，由两个可选值：Container和Application。Container表示由容器来创建和管理Resource，Application表示由WEB应用来创建和管理Resource。如果在web application deployment descriptor中使用<resource-ref>，这个属性是必需的，如果使用<resource-env-ref>，这个属性是可选的。
type	指定Resource所属的java类名

2.3<ResourceParams>元素的属性如下：

属性	描述
name	指定ResourceParams的JNDI的名字，必须和Resource的name保持一致
factory	指定生成DataSource对象的factory的类名
maxActive	指定数据库连接池中处于活动状态的数据库连接最大数目，0表示不受限制
maxIdle	指定数据库连接池中处于空闲状态的数据库连接的最大数目，0表示不受限制
maxWait	指定数据库连接池中的数据库连接处于空闲状态的最长时间（单位为毫秒），超过这一事件，将会抛出异常。-1表示可以无限期等待。
username	指定连接数据库的用户名
password	指定连接数据库的密码
driverClassName	指定连接数据库的JDBC驱动程序
url	指定连接数据库的URL

2．3引用数据源

如果在web应用中访问了由Servlet容器管理的某个JNDI Resource，则必须在web.xml中声明对这个JNDI Resource的引用。表示资源引用的元素为<resource-ref>,该元素加在<wepapp></ wepapp >中。

打开你的应用配置文件web.xml,输入以下粗体部分：

<wepapp>

……

<resource-ref>
<descryiption>DB Connection</descryiption>
<res-ref-name> jdbc/myoracle </res-ref-name>
<res-type>javax.sql.DataSource </res- type>
<res-auth>Container </res-auth>
</resource-ref>

</ wepapp >

2．4<resource-ref>元素的属性如下：

属性	描述
description	对所引用的资源的说明
res-ref-name	指定所引用资源的JNDI名字，与<Resource>元素中的name属性保持一致
res-type	指定所引用资源的类名字，与<Resource>元素中的type属性保持一致
res-auth	指定所引用资源的Manager，与<Resource>元素中的auth属性保持一致

2．5测试数据源

     首先，检查Tomcat的%Tomcat _Home%/common/lib下有commons-collections.jar、commons-dbcp.jar、commons-pool.jar包，如果没现有，请到此地下载：http://tomcat.apache.org/

     注意以上三个包不要引入你的工程类路径，否则可能报错。

     然后，将驱动包放入%Tomcat _Home%/common/lib下，注意包必须为.jar后缀。Tomcat只认.jar包。

配置完成后，写个测试，如下：

<%@ page language="java" import="java.util.*" pageEncoding="UTF-8"%>
<%@ page import="java.sql.*"%>
<%@ page import="javax.naming.*"%>
<%@ page import="javax.sql.*"%>
<!DOCTYPE HTML PUBLIC "-//W3C//DTD 
HTML 4.01 Transitional//EN">
<html>
<head>
</head>
<body>
<%
Context initContext = new InitialContext();
Context envContext = (Context) initContext.lookup("java:/comp/env");
DataSource db = (DataSource)envContext.lookup("jdbc/myoracle ");


Connection conn = db.getConnection( );
Statement stmt = conn.createStatement();
ResultSet rs = stmt.executeQuery("SELECT * FROM test");
while(rs.next()){
out.print(rs.getString("admin_name")+" ");
out.print(rs.getString("admin_password")+"<br>");
}
rs.close();
stmt.close();
conn.close();

%>
</body>
</html>

如果输出你期望的结果，表示数据源配置成功。

3．配置容器全局数据源

   以上，配置的数据源为单个应用使用的数据源，只能为单个应用所使用，下面我们配置全局的数据源，所有的应用都可以使用，通过引用很自然的使用全局数据源。准备工作同上。

          3.1 配置server.xml文件

首先打开%Tomcat _Home%/conf下 server.xml文件，在<GlobalNamingResources>下输入以下粗体部分：

<GlobalNamingResources>

……

<!-- my dataConnectionPool seting here start-->

<Resource name="jdbc/myoracle" scope="Shareable" type="javax.sql.DataSource"/>

<ResourceParams name="jdbc/myoracle">

                      <parameter>

 

此属性必需

                                 <name>factory</name>                                                                            <value>org.apache.commons.dbcp.BasicDataSourceFactory</value>

 

                      </parameter>

                      <parameter>

                      <name>maxWait</name>

                      <value>5000</value>

                      </parameter>

                      <parameter>

                                  <name>maxActive</name>

                                  <value>4</value>

                      </parameter>

                      <parameter>

                                 <name>password</name>

                                  <value>train</value>

                      </parameter>

                      <parameter>

                                  <name>url</name>                                      <value>jdbc:oracle:thin:@database-cn:1521:train007</value>

                      </parameter>

                      <parameter>

 

注意：oracle9i以上加载此驱动，而其它版本加载：racle.jdbc.OracleDriver

                                  <name>driverClassName</name>

 

                                  <value>oracle.jdbc.driver.OracleDriver</value>

                      </parameter>

                      <parameter>

                                 <name>maxIdle</name>

                                  <value>2</value>

                      </parameter>

                      <parameter>

                                  <name>username</name>

                                  <value>train</value>

                      </parameter>

           </ResourceParams>

           <!-- my datapool seting here end-->

</GlobalNamingResources>

3.2 引用数据源

由于我们配置的是容器全局数据源，因此所有的应用都可以引用这个数据源。在你的应用中建立引用，在<Context></Context>之间输入以下粗体部分：

<Context path="/Exercise001" reloadable="true" docBase="D:/eclipse/workspace/Exercise001" workDir="D:/eclipse/workspace/Exercise001/work/org/apache/jsp" >

<ResourceLink name="myDB"

                       global="jdbc/myoracle"

                       type="javax.sql.DataSource"/>

</Context>

3．3 配置应用文件web.xml

打开你的应用配置文件web.xml,输入以下粗体部分：

<wepapp>

……

<resource-ref>
<descryiption>DB Connection</descryiption>
<res-ref-name>myDB</res-ref-name>
<res-type>javax.sql.DataSource </res- type>
<res-auth>Container </res-auth>
</resource-ref>

</ wepapp >

  3．4测试

  创建测试文件：

<%@ page language="java" import="java.util.*" pageEncoding="UTF-8"%>
<%@ page import="java.sql.*"%>
<%@ page import="javax.naming.*"%>
<%@ page import="javax.sql.*"%>
<!DOCTYPE HTML PUBLIC "-//W3C//DTD 
HTML 4.01 Transitional//EN">
<html>
<head>
</head>
<body>
<%
Context initContext = new InitialContext();
Context envContext = (Context) initContext.lookup("java:/comp/env");
DataSource db = (DataSource)envContext.lookup("myDB ");//名称与web.xml配置中的一致


Connection conn = db.getConnection( );
Statement stmt = conn.createStatement();
ResultSet rs = stmt.executeQuery("SELECT * FROM test");
while(rs.next()){
out.print(rs.getString("admin_name")+" ");
out.print(rs.getString("admin_password")+"<br>");
}
rs.close();
stmt.close();
conn.close();

%>
</body>
</html>

如果输出你期望的结果，表示数据源配置成功。