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

[align=center]Tomcat中数据源的配置及原理[/align]
一：数据源介绍
数据源简介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。
[align=left]二：配置数据源[/align]
[align=left]在Tomcat中配置数据源其实相当简单，可以配置单个应用的数据源，也可以配置整个容器的数据源。以下详细说明如何配置单个应用的数据源。[/align]
[align=left]1．准备工作[/align]

[align=left]Tomcat4.1.24 （其它版本也可以，原理相通的）[/align]

[align=left] 确认在%Tomcat _Home%/common/lib下有commons-collections.jar、commons-dbcp.jar、commons-pool.jar包（tomcat默认有这些包），如果没有，请到此地下载：http://tomcat.apache.org/ 。这三个包是必需的。[/align]

[align=left]下载相应数据库驱动，放在%Tomcat _Home%/common/lib下。本例以oracle数据库为例，使用的驱动包为：ojdbc14.jar[/align]

[align=left] 数据库为Oracle9i[/align]

[align=left]确认在%Tomcat _Home%/common/lib下有jndi.jar、dbc2_0-stdext.jar（tomcat默认有这些包）。[/align]

[align=left]2．配置单个应用的数据源[/align]
[align=left]2．1配置server.xml文件[/align]
[align=left]首先打开%Tomcat _Home%/conf下 server.xml文件，在相应的<Context＞中加入<Resource>元素，在<Context>（你的应用配置上下文）中加入以下代码（以oracle为例）：[/align]

[align=left]<Context path="/Exercise001" reloadable="true" docBase="D:/eclipse/workspace/Exercise001" workDir="D:/eclipse/workspace/Exercise001/work/org/apache/jsp" >[/align]
[align=left]<!-- my dataConnectionPool seting here start-->[/align]
[align=left]<Resource name="jdbc/myoracle" scope="Shareable" type="javax.sql.DataSource"/>[/align]
[align=left] <ResourceParams name="jdbc/myoracle">[/align]
[align=left] <parameter>[/align]
[align=left] <name>factory</name> [/align]
[align=left] <value>org.apache.commons.dbcp.BasicDataSourceFactory</value>[/align]
[align=left] </parameter>[/align]
[align=left] <parameter>[/align]
[align=left] <name>maxWait</name>[/align]
[align=left] <value>5000</value>[/align]
[align=left] </parameter>[/align]
[align=left] <parameter>[/align]
[align=left] <name>maxActive</name>[/align]
[align=left] <value>4</value>[/align]
[align=left] </parameter>[/align]
[align=left] <parameter>[/align]
[align=left] <name>password</name>[/align]
[align=left] <value>train</value>[/align]
[align=left] </parameter>[/align]
[align=left] <parameter>[/align]
[align=left] <name>url</name> [/align]
[align=left] <value>jdbc:oracle:thin:@database-cn:1521:train007</value>[/align]
[align=left] </parameter>[/align]
[align=left] <parameter>[/align]
[align=left] <name>driverClassName</name>[/align]

[align=left]注意：oracle9i以上加载此驱动，而其它版本加载：racle.jdbc.OracleDriver[/align]

<value>oracle.jdbc.driver.OracleDriver</value>
[align=left] </parameter>[/align]
[align=left] <parameter>[/align]
[align=left] <name>maxIdle</name>[/align]
[align=left] <value>2</value>[/align]
[align=left] </parameter>[/align]
[align=left] <parameter>[/align]
[align=left] <name>username</name>[/align]
[align=left] <value>train</value>[/align]
[align=left] </parameter>[/align]
[align=left] </ResourceParams>[/align]
[align=left] <!-- my datapool seting here end-->[/align]
[align=left]</Context>[/align]
[align=left] [/align]

[align=left]2．2< Resource >配置说明如下：[/align]

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

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

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

[align=left]2．3引用数据源[/align]
[align=left]如果在web应用中访问了由Servlet容器管理的某个JNDI Resource，则必须在web.xml中声明对这个JNDI Resource的引用。表示资源引用的元素为<resource-ref>,该元素加在<wepapp></ wepapp >中。[/align]
[align=left]打开你的应用配置文件web.xml,输入以下粗体部分：[/align]
[align=left]<wepapp>[/align]
[align=left]……[/align]
[align=left]<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>[/align]
[align=left]</ wepapp >[/align]
[align=left]2．4<resource-ref>元素的属性如下：[/align]

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

