1. BeanPropertyRowMapper的默认行为与局限性
BeanPropertyRowMapper是Spring JDBC提供的一个便捷工具，它能够将ResultSet中的列数据自动映射到Java Bean的同名属性上。其工作原理是，通过反射机制，查找与ResultSet列名（或其下划线转驼峰形式）匹配的Bean属性，并调用相应的setter方法进行赋值。
例如，如果数据库列名为LOAN_ID，而Java Bean中存在loanId属性，BeanPropertyRowMapper可以很好地处理这种映射。然而，当数据库列名与Java Bean属性名存在较大差异时，例如数据库列名为L_SELLER_LOAN_ID，而Bean属性名为sellerLoanId，BeanPropertyRowMapper就无法自动识别并完成映射。
需要注意的是，一些开发者可能会尝试使用JPA（Java Persistence API）中的@Column等注解来解决此问题。但如果您的Java Bean并非JPA实体（即不通过JPA框架进行持久化管理），这些注解将不会被BeanPropertyRowMapper识别和处理，因此无法解决映射问题。在这种情况下，我们需要采用更底层的Spring JDBC机制来定制映射逻辑。
2. 核心解决方案：实现自定义RowMapper
解决BeanPropertyRowMapper无法处理的复杂映射问题的最直接和推荐方法是实现Spring的RowMapper接口。RowMapper接口只有一个方法mapRow(ResultSet rs, int rowNum)，开发者可以在该方法中手动从ResultSet中获取数据，并将其设置到对应的Java Bean属性中。
2.1 定义数据模型（Java Bean）
首先，我们定义一个简单的Java Bean，它将用于存储从数据库查询到的数据。
import lombok.Data; // 假设使用了Lombok简化getter/setter
@Data
public class Funding {
private Long loanId; // 对应数据库列名：LOAN_ID
private String sellerLoanId; // 对应数据库列名：L_SELLER_LOAN_ID
// 可以添加其他属性
}2.2 实现自定义RowMapper
接下来，我们创建一个实现RowMapper
import org.springframework.jdbc.core.RowMapper; import java.sql.ResultSet; import java.sql.SQLException; public class FundingRowMapper implements RowMapper{ @Override public Funding mapRow(ResultSet rs, int rowNum) throws SQLException { Funding funding = new Funding(); // 直接通过列名从ResultSet中获取数据，并设置到Bean属性 // LOAN_ID 列名与 loanId 属性名可以通过 BeanPropertyRowMapper 自动映射， // 但为了完整性，这里也手动指定 funding.setLoanId(rs.getLong("LOAN_ID")); // 重点：处理不匹配的列名 L_SELLER_LOAN_ID 映射到 sellerLoanId 属性 funding.setSellerLoanId(rs.getString("L_SELLER_LOAN_ID")); // 如果有其他字段，也在此处进行映射 // funding.setSomeOtherProperty(rs.getString("SOME_DB_COLUMN")); return funding; } }
在mapRow方法中，我们通过ResultSet对象的getXXX(String columnName)方法，明确指定了数据库列名，然后将获取到的值赋给Java Bean的相应属性。这样，即使列名与属性名不一致，也能确保数据正确映射。
2.3 在JdbcTemplate中使用自定义RowMapper
最后，我们将这个自定义的RowMapper实例传递给JdbcTemplate的查询方法。
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.jdbc.core.JdbcTemplate;
import org.springframework.stereotype.Repository;
import java.util.List;
@Repository
public class FundingDao {
private final JdbcTemplate jdbcTemplate;
@Autowired
public FundingDao(JdbcTemplate jdbcTemplate) {
this.jdbcTemplate = jdbcTemplate;
}
public List findAllFundingValues() {
String sql = "SELECT LOAN_ID, L_SELLER_LOAN_ID FROM FUNDING_TABLE"; // 确保SQL查询包含所有需要的列
// 使用自定义的 FundingRowMapper 实例进行查询
return jdbcTemplate.query(sql, new FundingRowMapper());
}
// 示例：根据ID查询单个Funding对象
public Funding findFundingById(Long id) {
String sql = "SELECT LOAN_ID, L_SELLER_LOAN_ID FROM FUNDING_TABLE WHERE LOAN_ID = ?";
return jdbcTemplate.queryForObject(sql, new FundingRowMapper(), id);
}
} 通过这种方式，JdbcTemplate在执行SQL查询后，会使用我们提供的FundingRowMapper来处理ResultSet中的每一行数据，并将其转换为Funding对象。
3. 注意事项与总结
- 灵活性与控制力： 实现自定义RowMapper提供了极大的灵活性，您可以完全控制数据从ResultSet到Java Bean的映射过程。这不仅可以处理列名不匹配的问题，还可以进行数据类型转换、空值处理、复杂对象组装等高级操作。
- 性能考量： 对于少量字段的简单映射，自定义RowMapper的性能开销与BeanPropertyRowMapper相近。但对于大量字段或复杂转换，手动映射可能会比反射机制的BeanPropertyRowMapper有更好的性能表现。
- 代码维护： 当数据库表结构或Java Bean属性发生变化时，需要相应地修改RowMapper的mapRow方法。这要求开发者保持RowMapper与数据模型和数据库结构的一致性。
-
何时选择：
- 当Java Bean属性名与数据库列名高度一致，或仅存在简单的下划线/驼峰转换时，优先考虑使用BeanPropertyRowMapper，因为它更简洁。
- 当出现列名不匹配、需要自定义数据转换、或者Java Bean不是JPA实体且无法使用JPA注解进行映射时，实现自定义RowMapper是最佳选择。
通过上述方法，您可以有效地解决Spring JDBC中Java Bean属性与数据库列名不一致的映射问题，确保数据能够准确无误地从数据库加载到您的应用程序中。
