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>

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