[align=left]2．5测试数据源[/align]
[align=left] 首先，检查Tomcat的%Tomcat _Home%/common/lib下有commons-collections.jar、commons-dbcp.jar、commons-pool.jar包，如果没现有，请到此地下载：http://tomcat.apache.org/ [/align]
[align=left] 注意以上三个包不要引入你的工程类路径，否则可能报错。[/align]
[align=left] 然后，将驱动包放入%Tomcat _Home%/common/lib下，注意包必须为.jar后缀。Tomcat只认.jar包。[/align]
[align=left]配置完成后，写个测试，如下：[/align]
[align=left]<%@ 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();[/align]
%>
</body>
</html>
[align=left]如果输出你期望的结果，表示数据源配置成功。[/align]
[align=left]3．配置容器全局数据源[/align]

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

[align=left] 3.1 配置server.xml文件[/align]
[align=left]首先打开%Tomcat _Home%/conf下 server.xml文件，在<GlobalNamingResources>下输入以下粗体部分：[/align]
[align=left]<GlobalNamingResources>[/align]
[align=left]……[/align]
[align=left]<!-- my dataConnectionPool seting here start-->[/align]
[align=left]<Resource name="jdbc/myoracle" scope="Shareable" type="javax.sql.DataSource"/>[/align]
[align=left]<ResourceParams name="jdbc/myoracle">[/align]
[align=left] <parameter>[/align]

[align=center]此属性必需[/align]

<name>factory</name> <value>org.apache.commons.dbcp.BasicDataSourceFactory</value>
[align=left] </parameter>[/align]
[align=left] <parameter>[/align]
[align=left] <name>maxWait</name>[/align]
[align=left] <value>5000</value>[/align]
[align=left] </parameter>[/align]
[align=left] <parameter>[/align]
[align=left] <name>maxActive</name>[/align]
[align=left] <value>4</value>[/align]
[align=left] </parameter>[/align]
[align=left] <parameter>[/align]
[align=left] <name>password</name>[/align]
[align=left] <value>train</value>[/align]
[align=left] </parameter>[/align]
[align=left] <parameter>[/align]
[align=left] <name>url</name> <value>jdbc:oracle:thin:@database-cn:1521:train007</value>[/align]
[align=left] </parameter>[/align]
[align=left] <parameter>[/align]

[align=left]注意：oracle9i以上加载此驱动，而其它版本加载：racle.jdbc.OracleDriver[/align]

<name>driverClassName</name>
[align=left] <value>oracle.jdbc.driver.OracleDriver</value>[/align]
[align=left] </parameter>[/align]
[align=left] <parameter>[/align]
[align=left] <name>maxIdle</name>[/align]
[align=left] <value>2</value>[/align]
[align=left] </parameter>[/align]
[align=left] <parameter>[/align]
[align=left] <name>username</name>[/align]
[align=left] <value>train</value>[/align]
[align=left] </parameter>[/align]
[align=left] </ResourceParams>[/align]
[align=left] <!-- my datapool seting here end-->[/align]
[align=left]</GlobalNamingResources>[/align]
[align=left]3.2 引用数据源[/align]
由于我们配置的是容器全局数据源，因此所有的应用都可以引用这个数据源。在你的应用中建立引用，在<Context></Context>之间输入以下粗体部分：
<Context path="/Exercise001" reloadable="true" docBase="D:/eclipse/workspace/Exercise001" workDir="D:/eclipse/workspace/Exercise001/work/org/apache/jsp" >
[align=left]<ResourceLink name="myDB" [/align]
[align=left] global="jdbc/myoracle"[/align]
type="javax.sql.DataSource"/>
[align=left]</Context>[/align]
[align=left]3．3 配置应用文件web.xml[/align]
[align=left]打开你的应用配置文件web.xml,输入以下粗体部分：[/align]
[align=left]<wepapp>[/align]
[align=left]……[/align]
[align=left]<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>[/align]
[align=left]</ wepapp >[/align]
[align=left] 3．4测试[/align]
[align=left] 创建测试文件：[/align]
<%@ 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>
[align=left]如果输出你期望的结果，表示数据源配置成功。[/align]