详细介绍在tomcat中配置数据源以及数据源的原理
前言
本文根据实例详细介绍了如何在tomcat中配置数据源。网上此类文章很多，但是基本都是雷同的，而且对一些特殊问题以及原理并未详细阐述，所以想根据自己的实际经验，并结合例子写一篇详细的文章。
本文是偶的一些拙见，有不正确的地方请大家多多评论指正。
开发环境
本文的环境：JDK1.4.2，TOMCAT5.0.28，Oracle9i
JDBC简介
提到数据源，那就不能不说JDBC。JDBC是Java DatabaseConnectivity的缩写。在java.sql包中提供了JDBC API，定义了访问数据库的接口和类。但是JDBCAPI不能直接访问数据库，必须依赖于数据库厂商提供的JDBC驱动程序，即JDBC DRIVER。
Java.sql中常用的接口和类如下：
Driver接口和DriverManager类
Connection
Statement
PreparedSataement
ResultSet
1 Driver接口和DriverManager类 DriverManager类用来建立和数据库的连接以及管理JDBC驱动程序，常用方法如下：
| 方法 | 描述 |
| registerDriver(Driver driver) | 在DriverManager中注册JDBC驱动程序 |
| getConnection(String url,String user,String pwd) | 建立和数据库的连接，返回Connection对象 |
| setLoginTimeOut(int seconds) | 设定等待数据库连接的最长时间 |
| setLogWriter(PrintWriter out) | 设定输入数据库日至的PrintWriter对象 |
2 Connection Connection代表和数据库的连接，其常用方法如下：
| 方法 | 描述 |
| getMetaData() | 返回数据库的MetaData数据。MetaData数据包含了数据库的相关信息，例如当前数据库连接的用户名、使用的JDBC驱动程序、数据库允许的最大连接数、数据库的版本等等。 |
| createStatement() | 创建并返回Statement对象 |
| PrepareStatement(String sql) | 创建并返回prepareStatement对象 |
3 Statement Statement用来执行静态sql语句。例如，对于insert、update、delete语句，调用executeUpdate(Stringsql)方法，而select语句可以调用executeQuery(String sql)方法，executeQuery(Stringsql)方法返回ResultSet对象。
4 PrepareStatement
PrepareStatement用于执行动态的sql语句，即允许sql语句中包含参数。使用方法为：
Stringsql=“selectcol1fromtablenamewherecol2=?Andcol3=?”;
PrepareStatementperpStmt=conn.preparestatement(sql);
perpStmt.setstring(1,col2Value);
perpStmt.setFloat(2,col3Value);
ResultSet rs = perpStmt.executeQuery();5 ResultSetResultSet用来表示select语句查询得到的记录集，一个StateMent对象在同一时刻只能打开一个ResultSet对象。通过ResultSet的getXXX()方法来得到字段值。ResultSet提供了getString()、getFloat()、getInt()等方法。可以通过字段的序号或者字段的名字来制定获取某个字段的值。例如：在上例中getString(0),getString(col1)都可以获得字段col1的值。
事务处理
在实际应用中，我们会遇到同时提交多个sql语句，这些sql语句要么全部成功，要么全部失败，如果其中一条提交失败，则必须撤销整个事务。为此，Connection类提供了3个控制事务的方法：
| 方法 | 描述 |
| setAutoCommit(boolen autoCommit) | 设置是否自动提交事务，默认为自动提交。 |
| commit() | 提交事务 |
| rollback() | 撤销事务 |
参考例子：
| try{ conn.SetautoCommit(false); stmt=conn.createstatement(); stmt.executeUpdate(“deleteformtable1wherecol1=1”); stmt.eecuteUpdate(“deletefromtable2wherecol2=1”); conn.comm.it(); }catch(Exceptione){ e.printStackTrace; try{ conn.rollback(); }catch(Exceptione1){ e1.printStackTrace; } } |
通过一个JSP例子来访问oracle数据库：
| <%@ page import="java.util.*"> <%@pageimport="java.sql.*"> <% try{ Connectionconn=null; Statementstmt=null; ResultSetrs=null; //加载oracle驱动程序 Class.forName("oracle.jdbc.driver.OracleDriver."); //注册oracle驱动程序 DriverManager.regidterDriver(new oracle.jdbc.driver.OracleDriver()); //建立数据库连接 conn=DriverManager.getConnection("jdbc:oracle:thin:@your dbip:yourdbport:sid",dbuser,dbpassword); stmt=conn.createStatement(); rs=stmt.executeQuery("select*from tablename"); while(rs.next){ out.print(rs.getstring("colname")); } }catch(Exceptione){ } finally{ rs.close(); stmt.close(); conn.close(); } %> |
数据源简介
JDBC2.0提供了javax.sql.DataSource的接口，负责与数据库建立连接，实际应用时不需要编写连接数据库代码，直接从数据源获得数据库的连接。Dataource中事先建立了多个数据库连接，这些数据库连接保持在数据库连接池中，当程序访问数据库时，只需要从连接池从取出空闲的连接，访问数据库结束，在将这些连接归还给连接池。DataSource对象由容器（Tomcat）提供，不能使用创建实例的方法来生成DataSource对象，要采用JAVA的JNDI（Java Nameing and DirectoryInterface，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"/> <ResourceParamsname="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 applicationdeploymentdescriptor中使用<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中声明对这个JNDIResource的引用。表示资源引用的元素为<resource-ref>,该元素加在<wepapp></wepapp >中。
| <resource-ref> <descryiption>DBConnection</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 namein environment or system property, or as an applet parameter, or in anapplication resource file: java.naming.factory.initial。
同样的代码在JSP文件中正常运行，后来翻了一些资料，终于找到了问题的所在了。原来DataSource是由容器（TOMCAT）提供的，所以我的测试会抛出异常。为了再次验证想法是否正确，在jsp文件中import刚才抛出异常的类，在进行连接数据库，结果一切正常。
下面的例子是实际应用中使用DataSource，在jsp文件中连接oracle。
| <%@ page language="java" import="java.util.*" pageEncoding="UTF-8"%> <%@pageimport="java.sql.*"%> <%@pageimport="javax.naming.*"%> <%@pageimport="javax.sql.*"%> <!DOCTYPEHTMLPUBLIC"-//W3C//DTD HTML4.01Transitional//EN"> <html> <head> </head> <body> <% ContextinitContext=newInitialContext(); ContextenvContext=(Context)initContext.lookup("java:/comp/env"); DataSourcedb=(DataSource)envContext.lookup("jdbc/javablogorl"); //javablogorl为<Resource>元素中name属性的值 Connectionconn=db.getConnection(); Statementstmt=conn.createStatement(); ResultSetrs=stmt.executeQuery("SELECT*FROMblog_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"/>