转摘请注明出处
作者:baggio785
来源:http://blog.csdn.net/baggio785
本文地址：http://blog.csdn.net/baggio785/archive/2006/04/24/674822.aspx
关键词：datasource(数据源),tomcat,连接池
前言
本文根据实例详细介绍了如何在tomcat中配置数据源。网上此类文章很多，但是基本都是雷同的，而且对一些特殊问题以及原理并未详细阐述，所以想根据自己的实际经验，并结合例子写一篇详细的文章。
本文是偶的一些拙见，有不正确的地方请大家多多评论指正。
开发环境
本文的环境：jdk1.4.2，tomcat5.0.28，oracle9i
jdbc简介
提到数据源，那就不能不说jdbc。jdbc是java database connectivity的缩写。在java.sql包中提供了jdbc api，定义了访问数据库的接口和类。但是jdbc api不能直接访问数据库，必须依赖于数据库厂商提供的jdbc驱动程序，即jdbc driver。
java.sql中常用的接口和类如下：
driver接口和drivermanager类
connection
statement
preparedsataement
resultset
1 driver接口和drivermanager类
drivermanager类用来建立和数据库的连接以及管理jdbc驱动程序，常用方法如下：
dataource中事先建立了多个数据库连接，这些数据库连接保持在数据库连接池中，当程序访问数据库时，只需要从连接池从取出空闲的连接，访问数据库结束，在将这些连接归还给连接池。datasource对象由容器（tomcat）提供，不能使用创建实例的方法来生成datasource对象，要采用java的jndi（java nameing and directory interface，java命名和目录接口）来获得datasource对象的引用。（另有一种说法：“其实从技术上来说，数据源连接方式是不需要目录服务的，我们同样可以通过序列化数据源对象直接访问文件系统。这点是需要明确的。”感兴趣的朋友可以试试。）jndi是一种将对象和名字绑定的技术，对象工厂负责生产出对象，这些对象都和唯一的名字相绑定。程序中可以通过这个名字来获得对象的引用。tomcat把datasource作为一种可配置的jndi资源来处理，生成datasource对象的工厂为org.apache.comm.ons.dbcp.basicdatasourcefactory。
配置数据源
配置数据源其实相当简单：
首先在server.xml中加入<resource>元素，打开server.xml，在<context>中加入以下代码（以oracle为例）：
| <resource name="jdbc/ jndi名字" auth="container" type="javax.sql.datasource"/> <resourceparams name="jdbc/jndi名字"> <parameter> <name>factory</name> <value>org.apache.commons.dbcp.basicdatasourcefactory</value> </parameter> <parameter> <name>maxactive</name> <value>100</value> </parameter> <parameter> <name>maxidle</name> <value>30</value> </parameter> <parameter> <name>maxwait</name> <value>10000</value> </parameter> <parameter> <name>username</name> <value>用户名</value> </parameter> <parameter> <name>password</name> <value>密码</value> </parameter> <parameter> <name>driverclassname</name> <value>oracle.jdbc.driver.oracledriver</value> </parameter> <parameter> <name>url</name> <value>jdbc:oracle:thin:@ip:端口:sid </value> </parameter> </resourceparams> |
<resource>元素的属性如下：
| 属性 | 描述 |
| name | 指定resource的jndi的名字 |
| auth | 指定管理resource的manager，由两个可选值：container和application。container表示由容器来创建和管理resource，application表示由web应用来创建和管理resource。如果在web application deployment descriptor中使用<resource-ref>，这个属性是必需的，如果使用<resource-env-ref>，这个属性是可选的。 |
| type | 指定resource所属的java类名 |
<resourceparams>元素的属性如下：
| 属性 | 描述 |
| name | 指定resourceparams的jndi的名字，必须和resource的name保持一致 |
| factory | 指定生成datasource对象的factory的类名 |
| maxactive | 指定数据库连接池中处于活动状态的数据库连接最大数目，0表示不受限制 |
| maxidle | 指定数据库连接池中处于空闲状态的数据库连接的最大数目，0表示不受限制 |
| maxwait | 指定数据库连接池中的数据库连接处于空闲状态的最长时间（单位为毫秒），超过这一事件，将会抛出异常。-1表示可以无限期等待。 |
| username | 指定连接数据库的用户名 |
| password | 指定连接数据库的密码 |
| driverclassname | 指定连接数据库的jdbc驱动程序 |
| url | 指定连接数据库的url |
其他文章说以上配置就ok了，对于web.xml的配置可有可无，其实不是这样子的。如果在web应用中访问了由servlet容器管理的某个jndi resource，则必须在web.xml中声明对这个jndi resource的引用。表示资源引用的元素为<resource-ref>,该元素加在<wepapp></ wepapp >中。
| <resource-ref> <descryiption>db connection</descryiption> <res-ref-name>jdbc/jndi名字 </res-ref-name> <res-type>javax.sql.datasource </res- type> <res-auth>container </res-auth> </resource-ref> |
<resource-ref>元素的属性如下：
| 属性 | 描述 |
| description | 对所引用的资源的说明 |
| res-ref-name | 指定所引用资源的jndi名字，与<resource>元素中的name属性保持一致 |
| res-type | 指定所引用资源的类名字，与<resource>元素中的type属性保持一致 |
| res-auth | 指定所引用资源的manager，与<resource>元素中的auth属性保持一致 |
到这里，数据源就已经配置成功了。但是我在测试的时候除了一点小麻烦，主要原因是对datasource的概念没搞清楚。我是这么测试的，写一个测试类，然后在eclipse中进行junit测试，捕获的异常为：
javax.naming.noinitialcontextexception: need to specify class name in environment or system property, or as an applet parameter, or in an application resource file: java.naming.factory.initial。
同样的代码在jsp文件中正常运行，后来翻了一些资料，终于找到了问题的所在了。原来datasource是由容器（tomcat）提供的，所以我的测试会抛出异常。为了再次验证想法是否正确，在jsp文件中import刚才抛出异常的类，在进行连接数据库，结果一切正常。
下面的例子是实际应用中使用datasource，在jsp文件中连接oracle。
| <%@ page language="java" import="java.util.*" pageencoding="utf-8"%> <%@ page import="java.sql.*"%> <%@ page import="javax.naming.*"%> <%@ page import="javax.sql.*"%> <!doctype html public "-//w3c//dtd html 4.01 transitional//en"> <html> <head> </head> <body> <% context initcontext = new initialcontext(); context envcontext = (context) initcontext.lookup("java:/comp/env"); datasource db = (datasource)envcontext.lookup("jdbc/javablogorl"); //javablogorl为<resource>元素中name属性的值 connection conn = db.getconnection( ); statement stmt = conn.createstatement(); resultset rs = stmt.executequery("select * from blog_systemadmin"); while(rs.next()){ out.print(rs.getstring("admin_name")+" "); out.print(rs.getstring("admin_password")+"<br>"); } rs.close(); stmt.close(); conn.close(); %> </body> </html> |
另:tomcat5.5的配制方法为:
<resource name="jdbc/jndi名字" auth="container" type="javax.sql.datasource"
maxactive="100" maxidle="30" maxwait="10000"
username="用户名" password="密码" driverclassname="oracle.jdbc.driver.oracledriver"
url="jdbc:oracle:thin:@ip:端口:sid"/>
闽公网安备 35060202000074号