从零开始手把手教你用tomcat

前言
本文根据实例详细介绍了如何在tomcat中配置数据源。并且十分详细的介绍了JDBC简介，事务处理，数据源简介，配置数据源。本文从最基础的知识点开始讲起，让不太了解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驱动程序，常用方法如下：
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(String sql)方法，而select语句可以调用executeQuery(String sql)方法，executeQuery(String sql)方法返回ResultSet对象。
4.PrepareStatement
PrepareStatement用于执行动态的sql语句，即允许sql语句中包含参数。使用方法为：
String sql = “select col1 from tablename where col2=? And col3=?”;
PrepareStatement perpStmt = conn.preparestatement(sql);
perpStmt.setstring(1,col2Value);
perpStmt.setFloat(2,col3Value);
ResultSet rs = perpStmt.executeQuery();
5.ResultSet
ResultSet用来表示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(“delete form table1 where col1=1”);
stmt.eecuteUpdate(“delete from table2 where col2=1”);
conn.comm.it();
}catch(Exception e){
e.printStackTrace;
}
try{
conn.rollback();
} catch(Exception e1){
e1.printStackTrace;
}
}
通过一个JSP例子来访问oracle数据库：
<%@ page import="java.util.*">
<%@ page import="java.sql.*">
<%
try{
Connection conn = null;
Statement stmt = null;
ResultSet rs = null;
//加载oracle驱动程序
Class.forName("oracle.jdbc.driver.OracleDriver.");
//注册oracle驱动程序
DriverManager.regidterDriver(new
oracle.jdbc.driver.OracleDriver());
//建立数据库连接
conn=DriverManager.getConnection("jdbc:oracle:thin:@your
db ip:your db port:sid",dbuser,dbpassword);
stmt = conn.createStatement();
rs = stmt.executeQuery("select * from tablename");
while(rs.next){
out.print(rs.getstring("colname"));
}
}catch(Exception e){
}
finally{
rs.close();
stmt.close();
conn.close();
}
%>
数据源简介
JDBC2.0提供了javax.sql.DataSource的接口，负责与数据库建立连接，实际应用时不需要编写连接数据库代码，直接从数据源获得数据库的连接。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中加入元素，打开server.xml，在中加入以下代码（以oracle为例）：



factory
org.apache.commons.dbcp.BasicDataSourceFactory


maxActive
100


maxIdle
30


maxWait
10000


username
用户名


password
密码


driverClassName
oracle.jdbc.driver.OracleDriver


url
jdbc:oracle:thin:@ip:端口:sid


元素的属性如下：
name 指定Resource的JNDI的名字
auth 指定管理Resource的Manager，由两个可选值：Container和Application。Container表示由容器来创建和管理Resource，Application表示由WEB应用来创建和管理Resource。如果在web application deployment descriptor中使用，这个属性是必需的，如果使用，这个属性是可选的。
type 指定Resource所属的java类名
元素的属性如下：
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的引用。表示资源引用的元素为,该元素加在中。

DB Connection
jdbc/JNDI名字
javax.sql.DataSource
Container

元素的属性如下：
description 对所引用的资源的说明
res-ref-name 指定所引用资源的JNDI名字，与元素中的name属性保持一致
res-type 指定所引用资源的类名字，与元素中的type属性保持一致
res-auth 指定所引用资源的Manager，与元素中的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.*"%>





<%
Context initContext = new InitialContext();
Context envContext = (Context) initContext.lookup("java:/comp/env");
DataSource db = (DataSource)envContext.lookup("jdbc/javablogorl");
//javablogorl为元素中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")+"
");
}
rs.close();
stmt.close();
conn.close();
%>


另:tomcat5.5的配制方法为:
maxActive="100" maxIdle="30" maxWait="10000"username="用户名" password="密码" driverClassName="oracle.jdbc.driver.OracleDriver"              url="jdbc:oracle:thin:@ip:端口:sid"/>