IDC资讯中心
tomcat4的数据库连接池配置
add by: fanyhan
本文主要介绍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";
/**
* 从连接池中取得一个空闲的数据库连接
* @return connection
* @exception exception
*/
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;
}
