UML软件工程组织

Tomcat4的数据库连接池配置
作者: 陈光
本文主要介绍Tomcat4.0.6和Tomcat4.1.18两个版本下数据库连接池的配置,及程序对连接池的JNDI查找,并提供相应测试代码。最后指出配置及应用过程中的常见问题及解决方法。
一、Tomcat简介
 

Tomcat是Apache Jakarta的子项目之一,是Sun公司推荐的JSP、Servlet容器。作为一款优秀的应用服务器,Tomcat提供了数据库连接池、SSL、Proxy等许多通用组件功能,其中连接池是4.0以上版本的新增功能,应用非常广泛。

二、Tomcat4的连接池

Tomcat4的开发可分为两个阶段,4.0.6是第一阶段最推荐的release版本,内置的数据库连接池为Tyrex 0.9.7.0,Tyrex由exolab.org开发,相关信息可以参见www. exolab.org。之后,Tomcat的开发者在4.0.x的基础上对Tomcat进行了重构,重构后的release版本推荐4.1.18,这时内置的连接池改为DBCP,DBCP也是由Jakarta Commons的一个子项目。

接下来,将分别以4.0.6和4.1.18为例介绍这两种连接池对Oracle8.1.7的配置。

三、对Tomcat4.0.6的Tyrex配置

为方便起见,将连接池置于ROOT下,JNDI名设为jdbc/OracleDB,数据库服务器IP为192.168.0.50,SID为oradb,操作系统Win2000,jdk1.3.1,配置步骤如下。

第一步:配置server.xml

在server.xml文件中找到

<!-- Tomcat Root Context -->

<!--

   <Context path="" docBase="ROOT" debug="0"/>

-->

将其改为

<!-- Tomcat Root Context -->

        <Context path="" docBase="ROOT" debug="0">

               <Resource name="jdbc/OracleDB" auth="Container"  type="javax.sql.DataSource"/>

                <ResourceParams name="jdbc/OracleDB">

                 <parameter>

                   <name>user</name>

                   <value>holen</value>

                 </parameter>

                 <parameter>

                   <name>password</name>

                   <value>holen</value>

                 </parameter>

                 <parameter>

                   <name>driverClassName</name>

                   <value>oracle.jdbc.driver.OracleDriver</value>

                 </parameter>

                 <parameter>

                   <name>driverName</name>

                   <value>jdbc:oracle:thin:@192.168.0.50:1521:oradb</value>

                 </parameter>

                </ResourceParams>

              </Context>

说明:将ROOT的Context从注释中移出来,并定义Resource项,如下:

<Resource name="jdbc/OracleDB" auth="Container"  
          type="javax.sql.DataSource"/>

Resource项(即连接池的DataSource对象),有3个属性name、auth、type,name项是JNDI的名称定义,程序通过JNDI才能找到此对象,这里取名jdbc/OracleDB;auth项即连接池管理权属性,这里取值Container,申明为容器管理;type项即对象的类型,这里取值javax.sql.DataSource,申明为数据库连接池,Tyrex不但可以用作数据库连接池,还有许多别的功能,有兴趣的朋友可以打开Tyrex的jar包看看或访问www.exolab.org,在这里就不多说了。

在接下来的<ResourceParams>域内容里包含四个参数user、password、driverClassName、driverName,依次为数据库的用户名、密码、JDBC驱动和数据库地址。

用户名、密码是为访问数据库准备的,这里均取值holen。

driverClassName即数据库的JDBC驱动名称,如Oracle8.1.7的JDBC驱动包名叫classes.jar,一般位于Oracle安装目录下的ora81\jdbc\lib目录下,初始扩展名为ZIP,需要手工把classes.zip改名为classes.jar,并放到common/lib下。这里取值oracle.jdbc.driver.OracleDriver,此类由classes.jar提供。

 

<parameter>

       <name>driverClassName</name>

       <value>oracle.jdbc.driver.OracleDriver</value>

</parameter>

对于其他数据库,如MySql,其driverClassName一般为org.gjt.mm.mysql.Driver。

最后一个参数即driverName,即数据库的地址(准确点说应该叫url,4.1.18就改叫url了)

<parameter>

       <name>driverName</name>

       <value>jdbc:oracle:thin:@192.168.0.50:1521:oradb</value>

</parameter>

在这里填写里的是Oracle的访问地址,若是MySql、DB2、SqlServer或其他数据库,请填写相应的地址。

第二步:将Oracle的JDBC驱动classes12.jar拷贝到Tomcat安装目录的common/lib下,其他数据库也一样,请把其相应的JDBC驱动包置于common/lib,如MySql的JDBC驱动包mm.mysql-2.0.14.jar。

至此,配置完成,测试代码将在后面给出。

四、对Tomcat4.1.18的DBCP配置

 

配置方法与4.0.6稍有不同,以下是配置步骤

 

第一步:配置server.xml

在server.xml文件中找到

<!-- Tomcat Root Context -->

<!--

   <Context path="" docBase="ROOT" debug="0"/>

-->

将其改为

