Tomcat4的数据库连接池配置
Tomcat4的数据库连接池配置
本文主要介绍Tomcat4.1.19这两个版本下数据库连接池的配置，及程序对连接池的JNDI查找，并提供相应
测试代码。最后指出配置及应用过程中的常见问题及解决方法。
一、 Tomcat简介
Tomcat是Apache Jakarta的子项目之一，是Sun公司推荐的JSP、Servlet容器。作为一款优秀的应用服务
器，Tomcat提供了数据库连接池、SSL、Proxy等许多通用组件功能，其中连接池是4.0以上版本的新增功
能，应用非常广泛。
二、 该文配置环境
Tomcat4.1.19 + jdk1.3 + Sql Server 2000 + Jbuilder 8.0 + Win2000
三、 对Tomcat4.1.19的DBCP配置
为方便起见，将连接池置于ROOT下，JNDI名设为jdbc/SqlServerDB，数据库服务器IP为
192.168.0.47，SID为hrntest，配置步骤如下。
第一步：配置server.xml
在server.xml中找到
<!-- Tomcat Root Context -->
<!—
<Context path="" docBase="ROOT" debug="0"/>
-->
将其改为
<!-- Tomcat Root Context -->
<Context path="" docBase="ROOT" debug="0" reloadable="true">
<Resource name="jdbc/SqlServerDB" auth="Container" type="javax.sql.DataSource"/>
<ResourceParams name="jdbc/SqlServerDB">
<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://192.168.0.47:1433;databa
seName=hrntest</value>
</parameter>
<parameter>
<name>username</name>
<value>Fany</value>
</parameter>
<parameter>
<name>password</name>
<value>fanyhan</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/SqlServerDB" auth="Container" type="javax.sql.DataSource"/>
Resource项（即连接池的DataSource对象），有3个属性name、auth、type，name项是JNDI的名称定义，
程序通过JNDI才能找到此对象，这里取名jdbc/SqlServerDB；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://192.168.0.47:1433;
databaseName=hrntest</value>
</parameter>
即数据库的地址。（不同的数据库其地址都不相同）
Sql Server 2000:
jdbc:microsoft:sqlserver://192.168.0.47:1433;databaseName=hrntest
Oracle8.1.7：jdbc:oracle:thin:@192.168.0.47:1521: hrntest
Username参数：
<parameter>
<name>username</name>
<value>Fany</value>
</parameter>
即连接数据库的用户名。
<parameter>
<name>password</name>
<value>fanyhan</value>
</parameter>
password参数：
即连接数据库的密码。
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/SqlServerDB</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下。
配置完成
四、 测试代码
数据库如下：
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/SqlServerDB");
//类型转换
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.");
}
%>
方法2：写一个数据库连接的类
类内容如下：
static String jndiName="jdbc/SqlServerDB";
/**
* 从连接池中取得一个空闲的数据库连接
* @returnConnection
* @exceptionException
*/
public static Connection getConnection() throws Exception{
Connection conn = null;
try {
Context initCtx = new InitialContext();
Context ctx = (Context) initCtx.lookup("java:comp/env");
//获取连接池对象
Object obj = (Object) ctx.lookup(jndiName);
//类型转换
javax.sql.DataSource ds = (javax.sql.DataSource)obj;
//获得数据库连接
conn= ds.getConnection();
} catch (java.lang.SecurityException se) {
throw se;
} catch(Exception e) {
e.printStackTrace();
throw e;
}
return conn;
}
[我在测的时候，没有这么繁，我只把三个JAR文件放在了相应的位置，测试连接也成功以呀！为什么呀！]
……