Tomcat中数据源的配置和使用

[b]Tomcat中数据源的配置和使用[/b]

【转载】
一、数据源简介：
在Java语言中，DataSource对象就是一个代表数据源实体的对象。一个数据源就是一个用来存储数据的工具，它可以是复杂的大型企业级数据库，也可以是简单得只有行和列的文件。数据源可以位于在服务器端，也可以位于客服端。
应用程序通过一个连接来访问数据源，那么一个DataSource对象就是用于提供连接数据源的工具。DataSource接口提供了两个方法用于建立和数据源的连接。
使用DataSource对象建立和数据库的连接比起使用DriverManager接口更加高效，虽然两者的使用范围都很相似，并且都提供了方法用于建立和数据库的连接，设置连接的最大超时时间，获取流、登录。
　　但两者之间的区别更加明显。和DriverManager不同，一个DataSource对象能够识别和描述它所代表的数据源的属性，而且DataSource对象的工作和JNDI(Javatm Naming and Directory Interfaceti)具有密切的关系，DataSource的建立、发布、独立于应用程序的管理都依靠JNDI技术。
　　在JDBC2.0或JDBC3.0中，所有的数据库驱动程序提供商必须提供一个实现了DataSource接口的类，要使用数据源必须首先在JNDI中注册该数据源对象。
如果在JNDI中注册了数据源对象，将会比起使用DriverManager来具有两个方面的优势：
首先程序不需要像使用DriverManager一样对加载的数据库驱动程序信息进行硬编码，程序员可以选择先在JNDI中注册这个数据源对象，然后在程序中使用一个逻辑名称来引用它，JNDI会自动根据你给出的名称找到与这个名称绑定的DataSource对象。然后就可以使用这个DataSource对象来建立和具体数据库的连接了。
其次，使用实现了DataSource接口的类所具有的第二个优势体现在连接池和分布式事务上。连接池通过对连接的复用而不是新建一个物理连接来显著地提高程序的效率。从而适用于任务繁忙、负担繁重的企业级分布式事务。
　　二、JNDI简介：
JNDI是用于向Java程序提供目录和命名功能的API。它被设计成独立于特定的目录服务，所以各种各样的目录都可以通过相同的方式进行访问。
可以简单地把JNDI理解为一种将对象和名字绑定的技术，对象工厂负责生产出对象，这些对象都和惟一的名字绑定。外部程序可以通过名字来获取对某个对象的引用。
三、数据源和连接池的关系：
JDBC2.0提供了javax.sql.DataSource接口，它负责建立与数据库的连接，在应用程序访问数据库时不需要编写连接数据库的代码，可以直接从数据源获得数据库连接。　
　　在DataSource中事先建立了多个数据库连接，这些数据库连接保存在连接池(Connect Pool)中。Java程序访问数据库时，只需要从连接池中取出空闲状态的数据库连接；当程序访问数据库结束，再将数据库连接放回连接池。
　　四、数据源和JNDI的关系：
DataSource对象是由Tomcat提供的，因此不能在程序中采用创建一个实例的方式来生产DataSource对象，而需要采用Java的另一个技术JNDI，来获得DataSource对象的引用。
Tomcat把DataSource作为一种可以配置的JNDI资源来处理。生成DataSource对象的工厂为org.apache.commons.dbcp.BasicDataSourceFactory。
在javax.naming包中提供了Context接口，该接口提供了将对象和名字绑定，以及通过名字检索对象的方法。Context中的主要方法有：
bind(String name,Object object)：将对象与一个名字绑定
　　lookup(String name)：返回与指定的名字绑定的对象

五、Tomcat中数据源的配置：

数据源的配置涉及修改server.xml和web.xml，在server.xml中加入定义数据源的元素<Resource>，在web.xml加入<resource-ref>元素，声明该Web应用所引用的数据。

　　A．在server.xml中加入<Resource>元素：<Resource>元素用来定义JNDI Resource。　　
　　属性 描述
　　name 指定Resource的JNDI名字
　　auth 指定管理Resource的Manager，它有两个可选值：Container、Application
　　type 指定Resource所属的Java类名


<Resource name = "jdbc/BookDb"　

auth = "Container"　

　　　type = "javax.sql.DataSource" />

B．在<Resource>元素中加入<ResourceParams>元素：<ResourceParams>元素用来指定各种参数值
　　
　　属性 　　描述
　　factory 指定生成的DataResource的factory类名
　　maxActive 指定数据库连接池中处于活动状态的最大连接数目，0表示不受限制
　　maxIdle 指定数据库连接池中处于空闲状态的最大连接数目，0表示不受限制
　　maxWait 指定连接池中连接处于空闲状态的最长时间,超过会抛出异常，-1表示无限
　　username 指定连接数据库的用户名
　　password 指定连接数据库的口令
　　driverClassName 指定连接数据库的JDBC驱动程序
　　url　　指定连接数据库的URL

<ResourceParams name = "jdbc/BookDb">
<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>user</value>

</parameter>



<parameter>

<name>password</name>

<value>1234</value>

</parameter>



<parameter>

<name>driverClassName</name>

<value>com.mysql.jdbc.Driver</value>

</parameter>



<parameter>

<name>url</name>

<value>jdbc:mysql//localhost:3306/BookDb?autoReconnect=true</value>

</parameter>


</ResourceParams>
　注：以上为tomcat5.5版本以下的适用，若为tomcat5.5或以上版本则server.xml的格式为：
<Resource name="jdbc/test" auth="Container" type="javax.sql.DataSource"
maxActive="20" maxIdle="5" maxWait="10000"
username="user" password="password" driverClassName="oracle.jdbc.driver.OracleDriver" SetBigStringTryClob="true"
url="jdbc:oracle:thin:@127.0.0.1:3444:test"/>　

C．在web.xml中加入<resource-ref>元素：<resource-ref>元素表示在Web应用中引用JNDI资源
　　
　　属性　　　　　　描述
　　description 对所引用的资源的说明
　　res-ref-name 指定所引用资源的JNDI名字，与<Resource>元素中的name属性对应
　　res-type　　指定所引用资源的类名字，与<Resource>元素中的type属性对应
　　res-auth　　指定所引用资源的Manager，与<Resource>元素中的auth属性对应
　　六、在Web应用中使用数据源：

　　javax.naming.Context提供了查找JNDI Resource的接口，可以通过三个步骤来使用数据源对象：

　　A．获得对数据源的引用：

Context ctx = new InitalContext();


DataSource ds =(DataSource)ctx.lookup("java:comp/env/jdbc/BookDb");

　B．获得数据库连接对象：


Connection con = ds.getConnection();

　C．返回数据库连接到连接池：

con.close();

在连接池中使用close()方法和在非连接池中使用close()方法的区别是：前者仅仅是把数据库连接对象返回到数据库连接池中，是连接对象又恢复到空闲状态，而非关闭数据库连接，而后者将直接关闭和数据库的连接。

　　七、发布使用数据源的Web应用：

　　如果直接同JDBC访问数据库，可以把JDBC驱动程序拷贝到Web应用的WEB-INF/lib目录或者Tomcat安装目录下的common/lib目录下。
　　
　　如果通过数据源访问数据库，由于数据源由Servlet容器创建并维护，所以必须把JDBC驱动程序拷贝到Tomcat安装目录下的common/lib目录下，确保Servlet容器能够访问驱动程序。