BeanListHandler 是 Java 开发中 Apache Commons DbUtils 库提供的核心工具类，主要用于简化 JDBC 数据库操作。它实现了 `ResultSetHandler` 接口，能够将数据库查询返回的 `ResultSet` 结果集自动转换为一个包含 Java Bean 对象的 `List` 集合 。
功能与特点
-
自动映射：通过反射机制，自动将结果集中的每一行数据映射到指定的 Java 实体类（JavaBean）中，无需手动编写繁琐的 `while(rs.next())` 循环和 `rs.getXxx()` 赋值代码 。
-
批量处理：专门针对多行查询结果，将多行记录封装为 `List<T>` 对象列表，而单行结果通常使用 `BeanHandler` 。
-
命名匹配规则：默认情况下，数据库列名与 Java 属性名需保持一致（忽略大小写）。若数据库采用下划线命名（如 `user_name`）而 Java 采用驼峰命名（如 `userName`），可通过自定义 `BeanProcessor` 或 SQL 别名来解决映射问题 。
使用示例
在使用 `QueryRunner` 执行查询时，只需传入目标类的 Class 对象即可：
```java
QueryRunner runner = new QueryRunner(dataSource);
String sql = "SELECT * FROM users";
// 自动将查询结果转换为 List<User>
List<User> userList = runner.query(sql, new BeanListHandler<User>(User.class));
```
若需处理特殊的字段命名映射，可以结合自定义的 `RowProcessor` 使用：
```java
// 使用自定义的 GenBeanProcess 处理下划线转驼峰
BeanListHandler<User> handler = new BeanListHandler<>(User.class, new BasicRowProcessor(new GenBeanProcess()));
List<User> userList = runner.query(sql, handler);
```
该工具类极大地减少了数据访问层（DAO）的样板代码，提高了开发效率并降低了手动映射出错的风险 。