Tomcat 6数据源配置，到底是在server.xml还是context.xml里？

在Java Web应用开发中，数据库连接是不可或缺的一环，频繁地创建和销毁数据库连接会极大地消耗系统资源，降低应用性能，为了解决这一问题，连接池技术应运而生，Tomcat作为一款流行的Web服务器，提供了强大的数据源配置功能，允许我们以JNDI（Java Naming and Directory Interface）的形式管理数据库连接池，本文将以经典的Tomcat 6为例，详细阐述如何干净、高效地配置数据源。

配置的基本原理

Tomcat通过JNDI技术,将数据库连接池作为一个命名资源提供给Web应用，开发者无需在代码中硬编码数据库驱动、URL、用户名等信息，而是通过一个逻辑名称（如jdbc/MyDB）来查找并获取连接，这种做法实现了配置与代码的分离，提升了应用的可移植性和可维护性，配置Tomcat数据源主要涉及三个层面：

1. JDBC驱动：确保数据库对应的JDBC驱动JAR包位于Tomcat的类加载路径下。
2. 服务器配置：在Tomcat的配置文件中声明资源（Resource）。
3. 应用声明：在应用的web.xml中声明对服务器资源的引用。

核心配置步骤

以下是将一个MySQL数据库配置为Tomcat 6数据源的详细步骤。

第一步：放置JDBC驱动

这是配置的基础,也是最容易被忽略的一步，将数据库对应的JDBC驱动JAR文件（MySQL的mysql-connector-java-5.x.x.jar）复制到Tomcat安装目录下的lib文件夹中（即$CATALINA_HOME/lib），这样，Tomcat容器和其承载的所有Web应用都能加载这个驱动。

第二步：在context.xml中配置资源

Tomcat 6推荐在应用的META-INF/context.xml文件中进行数据源配置，这种方式使得数据源与特定应用绑定，便于应用的独立部署和迁移，如果context.xml文件不存在，可以手动创建。

在<Context>标签内添加<Resource>元素，如下所示：

<Context>
    <!-- 其他配置... -->
    <Resource name="jdbc/MyDataSource"
              auth="Container"
              type="javax.sql.DataSource"
              driverClassName="com.mysql.jdbc.Driver"
              url="jdbc:mysql://localhost:3306/mydatabase?useUnicode=true&amp;characterEncoding=UTF-8"
              username="dbuser"
              password="dbpassword"
              maxActive="100"
              maxIdle="30"
              maxWait="10000"
              validationQuery="SELECT 1"
              testOnBorrow="true"/>
</Context>

这段XML定义了一个名为jdbc/MyDataSource的数据源，关键属性的含义将在下文详细解释。

第三步：在web.xml中声明资源引用

为了让Web应用知道如何通过JNDI查找这个数据源,需要在WEB-INF/web.xml文件中添加一个资源引用声明。

<web-app ...>
    <!-- 其他配置... -->
    <resource-ref>
        <description>MySQL DB Connection Pool</description>
        <res-ref-name>jdbc/MyDataSource</res-ref-name>
        <res-type>javax.sql.DataSource</res-type>
        <res-auth>Container</res-auth>
    </resource-ref>
</web-app>

这里的<res-ref-name>必须与context.xml中<Resource>的name属性值完全一致。

第四步：在Java代码中获取连接

配置完成后,就可以在Servlet、Listener或其他业务组件中通过JNDI lookup来获取数据库连接了。

import javax.naming.Context;
import javax.naming.InitialContext;
import javax.sql.DataSource;
import java.sql.Connection;
public class DBUtil {
    public Connection getConnection() throws Exception {
        // 初始化JNDI上下文
        Context initContext = new InitialContext();
        Context envContext = (Context) initContext.lookup("java:/comp/env");
        // 查找数据源
        DataSource ds = (DataSource) envContext.lookup("jdbc/MyDataSource");
        // 从连接池获取连接
        return ds.getConnection();
    }
}

重要提示：调用connection.close()方法并不会物理关闭连接，而是将其归还给连接池，供其他请求复用。

关键配置参数详解

<Resource>元素的众多参数控制着连接池的行为，合理调优至关重要，下表列出了核心参数及其说明：

相关问答FAQs

问题1：配置完成后，应用启动报错，提示ClassNotFoundException: com.mysql.jdbc.Driver或无法获取连接，该怎么办？

解答：这是一个非常常见的问题，请按以下顺序排查：

1. 检查JDBC驱动：确认数据库驱动的JAR包确实已放置在$CATALINA_HOME/lib目录下，而不是应用的WEB-INF/lib中，对于全局资源，驱动需要被容器加载。
2. 检查URL和凭据：仔细核对context.xml中的url、username和password是否正确无误，包括数据库主机名、端口、数据库名称以及用户权限。
3. 检查数据库服务：确保数据库服务正在运行，并且网络通畅，如果Tomcat和数据库不在同一台服务器上，请检查防火墙设置，确保Tomcat服务器可以访问数据库服务器的对应端口。
4. 检查XML语法：确保context.xml和web.xml的XML格式正确，没有拼写错误或标签不闭合的情况。

问题2：在server.xml的<GlobalNamingResources>中配置数据源和在context.xml中配置有什么区别？我应该选择哪种方式？

解答：两者主要区别在于作用域和部署便捷性。

• server.xml（全局配置）：在<GlobalNamingResources>元素中定义的数据源是全局的，可以被Tomcat下的所有Web应用共享，如果要让某个应用使用它，还需要在该应用的Context元素（可在server.xml或context.xml中定义）内添加一个<ResourceLink>来链接到全局资源，这种方式适合多个应用共享同一个数据库连接池的场景，但降低了应用的独立性，修改配置需要重启整个Tomcat服务。
• context.xml（应用级配置）：这是更受推荐的方式，数据源配置随应用打包，与单个应用的生命周期绑定，部署应用时，配置也随之生效，移植性强，无需修改服务器的全局配置，它使得应用更加“自包含”。

除非有明确的多应用共享需求,否则强烈推荐使用META-INF/context.xml进行数据源配置，因为它更符合模块化和可移植的设计原则。