`
kobe学java
  • 浏览: 249845 次
  • 性别: Icon_minigender_1
  • 来自: 苏州
社区版块
存档分类
最新评论

Tomcat中详细配置数据源及其原理解析

 
阅读更多

Tomcat中数据源的配置及原理
一:数据源介绍
数据源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。
二:配置数据源
在Tomcat中配置数据源其相当简单,可以配置单个应用的数据源,也可以配置整个容器的数据源。以下详细说明如何配置单个应用的数据源。
1.准备工作
  • Tomcat4.1.24 (其它版本也可以,原理相通的)
  •   确认在%Tomcat _Home%/common/lib下有commons-collections.jar、commons-dbcp.jar、commons-pool.jar包(tomcat默认有这些包),如果没有,请到此地下载:http://tomcat.apache.org/ 。这三个包是必需的。
  • 下载相应数据库驱动,放在%Tomcat _Home%/common/lib下。本例以oracle数据库为例,使用的驱动包为:ojdbc14.jar
  •   数据库为Oracle9i
  • 确认在%Tomcat _Home%/common/lib下有jndi.jar、dbc2_0-stdext.jar(tomcat默认有这些包)。
2.配置单个应用的数据源
2.1配置server.xml文件
首先打开%Tomcat _Home%/conf下 server.xml文件,在相应的<Context>中加入<Resource>元素,在<Context>(你的应用配置上下文)中加入以下代码(以oracle为例):

 

<Context path="/Exercise001" reloadable="true" docBase="D:/eclipse/workspace/Exercise001" workDir="D:/eclipse/workspace/Exercise001/work/org/apache/jsp" >
<!-- my dataConnectionPool seting here start-->
<Resource name="jdbc/myoracle" scope="Shareable" type="javax.sql.DataSource"/>
         <ResourceParams name="jdbc/myoracle">
                      <parameter>
                                 <name>factory</name>                                                                            
                                 <value>org.apache.commons.dbcp.BasicDataSourceFactory</value>
                      </parameter>
                      <parameter>
                                <name>maxWait</name>
                               <value>5000</value>
                      </parameter>
                      <parameter>
                                  <name>maxActive</name>
                                  <value>4</value>
                      </parameter>
                      <parameter>
                                 <name>password</name>
                                  <value>train</value>
                      </parameter>
                      <parameter>
                                  <name>url</name>                                     
                                  <value>jdbc:oracle:thin:@database-cn:1521:train007</value>
                      </parameter>
                      <parameter>
                                  <name>driverClassName</name>

 

注意:oracle9i以上加载此驱动,而其它版本加载:racle.jdbc.OracleDriver

                                  <value>oracle.jdbc.driver.OracleDriver</value>

 

                      </parameter>
                      <parameter>
                                 <name>maxIdle</name>
                                  <value>2</value>
                      </parameter>
                      <parameter>
                                  <name>username</name>
                                  <value>train</value>
                      </parameter>
           </ResourceParams>
           <!-- my datapool seting here end-->
</Context>
 

 

2.2< Resource >配置说明如下:
属性
描述
name
指定ResourceJNDI的名字
auth
指定管理ResourceManager,由两个可选值ContainerApplicationContainer表示由容器来建和管理ResourceApplication表示由WEB用来建和管理Resource。如果在web application deployment descriptor中使用<resource-ref>个属性是必需的,如果使用<resource-env-ref>个属性是可的。
type
指定Resource所属的java
2.3<ResourceParams>元素的属性如下:
属性
描述
name
指定ResourceParamsJNDI的名字,必Resourcename保持一致
factory
指定生成DataSource象的factory
maxActive
指定数据库连接池中于活的数据库连接最大数目,0表示不受限制
maxIdle
指定数据库连接池中于空的数据库连接的最大数目,0表示不受限制
maxWait
指定数据库连接池中的数据库连于空的最长时间毫秒),超过这一事件,将会抛出异常。-1表示可以无限期等待。
username
指定接数据的用
password
指定接数据的密
driverClassName
指定接数据JDBC驱动程序
url
指定接数据URL
2.3引用数据源
如果在web应用中访问了由Servlet容器管理的某个JNDI Resource,则必须在web.xml中声明对这个JNDI Resource的引用。表示资源引用的元素为<resource-ref>,该元素加在<wepapp></ wepapp >中。
打开你的应用配置文件web.xml,输入以下粗体部分:
<wepapp>
……
<resource-ref>
<descryiption>DB Connection</descryiption>
<res-ref-name>
 jdbc/myoracle
 </res-ref-name>
<res-type>javax.sql.DataSource </res- type>
<res-auth>Container </res-auth>
</resource-ref>
</ wepapp >
24<resource-ref>元素的属性如下:
属性
描述
description
所引用的源的
res-ref-name
指定所引用源的JNDI名字,与<Resource>元素中的name属性保持一致
res-type
指定所引用源的名字,与<Resource>元素中的type属性保持一致
res-auth
指定所引用源的Manager,与<Resource>元素中的auth属性保持一致
2.5测试数据源
     首先,检查Tomcat的%Tomcat _Home%/common/lib下有commons-collections.jar、commons-dbcp.jar、commons-pool.jar包,如果没现有,请到此地下载:http://tomcat.apache.org/
     注意以上三个包不要引入你的工程类路径,否则可能报错。
     然后,将驱动包放入%Tomcat _Home%/common/lib下,注意包必须为.jar后缀。Tomcat只认.jar包。
配置完成后,写个测试,如下:
<%@ 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/myoracle ");


Connection conn = db.getConnection( );
Statement stmt = conn.createStatement();
ResultSet rs = stmt.executeQuery("SELECT * FROM 
test");
while(rs.next()){
out.print(rs.getString("admin_name")+" ");
out.print(rs.getString("admin_password")+"<br>");
}
rs.close();
stmt.close();
conn.close();

%>
</body>
</html>

如果输出你期望的结果,表示数据源配置成功。
3.配置容器全局数据源
   以上,配置的数据源为单个应用使用的数据源,只能为单个应用所使用,下面我们配置全局的数据源,所有的应用都可以使用,通过引用很自然的使用全局数据源。准备工作同上。
          3.1 配置server.xml文件
首先打开%Tomcat _Home%/conf下 server.xml文件,在<GlobalNamingResources>下输入以下粗体部分:
<GlobalNamingResources>
……
<!-- my dataConnectionPool seting here start-->
<Resource name="jdbc/myoracle" scope="Shareable" type="javax.sql.DataSource"/>
<ResourceParams name="jdbc/myoracle">
                      <parameter>

 

此属性必需

                                 <name>factory</name>                                                                            <value>org.apache.commons.dbcp.BasicDataSourceFactory</value>

 

                      </parameter>
                      <parameter>
                      <name>maxWait</name>
                      <value>5000</value>
                      </parameter>
                      <parameter>
                                  <name>maxActive</name>
                                  <value>4</value>
                      </parameter>
                      <parameter>
                                 <name>password</name>
                                  <value>train</value>
                      </parameter>
                      <parameter>
                                  <name>url</name>                                      <value>jdbc:oracle:thin:@database-cn:1521:train007</value>
                      </parameter>
                      <parameter>

 

注意:oracle9i以上加载此驱动,而其它版本加载:racle.jdbc.OracleDriver

                                  <name>driverClassName</name>

 

                                  <value>oracle.jdbc.driver.OracleDriver</value>
                      </parameter>
                      <parameter>
                                 <name>maxIdle</name>
                                  <value>2</value>
                      </parameter>
                      <parameter>
                                  <name>username</name>
                                  <value>train</value>
                      </parameter>
           </ResourceParams>
           <!-- my datapool seting here end-->
</GlobalNamingResources>
3.2 引用数据源

由于我们配置的是容器全局数据源,因此所有的应用都可以引用这个数据源。在你的应用中建立引用,在<Context></Context>之间输入以下粗体部分:

<Context path="/Exercise001" reloadable="true" docBase="D:/eclipse/workspace/Exercise001" workDir="D:/eclipse/workspace/Exercise001/work/org/apache/jsp" >

<ResourceLink name="myDB"
                       global="jdbc/myoracle"

                       type="javax.sql.DataSource"/>

</Context>
3.3 配置应用文件web.xml
打开你的应用配置文件web.xml,输入以下粗体部分:
<wepapp>
……
<resource-ref>
<descryiption>DB Connection</descryiption>
<res-ref-name>
myDB</res-ref-name>
<res-type>javax.sql.DataSource </res- type>
<res-auth>Container </res-auth>
</resource-ref>
</ wepapp >
  3.4测试
  创建测试文件:

<%@ 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("
myDB ");//名称与web.xml配置中的一致


Connection conn = db.getConnection( );
Statement stmt = conn.createStatement();
ResultSet rs = stmt.executeQuery("SELECT * FROM 
test");
while(rs.next()){
out.print(rs.getString("admin_name")+" ");
out.print(rs.getString("admin_password")+"<br>");
}
rs.close();
stmt.close();
conn.close();

%>
</body>
</html>

如果输出你期望的结果,表示数据源配置成功。

 

分享到:
评论

相关推荐

Global site tag (gtag.js) - Google Analytics