Tomcat中数据源的配置及原理

最新推荐文章于 2024-04-02 10:00:52 发布

原创最新推荐文章于 2024-04-02 10:00:52 发布 · 144 阅读

0 ·

CC 4.0 BY-SA版权

文章标签：

#Tomcat #配置管理 #JDBC #SQL Server #MySQL

数据源配置管理专栏收录该内容

3 篇文章

订阅专栏

本文详细介绍如何在Tomcat中配置数据源，包括单个应用和容器全局数据源的配置步骤，并提供具体示例。

摘要生成于 C知道，由 DeepSeek-R1 满血版支持，前往体验 >

一：数据源介绍数据源简介

JDBC2.0提供了javax.sql.DataSource的接口，负责与数据库建立连接，实际应用时不需要编写连接数据库代码，可以直接从数据源获得数据库的连接，使得应用于数据库的耦合降低。

Dataource中事先建立了多个数据库连接，这些数据库连接保持在数据库连接池中，当程序访问数据库时，只需要从连接池从取出空闲的连接，访问数据库结束，在将这些连接归还给连接池。DataSource对象由容器（Tomcat）提供，不能使用创建实例的方法来生成DataSource对象，要采用JAVA的JNDI（Java Nameing and Directory Interface，java命名和目录接口）来获得DataSource对象的引用。（另有一种说法：“其实从技术上来说，数据源连接方式是不需要目录服务的，我们同样可以通过序列化数据源对象直接访问文件系统。这点是需要明确的。”感兴趣的朋友可以试试。）

JNDI是一种将对象和名字绑定的技术，对象工厂负责生产出对象，这些对象都和唯一的名字相绑定。程序中可以通过这个名字来获得对象的引用。Tomcat把DataSource作为一种可配置的JNDI资源来处理，生成DataSource对象的工厂为rg.apache.comm.ons.dbcp.BasicDataSourceFactory。

二：配置数据源

配置数据源其实相当简单，可以配置单个应用的数据源，也可以配置整个容器的数据源。以下详细说明如何配置单个应用的数据源。

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数据库为例，使用的驱动包为：jdbc14.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>（你的应用配置上下文）中加入以下代码（以MySql为例）：

<Context path="/test" docBase="E:\JAVA\mytest\webapp" > 

    <Resource name="jdbc/test" auth="Container" type="javax.sql.DataSource"/> 

    <ResourceParams name="jdbc/test"> 

       <parameter> 

           <name>username</name> 

           <value>root</value> 

       </parameter> 

       <parameter> 

           <name>password</name> 

           <value></value> 

       </parameter> 

       <parameter> 

           <name>driverClassName</name> 

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

       </parameter> 

       <parameter> 

           <name>url</name> 

           <value>jdbc:mysql://localhost/dlog</value> 

       </parameter> 

    </ResourceParams> 

</Context>

2．2< 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类名

2.3<ResourceParams>元素的属性如下：

	描述
name	指定ResourceParams的JNDI的名字，必须和Resource的name保持一致
factory	指定生成DataSource对象的factory的类名
maxActive	指定数据库连接池中处于活动状态的数据库连接最大数目，0表示不受限制
maxldle	指定数据库连接池中处于空闲状态的数据库连接的最大数目，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>

<description>connectDB test</description>

<res-ref-name>jdbc/test</res-ref-name>

<res-type>javax.sql.DataSource</res-type>

<res-auth>Container</res-auth>

</resource-ref>

</ wepapp >

2．4<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 ");

//javablogorl为<Resource>元素中name属性的值
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> ……


    <Context path="/test" docBase="E:\JAVA\mytest\webapp" > 

    <Resource name="jdbc/test" auth="Container" type="javax.sql.DataSource"/> 

    <ResourceParams name="jdbc/test"> 

       <parameter> 

           <name>username</name> 

           <value>root</value> 

       </parameter> 

       <parameter> 

           <name>password</name> 

           <value></value> 

       </parameter> 

       <parameter> 

           <name>driverClassName</name> 

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

       </parameter> 

       <parameter> 

           <name>url</name> 

           <value>jdbc:mysql://localhost/dlog</value> 

           </parameter> 

        </ResourceParams> 

</Context>

</GlobalNamingResources>

3.2 引用数据源

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

<Context path="/test" docBase="E:\JAVA\mytest\webapp" >

<ResourceLink name="myDB"　global="jdbc/test" 　type="javax.sql.DataSource"/>

</Context>

3．3 配置应用文件web.xml

打开你的应用配置文件web.xml,输入以下粗体部分：

<wepapp> …… 

<resource-ref>

       <description>connectDB test</description>

       <res-ref-name>jdbc/test</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配置中的一致

//javablogorl为<Resource>元素中name属性的值
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>

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

Hibernate.cfg.xml文件中删除所有连接数据库的配置参数，添加connection.datasource属性，其中jdbc/test为数据源在应用服务器中的JNDI名：