<!-- Tomcat Root Context -->        
        

              <Context path="" docBase="ROOT" debug="0">

              <Resource name="jdbc/OracleDB" auth="Container"

              type="javax.sql.DataSource"/>

                     <ResourceParams name="jdbc/OracleDB">

                       <parameter>

                            <name>factory</name>

                            <value>org.apache.commons.dbcp.BasicDataSourceFactory</value>

                       </parameter>

                       <parameter>

                            <name>driverClassName</name>

                            <value>oracle.jdbc.driver.OracleDriver</value>

                       </parameter>

                       <parameter>

                            <name>url</name>

                            <value>jdbc:oracle:thin:@192.168.0.50:1521:oradb</value>

                       </parameter>

                       <parameter>

                            <name>username</name>

                            <value>holen</value>

                       </parameter>

                       <parameter>

                            <name>password</name>

                            <value>holen</value>

                       </parameter>

                       <parameter>

                            <name>maxActive</name>

                            <value>20</value>

                       </parameter>

                       <parameter>

                            <name>maxIdle</name>

                            <value>10</value>

                       </parameter>

                       <parameter>

                            <name>maxWait</name>

                            <value>-1</value>

                       </parameter>

                     </ResourceParams>

              </Context>

说明:从配置文件可以看出,DBCP的配置与Tyrex类似,但功能更加丰富。相同就不多说,重点讲述不同的地方。

       factory参数:

<parameter>

       <name>factory</name>

       <value>org.apache.commons.dbcp.BasicDataSourceFactory</value>

</parameter>

即基础对象工厂,这里取值org.apache.commons.dbcp.BasicDataSourceFactory,即DBCP自带的工厂,也可以用别的。

需说明一点是,虽然4.1.18里主推DBCP作连接池,但仍然可以使用Tyrex作为连接池,而且此时的Tyrex已从0.9.7.0升级到了1.0,支持JTA/JCA对象等,对象的获取仍然是通过JNDI,具体的配置方法可以参见Tomcat文档。

url参数:

<parameter>

       <name>url</name>

<value>jdbc:oracle:thin:@192.168.0.50:1521:oradb</value>

url是数据库访问地址,在前提已提到。

接下来有三个参数,均为连接数相关,如下:

<parameter>

       <name>maxActive</name>

       <value>20</value>

</parameter>

<parameter>

       <name>maxIdle</name>

       <value>10</value>

</parameter>

<parameter>

<name>maxWait</name>

       <value>-1</value>

</parameter>

 

maxActive是最大激活连接数,这里取值20个,表示同时最多有20个与数据库的连接。

maxIdle是最大空闲连接数,这里取值10个,表示即使没有连接请求时,依然可以保持10空闲的连接,而不被清除,随时处于待命状态。关于对象的状态,有兴趣的朋友可以看看EJB方面的资料。

maxWait是最大等待秒钟数,这里取值-1,表示无限等待,直到超时为止,也可以取值9000,即表示9秒后超时。

关于maxActive与maxIdle的一点建议,对于企业级应用,其两者的值一般比较接近,或者相同,关键是要分析应用的大小。

第二步:配置web.xml

打开webapps/ROOT/WEB-INF下web.xml,加入如下内容:   

 

<resource-ref>

        <description>Oracle Datasource example</description>

        <res-ref-name>jdbc/OracleDB</res-ref-name>

        <res-type>javax.sql.DataSource</res-type>

        <res-auth>Container</res-auth>

 </resource-ref>

说明:此步可以省略,即不配置web.xml也可以使用连接池,但正式项目应用时还是建议加上。

第三步:将Oracle的JDBC驱动classes12.jar拷贝到Tomcat安装目录的common/lib下。

至此,配置完成,测试代码将在后面给出。

五、测试代码

 

下面写一个JSP文件testdb.jsp,并将testdb.jsp置于webapps/ROOT目录下,测试一下配置是否正确,此测试对以上两个版本均适合。

 

       数据库如下:

 

Create table test(id varchar2(12),name varchar2(30))

       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/OracleDB");   

        //类型转换

              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','holen') ";

              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.");

       }

%>

<hr>

说明:先通过JNDI找到jdbc/OracleDB对象,这里是分两步完成的,也可以一步完成,如

Object obj = (Object) ctx.lookup("java:comp/env /jdbc/OracleDB");

然后将得到的对象转换成DataSource类型,进而得到连接,得到连接后就可以进行相应的数据库操作了。

这里对数据库进行了两步操作,第一步是插入一条记录,第二步是从数据库中取出记录,并显示第一条记录的内容。

打开网页,在地址栏中输入http://localhost:8080/testdb.jsp,若一切正常,将显示“00001 holen”。

六、总结

 

以上配置了Tomcat4.0.6和Tomcat4.1.18的内置连接池,Tomcat4其他版本的配置方法与之类似,调用方法也一样。连接池配置主要就是修改server.xml及web.xml。

需要说明一点的是,Tomcat4.1.18有一个管理界面,通过此操作界面可以配置连接池及其他功能,不过通过这种方式配置的连接池不可用(测试时会发现程序运行很慢,原因是JNDI能找到,但不能建立连接),这是管理工具的一个BUG,已报至Tomcat BUG列表,更详细的情况可以参见tomcat-user的邮件列表。

七、参考资料

关于作者
陈光,J2EE项目经理,对EJB、XML比较熟悉,致力于应用和推广Apache Jakarta、Apache XML项目的内容,曾发表多篇Struts、CVS方面的文章。目前主要从事电子政务解决方案的开发与实施,可通过holen@263.net 与作者联系。

版权所有:UML软件工程组织