《如何调用struts-config.xml中配置的data-source》
在基于Struts框架的Java Web应用开发中，数据库连接管理是核心环节之一。传统方式中，开发者需在每个需要访问数据库的Action类中手动编写JDBC连接代码，这不仅导致代码冗余，还增加了连接泄漏的风险。Struts框架通过struts-config.xml配置文件提供的data-source机制，实现了数据库连接的集中管理和复用，显著提升了开发效率和系统稳定性。本文将系统阐述如何在Struts应用中配置并调用data-source，涵盖配置原理、实现步骤、常见问题及优化策略。
一、Struts数据源配置原理
Struts框架通过org.apache.struts.action.ActionServlet在初始化阶段解析struts-config.xml文件，当检测到
数据源配置的核心优势在于解耦。业务逻辑层（Action类）无需关心连接获取和释放的细节，只需通过Struts提供的工具类获取连接即可。这种设计符合“依赖倒置原则”，使系统更易于维护和扩展。例如，当需要切换数据库类型（如从MySQL迁移到Oracle）时，仅需修改配置文件，无需改动业务代码。
二、配置data-source的完整步骤
1. 修改struts-config.xml文件
在配置文件中添加
关键属性说明：
- driverClassName：JDBC驱动类名，需与数据库类型匹配
- url：数据库连接URL，包含主机、端口和数据库名
- username/password：数据库认证凭据
- maxCount：连接池最大连接数，超过该值时请求将排队
- minCount：连接池初始连接数，应用启动时即创建
- idleTimeout：连接空闲超时时间（秒），超时后连接将被回收
2. 配置web.xml文件
确保ActionServlet的初始化参数中包含对struts-config.xml的引用：
action
org.apache.struts.action.ActionServlet
config
/WEB-INF/struts-config.xml
1
3. 验证数据源初始化
应用启动时，ActionServlet会输出日志信息，确认数据源是否成功加载。可通过查看日志文件（如catalina.out）检查以下关键信息：
INFO: Initializing data source 'default' with driver 'com.mysql.jdbc.Driver'
INFO: Created connection pool with min=5, max=20
三、在Action类中调用数据源
Struts提供了两种方式获取数据库连接：
1. 通过Action类直接获取
Action类可通过继承org.apache.struts.action.Action类，并调用getDataSource()方法获取数据源，再从中获取连接：
public class UserAction extends Action {
public ActionForward execute(ActionMapping mapping, ActionForm form,
HttpServletRequest request, HttpServletResponse response) {
DataSource ds = getDataSource(request, "default"); // "default"为配置中未指定key时的默认值
Connection conn = null;
try {
conn = ds.getConnection();
// 执行数据库操作
} catch (SQLException e) {
e.printStackTrace();
} finally {
if (conn != null) {
try {
conn.close(); // 实际是归还连接到连接池
} catch (SQLException e) {
e.printStackTrace();
}
}
}
return mapping.findForward("success");
}
}
2. 通过DBUtil工具类封装（推荐）
为避免代码重复，可封装一个DBUtil类统一管理连接获取和释放：
public class DBUtil {
public static Connection getConnection(HttpServletRequest request) {
try {
ActionServlet servlet = (ActionServlet)request.getServletContext()
.getAttribute(org.apache.struts.Globals.ACTION_SERVLET_KEY);
DataSource ds = servlet.getDataSource();
return ds.getConnection();
} catch (Exception e) {
throw new RuntimeException("Failed to get database connection", e);
}
}
public static void closeConnection(Connection conn) {
if (conn != null) {
try {
conn.close();
} catch (SQLException e) {
e.printStackTrace();
}
}
}
}
在Action类中的调用方式：
public class OrderAction extends Action {
public ActionForward execute(ActionMapping mapping, ActionForm form,
HttpServletRequest request, HttpServletResponse response) {
Connection conn = null;
try {
conn = DBUtil.getConnection(request);
// 执行数据库操作
} finally {
DBUtil.closeConnection(conn);
}
return mapping.findForward("success");
}
}
四、常见问题与解决方案
1. 数据源未初始化
现象：访问Action时抛出NullPointerException，日志中无数据源初始化信息。
原因：
- struts-config.xml文件路径错误
- ActionServlet未正确配置
- 数据源配置项存在语法错误
解决方案：
- 检查web.xml中ActionServlet的init-param配置
- 使用XML验证工具检查struts-config.xml的格式
- 在配置文件中添加debug日志级别，查看详细初始化过程
2. 连接泄漏
现象：应用运行一段时间后，数据库连接数达到上限，新请求无法获取连接。
原因：
- 未在finally块中释放连接
- 业务逻辑抛出异常导致连接未关闭
- 连接池配置的maxCount值过小
解决方案：
- 确保所有代码路径（包括异常情况）都释放连接
- 使用try-with-resources语法（Java 7+）自动管理资源
- 调整maxCount值为预期最大并发数的1.2-1.5倍
3. 数据库驱动兼容性问题
现象：初始化数据源时抛出ClassNotFoundException或SQLException。
原因：
- JDBC驱动未放入WEB-INF/lib目录
- 驱动版本与数据库版本不兼容
- 配置的driverClassName拼写错误
解决方案：
- 检查lib目录下是否存在正确的驱动JAR文件
- 参考数据库官方文档选择兼容的驱动版本
- 使用IDE的自动补全功能避免类名拼写错误
五、性能优化策略
1. 连接池参数调优
连接池的核心参数需根据应用负载动态调整：
- 初始连接数（minCount）：设置为应用启动时的预期并发数，避免首次请求延迟
- 最大连接数（maxCount）：通过压力测试确定系统峰值并发数，建议设置为该值的1.2倍
- 空闲超时（idleTimeout）：根据业务场景设置，长事务应用可适当延长（如600秒）
- 最大等待时间（maxWait）：控制请求排队时间，超时后抛出异常（通常设为30秒）
2. 使用连接验证机制
配置validationQuery属性（如MySQL的SELECT 1），使连接池在分配连接前验证其有效性，避免将已失效的连接分配给应用：
3. 监控连接池状态
通过JMX或日志监控连接池的关键指标：
- 活跃连接数（ActiveConnections）
- 空闲连接数（IdleConnections）
- 等待队列长度（WaitingThreads）
- 连接创建/销毁次数（CreateCount/DestroyCount）
可根据监控数据动态调整参数，例如当空闲连接数持续为0时，增加maxCount值。
六、与现代框架的对比
Struts的数据源配置机制虽经典，但与Spring等现代框架相比存在局限性：
- 配置方式：Struts使用XML配置，Spring支持JavaConfig和注解
- 连接池实现：Struts内置简单连接池，Spring集成Apache Commons DBCP、HikariCP等成熟方案
- 事务管理：Struts需手动控制事务，Spring提供声明式事务（@Transactional）
- 扩展性：Struts的数据源配置固定，Spring支持多数据源、动态数据源切换
在新项目中，若采用Struts框架，可结合Spring的JdbcTemplate或MyBatis等持久层框架，通过Spring管理数据源，Struts仅负责控制层逻辑。
七、总结
Struts框架通过struts-config.xml的data-source配置，为Java Web应用提供了简单有效的数据库连接管理方案。其核心价值在于：
- 集中管理数据库连接参数，便于维护和迁移
- 通过连接池技术提升性能，减少连接创建开销
- 解耦业务逻辑与连接管理，提高代码可测试性
实际应用中，需注意配置的正确性、连接的及时释放以及连接池参数的合理设置。对于复杂系统，可考虑集成更强大的数据源管理框架（如Spring或C3P0），以获得更丰富的功能和更好的性能表现。
关键词：Struts框架、data-source配置、数据库连接池、JDBC、struts-config.xml、Action类、连接管理、性能优化
简介：本文详细阐述了在Struts框架中通过struts-config.xml配置data-source实现数据库连接管理的方法，包括配置原理、实现步骤、代码示例、常见问题解决方案及性能优化策略，适用于需要提升Struts应用数据库访问效率的开发者。
