Java中JDBC查询结果封装为实体类对象的核心是字段映射、类型转换、空值处理与资源释放；手动封装需注意别名一致性及NULL安全，反射封装利用ResultSetMetaData+驼峰转换+setter调用，推荐使用DbUtils、MyBatis或Spring JdbcTemplate等成熟工具，并遵循资源管理与异常兜底规范。
Java 中 JDBC 查询结果封装为实体类对象，核心是手动或借助工具将 ResultSet 的每一行字段映射到 Java 对象的属性上。关键在于字段名与属性名的匹配、类型转换、空值处理和资源安全释放。
手动封装：逐字段赋值（最基础也最可控）
适用于字段少、逻辑简单或需精细控制的场景。需确保列名/索引与实体属性一一对应，并注意 SQL 查询中别名与 Java 属性名的一致性。
- 使用
rs.getString("user_name")或rs.getString(1)获取字段值，推荐用列别名（如SELECT id, name AS user_name FROM user），避免因 SQL 字段顺序变化导致错位 - 对基本类型注意判空，例如：
user.setAge(rs.getInt("age"));在数据库值为NULL时会返回 0，应改用rs.getObject("age")判空后转Integer - 日期类型优先用
rs.getTimestamp("create_time")而非getString再解析，避免格式不一致问题
反射封装：通用 ResultSetHandler（提升复用性）
通过反射自动匹配字段名与 setter 方法，减少重复代码。可自定义一个泛型工具方法，传入 ResultSet 和目标类类型，返回实体对象或列表。
- 获取
ResultSetMetaData得到列名（meta.getColumnName(i)），转为驼峰命名（如user_name→userName） - 根据列名查找对应 setter 方法（如
setUserName），用Method.invoke()赋值，注意处理基本类型包装类、时间类型、布尔类型等常见转换 - 建议加异常兜底：列名找不到 setter 时跳过或记录警告，避免单条数据失败导致整个结果集解析中断
使用成熟工具简化（推荐生产环境）
避免重复造轮子，主流方案有：
立即学习“Java免费学习笔记（深入）”；
-
Apache Commons DbUtils：提供
BeanHandler<User>和BeanListHandler<User>，一行代码完成单个或列表封装，自动处理类型转换和驼峰映射 -
MyBatis：虽属 ORM 框架，但其
ResultMap和注解@Results可精准控制字段到属性映射，支持嵌套对象、枚举、类型处理器等高级特性 -
JdbcTemplate（Spring）：配合
RowMapper实现简洁封装，支持 Lambda 表达式写法，类型安全且易于测试
注意事项与避坑点
封装过程容易忽略但影响稳定性的细节：
-
ResultSet 必须在关闭 Statement/Connection 前完成读取，否则抛
SQLException；建议用 try-with-resources 管理资源 - 数据库字段为
NULL时，不要直接调getXXX()基本类型方法（如getInt），应先用wasNull()判断，或统一用getObject()+ 类型转换 - 实体类属性名与数据库字段名差异大时，避免强依赖列顺序，始终用列名（别名）而非列索引获取值
- 批量查询时，若用反射或工具类，注意泛型擦除问题——确保传入的
Class<T>类型正确，避免运行时ClassCastException
