在开发 Java 应用程序时，数据库连接是必不可少的一部分。Tomcat 的 JNDI（Java Naming and Directory Interface）资源配置可以帮助我们更方便地管理数据库连接。但这里面有不少陷阱，接下来我就和大家详细说说怎么正确配置和使用数据源。
一、什么是 JNDI 和数据源
JNDI 就像是一个大仓库的管理员，它可以帮我们把各种资源（比如数据库连接、邮件会话等）存储起来，并且给它们起个名字。当我们需要使用这些资源的时候，只需要告诉管理员资源的名字，就能拿到对应的资源了。
数据源呢，简单来说就是数据库连接的一个抽象。它就像一个水龙头，我们可以通过它从数据库里取水（获取数据）。在 Tomcat 里配置数据源，就是告诉 Tomcat 这个水龙头要接到哪个数据库上。
举个例子，假如我们有一个 Java Web 应用，需要连接到 MySQL 数据库。我们就可以通过 JNDI 把这个数据库连接配置好，以后在应用里直接通过 JNDI 名字就能拿到这个连接，不用每次都手动去创建连接了。
二、Tomcat 中 JNDI 数据源配置步骤
1. 修改 server.xml 文件
server.xml 是 Tomcat 的核心配置文件，就像房子的蓝图一样。我们要在这个文件里告诉 Tomcat 我们要配置一个数据源。
<!-- Java 技术栈示例 -->
<!-- 在 <GlobalNamingResources> 标签里添加数据源配置 -->
<GlobalNamingResources>
<!-- 配置 MySQL 数据源 -->
<Resource name="jdbc/TestDB" auth="Container" type="javax.sql.DataSource"
maxActive="100" maxIdle="30" maxWait="10000"
username="root" password="password" driverClassName="com.mysql.jdbc.Driver"
url="jdbc:mysql://localhost:3306/testdb"/>
</GlobalNamingResources>
上面的代码里，name="jdbc/TestDB" 就是给这个数据源起的名字，以后在应用里就用这个名字来查找数据源。username 和 password 是数据库的用户名和密码，url 是数据库的连接地址。
2. 修改 context.xml 文件
context.xml 主要是用来配置应用的上下文信息。我们要在这个文件里把刚才配置的全局数据源引用到我们的应用里。
<!-- Java 技术栈示例 -->
<Context>
<!-- 引用全局数据源 -->
<ResourceLink global="jdbc/TestDB" name="jdbc/TestDB" type="javax.sql.DataSource"/>
</Context>
这里的 global 属性指向我们在 server.xml 里配置的全局数据源名字，name 是在应用里使用的数据源名字，一般和全局名字保持一致。
3. 在应用里使用数据源
现在我们已经配置好了数据源，接下来就可以在 Java 代码里使用它了。
// Java 技术栈示例
import javax.naming.Context;
import javax.naming.InitialContext;
import javax.sql.DataSource;
import java.sql.Connection;
import java.sql.ResultSet;
import java.sql.Statement;
public class JNDITest {
public static void main(String[] args) {
try {
// 获取初始上下文
Context initCtx = new InitialContext();
// 获取环境上下文
Context envCtx = (Context) initCtx.lookup("java:comp/env");
// 通过 JNDI 名字查找数据源
DataSource ds = (DataSource) envCtx.lookup("jdbc/TestDB");
// 从数据源获取数据库连接
Connection conn = ds.getConnection();
// 创建 SQL 语句执行对象
Statement stmt = conn.createStatement();
// 执行 SQL 查询
ResultSet rs = stmt.executeQuery("SELECT * FROM users");
// 遍历查询结果
while (rs.next()) {
System.out.println(rs.getString("username"));
}
// 关闭资源
rs.close();
stmt.close();
conn.close();
} catch (Exception e) {
e.printStackTrace();
}
}
}
上面的代码里，我们首先通过 InitialContext 获取初始上下文，然后通过 lookup 方法查找数据源，最后从数据源获取数据库连接并执行 SQL 查询。
三、配置陷阱及解决方法
1. 数据源名字冲突
如果在不同的应用里使用了相同的 JNDI 名字，就会导致名字冲突。解决方法就是给每个数据源起一个唯一的名字。比如在不同的应用里分别使用 jdbc/App1DB 和 jdbc/App2DB。
2. 驱动加载问题
有时候会出现找不到数据库驱动的情况。这可能是因为没有把数据库驱动的 JAR 文件放到 Tomcat 的 lib 目录下。我们只需要把对应的 JAR 文件复制到 $TOMCAT_HOME/lib 目录下就可以了。
3. 权限问题
如果 Tomcat 没有足够的权限访问数据库，也会导致连接失败。我们要确保数据库的用户名和密码正确，并且这个用户有访问数据库的权限。
四、应用场景
1. 多应用共享数据库连接
当有多个 Java Web 应用需要连接同一个数据库时，通过 JNDI 配置数据源可以实现数据库连接的共享。这样可以减少数据库连接的开销，提高应用的性能。
2. 数据库切换方便
如果以后需要把数据库从 MySQL 切换到 PostgreSQL，只需要修改 Tomcat 的数据源配置文件，而不需要修改应用里的代码。这样可以大大提高开发和维护的效率。
五、技术优缺点
优点
- 方便管理：通过 JNDI 配置数据源，我们可以集中管理数据库连接，不需要在每个应用里单独配置。
- 提高性能：可以使用连接池技术，减少数据库连接的创建和销毁开销，提高应用的性能。
- 便于维护：当数据库信息发生变化时，只需要修改配置文件，不需要修改应用代码。
缺点
- 配置复杂：JNDI 配置涉及到多个文件，对于初学者来说可能比较复杂。
- 依赖 Tomcat：只能在 Tomcat 环境下使用，缺乏一定的灵活性。
六、注意事项
1. 配置文件备份
在修改 Tomcat 的配置文件之前，一定要先备份。这样如果配置出错，可以恢复到原来的状态。
2. 连接池参数调整
不同的应用场景可能需要不同的连接池参数。比如对于高并发的应用，需要适当增大 maxActive 和 maxIdle 参数。
3. 异常处理
在使用数据源时，一定要进行异常处理。因为数据库连接可能会因为各种原因失败，比如网络问题、数据库服务停止等。
七、文章总结
通过上面的介绍，我们了解了 Tomcat 的 JNDI 资源配置和数据源的使用方法，也知道了其中的陷阱和解决方法。在实际开发中，我们要根据具体的应用场景和需求，合理配置数据源，避免出现各种问题。虽然 JNDI 配置有一定的复杂性，但它带来的好处也是非常明显的，比如方便管理、提高性能和便于维护等。希望大家在以后的开发中能够正确使用 JNDI 来配置和管理数据源。
评论