数据源简介
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中加入<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"/>