Spring Framework JDBC操作对象化指南

Spring Framework JDBC操作对象化指南

spring-framework 项目地址: https://gitcode.com/gh_mirrors/spr/spring-framework

概述

在Spring Framework中，org.springframework.jdbc.object包提供了一系列将JDBC操作对象化的类，使数据库访问更加面向对象。本文将深入探讨这些类的使用方式和最佳实践。

核心概念

Spring的JDBC操作对象化方式主要包含三类核心组件：

1. 查询操作类：将SQL查询封装为可重用的对象
2. 更新操作类：封装INSERT、UPDATE和DELETE语句
3. 存储过程类：封装数据库存储过程的调用

SqlQuery详解

SqlQuery是一个可重用、线程安全的类，它封装了SQL查询操作。开发者需要实现newRowMapper()方法来提供RowMapper实例，用于将结果集的每一行映射为Java对象。

实际开发中，我们更常使用其子类MappingSqlQuery，它提供了更便捷的行映射实现方式。

MappingSqlQuery实战

MappingSqlQuery要求子类实现mapRow()方法来完成结果集到Java对象的转换。下面是一个典型实现示例：

public class ActorMappingQuery extends MappingSqlQuery<Actor> {
    public ActorMappingQuery(DataSource ds) {
        super(ds, "SELECT id, first_name, last_name FROM t_actor WHERE id = ?");
        declareParameter(new SqlParameter("id", Types.INTEGER));
        compile();
    }

    @Override
    protected Actor mapRow(ResultSet rs, int rowNumber) throws SQLException {
        Actor actor = new Actor();
        actor.setId(rs.getLong("id"));
        actor.setFirstName(rs.getString("first_name"));
        actor.setLastName(rs.getString("last_name"));
        return actor;
    }
}

使用方式：

private ActorMappingQuery actorMappingQuery;

@Autowired
public void setDataSource(DataSource dataSource) {
    this.actorMappingQuery = new ActorMappingQuery(dataSource);
}

public Actor getActor(Long id) {
    return actorMappingQuery.findObject(id);
}

SqlUpdate应用

SqlUpdate类封装了SQL更新操作，与查询类似，它也是可重用且线程安全的。下面是一个更新用户信用评级的示例：

public class UpdateCreditRating extends SqlUpdate {
    public UpdateCreditRating(DataSource ds) {
        setDataSource(ds);
        setSql("UPDATE customer SET credit_rating = ? WHERE id = ?");
        declareParameter(new SqlParameter("creditRating", Types.NUMERIC));
        declareParameter(new SqlParameter("id", Types.NUMERIC));
        compile();
    }

    public int execute(int id, int rating) {
        return update(rating, id);
    }
}

存储过程处理

StoredProcedure类为存储过程调用提供了面向对象的抽象。以下是调用Oracle系统日期函数的示例：

public class GetSysdateProcedure extends StoredProcedure {
    private static final String SQL = "sysdate";

    public GetSysdateProcedure(DataSource dataSource) {
        setDataSource(dataSource);
        setFunction(true);
        setSql(SQL);
        declareParameter(new SqlOutParameter("date", Types.DATE));
        compile();
    }

    public Date execute() {
        Map<String, Object> results = execute(new HashMap<>());
        return (Date) results.get("date");
    }
}

对于更复杂的存储过程，如返回多个结果集的情况：

public class TitlesAndGenresStoredProcedure extends StoredProcedure {
    private static final String SPROC_NAME = "AllTitlesAndGenres";

    public TitlesAndGenresStoredProcedure(DataSource dataSource) {
        super(dataSource, SPROC_NAME);
        declareParameter(new SqlOutParameter("titles", OracleTypes.CURSOR, new TitleMapper()));
        declareParameter(new SqlOutParameter("genres", OracleTypes.CURSOR, new GenreMapper()));
        compile();
    }
}

最佳实践建议

1. 权衡使用：对于简单操作，直接使用JdbcTemplate可能更简洁
2. 重用性：这些操作类设计为线程安全，适合作为DAO的成员变量重用
3. 参数处理：正确声明参数类型是确保操作成功的关键
4. 异常处理：合理处理SQLException，考虑使用Spring的异常转换机制

总结

Spring的JDBC操作对象化提供了一种结构化的方式来组织数据库访问代码，特别适合复杂查询和存储过程调用场景。通过合理使用这些类，可以构建更清晰、更易维护的数据访问层。

spring-framework 项目地址: https://gitcode.com/gh_mirrors/spr/spring-framework