Tomcat4.1.31的数据库连接池配置

(摘自JAVA中文站)

本文是作者在配置廖兄的blog时用到的，刚开始使用Tomcat5.0.27，后又使用Tomcat5.5.4，但是配置数据库总有错误，后来发现时context标志被取消的缘故。吾本性情中人，搞不定就换，于是就使用Tomcat4.1.31。主要参考FanyHan等人的相关文章，介绍了Tomcat4.1.31这个版本下数据库连接池的配置，及程序对连接池的JNDI查找，并提供相应测试代码。最后指出配置及应用过程中的常见问题及解决方法。

一、 Tomcat简介
Tomcat是Apache Jakarta的子项目之一，是Sun公司推荐的JSP、Servlet容器。作为一款优秀的应用服务器，Tomcat提供了数据库连接池、SSL、Proxy等许多通用组件功能，其中连接池是4.0以上版本的新增功能，应用非常广泛。
二、 该文配置环境
Tomcat4.1.31 + jdk1.4.2 + Sql Server 2000 + Win2000 AS
三、 对Tomcat4.1.31的DBCP配置
这里，将连接池置于tomcat的工程目录中的blog子文件夹（新建）下，JNDI名设为jdbc/blog，数据库服务器IP为localhost，SID为blog，配置步骤如下。
第一步：配置server.xml
在server.xml中找到
<!-- Tomcat Root Context -->
<!?
<Context path="" docBase="ROOT" debug="0"/>
-->
将其改为：
<Context path="/blog" docBase="blog" debug="0" reloadable="true">
<Resource name="jdbc/blog" auth="Container" type="javax.sql.DataSource"/>
<ResourceParams name="jdbc/blog">
<parameter>
<name>factory</name>
<value>org.apache.commons.dbcp.BasicDataSourceFactory</value>
</parameter>
<parameter>
<name>driverClassName</name>
<value>com.microsoft.jdbc.sqlserver.SQLServerDriver</value>
</parameter>
<parameter>
<name>url</name> <value>jdbc:microsoft:sqlserver://localhost:1433;databaseName=blog</value>
</parameter>
<parameter>
<name>username</name>
<value>sa</value>
</parameter>
<parameter>
<name>password</name>
<value>sa</value>
</parameter>
<parameter>
<name>maxActive</name>
<value>20</value>
</parameter>
<parameter>
<name>maxIdle</name>
<value>20</value>
</parameter>
<parameter>
<name>maxWait</name>
<value>-1</value>
</parameter>
</ResourceParams>
</Context>
参数说明：
Resource项：
<Resource　name="jdbc/blog" auth="Container" type="javax.sql.DataSource"/>
Resource项（即连接池的DataSource对象），有3个属性name、auth、type，name项是JNDI的名称定义，程序通过JNDI才能找到此对象，这里取名jdbc/Sblog；auth项即连接池管理权属性，这里取值Container，申明为容器管理；type项即对象的类型，这里取值javax.sql.DataSource，申明为数据库连接池。
在接下来的<ResourceParams>域内容里包含四个参数user、password、driverClassName、driverName，依次为数据库的用户名、密码、JDBC驱动和数据库地址。
factory参数：
<parameter>
<name>factory</name>
<value>org.apache.commons.dbcp.BasicDataSourceFactory</value>
</parameter>
即基础对象工厂，这里取值org.apache.commons.dbcp.BasicDataSourceFactory，即DBCP自带的工厂，也可以用别的。
DriverClassName参数：
<parameter>
<name>driverClassName</name>
<value>com.microsoft.jdbc.sqlserver.SQLServerDriver</value>
</parameter>
即数据库的JDBC驱动名称，具体值为：
　　　　 Sql Server 2000: com.microsoft.jdbc.sqlserver.SQLServerDriver
首先要下载安装sqlserver-jdbc-驱动，然后将其lib下的三个jar文件放到
tomcat/common/lib下。
MySql：　　　　　org.gjt.mm.mysql.Driver
MySql的JDBC驱动包mm.mysql-2.0.14.jar。
Oracle8.1.7： oracle.jdbc.driver.OracleDriver
Oracle8.1.7的JDBC驱动包名叫classes.jar，一般位于Oracle安装目录下的ora81/jdbc/lib目录下，初始扩展名为ZIP，需要手工把classes.zip改名为classes.jar，并放到tomcat/common/lib下。oracle.jdbc.driver.OracleDriver此类由classes.jar提供。
url参数：
<parameter>
<name>url</name>
<value>jdbc:microsoft:sqlserver://localhost:1433;databaseName=blog</value>
</parameter>
即数据库的地址。（不同的数据库其地址都不相同）
username参数：
<parameter>
<name>username</name>
<value>sa</value>
</parameter>
即连接数据库的用户名。
password参数：
<parameter>
<name>password</name>
<value>**</value>
</parameter>
即连接数据库的密码。
maxActive、maxIdle和maxWait参数：
<parameter>
<name>maxActive</name>
<value>20</value>
</parameter>
<parameter>
<name>maxIdle</name>
<value>20</value>
</parameter>
<parameter>
<name>maxWait</name>
<value>-1</value>
</parameter>
maxActive是最大激活连接数，这里取值为20，表示同时最多有20个数据库连　接。maxIdle是最大的空闲连接数，这里取值为20，表示即使没有数据库连接时依然可以保持20空闲的连接，而不被清除，随时处于待命状态。MaxWait是最大等待秒钟数，这里取值-1，表示无限等待，直到超时为止，也可取值9000，表示9秒后超时。

第二步：配置web.xml
打开webapps/ROOT/WEB-INF下web.xml，加入如下内容：
<resource-ref>
<description>SqlServer Datasource example</description>
<res-ref-name>jdbc/blog</res-ref-name>
<res-type>javax.sql.DataSource</res-type>
<res-auth>Container</res-auth>
</resource-ref>

第三部：配置tomcat（添加类）
将Microsoft SQL Server 2000 Driver for JDBC/lib目录下的三个jar文件拷贝到Tomcat安装目录的common/lib下。
配置完成！！

四、 测试代码
数据库如下：
新建一个名为blog的数据库，在里面创建一个表格：Create table test(id varchar(12),name varchar(30));
写一个jsp文件（testdb.jsp），将其置于webapps/ROOT目录下，打开tomcat运行该页面进行测试。
页面testdb.jsp的内容如下：

<%@ page contentType="text/html;charset=GBK"%>
<%@ page import= "java.sql.* "%>
<%@ page import= "javax.naming.* "%>
<%
try{
Context initCtx = new InitialContext();
Context ctx = (Context) initCtx.lookup("java:comp/env");
//获取连接池对象
Object obj = (Object) ctx.lookup("jdbc/blog");
//类型转换
javax.sql.DataSource ds = (javax.sql.DataSource)obj;
Connection conn = ds.getConnection();
Statement stmt = conn.createStatement();
String strSql = " insert into test(id,name) values(´00001´,´fany´)";
stmt.executeUpdate(strSql);
strSql = " select id,name from test ";
ResultSet rs = stmt.executeQuery(strSql);
if(rs.next()){
out.println(rs.getString(1));
out.println(rs.getString(2));
}
}catch(Exception ex){
ex.printStackTrace();
throw new SQLException("cannot get Connection pool.");
}
%>

运行tomcat，打开浏览器，输入http://localhost:8080/blog/test.jsp，正常情况下会在页面上看到"00001 fany"输出。