Tomcat4的数据库连接池配置

<script type="text/javascript" src="http://pagead2.googlesyndication.com/pagead/show_ads.js"> </script> 陈光（holen@263.net） 2003.3 目录 1． Tomcat简介 2． Tomcat4的连接池 3． 对Tomcat4.0.6的Tyrex配置 4． 对Tomcat4.1.18的DBCP配置 5． 测试代码 6． 总结 7． 参考资料 8． 关于作者 本文主要介绍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的邮件列表。 七、参考资料 l Tomcat Documentation l http://www.mail-archive.com/tomcat-dev@jakarta.apache.org/ l http://www.mail-archive.com/tomcat-user@jakarta.apache.org/ 八、关于作者 陈光，J2EE项目经理，CJEA成员，对EJB、XML比较熟悉，致力于应用和推广Apache Jakarta、Apache XML项目的内容，曾发表多篇Struts、CVS方面的文章。目前主要从事电子政务总体解决方案的开发与实施，可通过 holen@263.net 与作者联系。