一文带你学会Spring JDBC的使用

简介

在这篇文章中，我们将会介绍Spring JDBC，以及如何使用它来连接和操作数据库。Spring JDBC是Spring框架中的一个模块，它提供了一些工具和类，使得操作数据库更加方便。

步骤

1. 添加依赖

首先，我们需要在项目中添加Spring JDBC的依赖。在Maven项目中，可以在pom.xml中添加以下依赖：

<dependency>
    <groupId>org.springframework</groupId>
    <artifactId>spring-jdbc</artifactId>
    <version>${spring.version}</version>
</dependency>
<dependency>
    <groupId>org.springframework</groupId>
    <artifactId>spring-tx</artifactId>
    <version>${spring.version}</version>
</dependency>

2. 配置数据源

在使用Spring JDBC之前，我们需要先配置数据源。数据源负责管理连接到数据库的连接池，并且支持事务。可以在Spring的配置文件（如applicationContext.xml）中进行配置，例如：

<bean id="dataSource" class="org.apache.commons.dbcp.BasicDataSource">
    <property name="driverClassName" value="com.mysql.jdbc.Driver"/>
    <property name="url" value="jdbc:mysql://localhost/test"/>
    <property name="username" value="root"/>
    <property name="password" value=""/>
</bean>

此处使用了Apache Commons DBCP作为连接池实现。

3. 编写JDBC操作代码

使用Spring JDBC进行数据库操作时，我们可以使用JdbcTemplate，它简化了数据库操作的代码。例如，要执行一个查询，可以这样做：

@Autowired
private JdbcTemplate jdbcTemplate;

public void queryData() {
    List<Map<String, Object>> data = jdbcTemplate.queryForList("SELECT * FROM test_table");
    // do something with data
}

上面的代码会查询test_table表的所有数据，并将结果以List>的形式返回。

要执行更新操作（如插入、更新、删除），我们可以使用相应的方法：

@Autowired
private JdbcTemplate jdbcTemplate;

public void insertData(String name, int age) {
    jdbcTemplate.update("INSERT INTO test_table (name, age) VALUES (?, ?)", name, age);
}

上面的代码会向test_table表插入一条记录。

4. 使用事务

在进行更新操作时，我们可能希望一组操作要么全部成功，要么全部失败，这时就需要使用事务管理。Spring JDBC支持声明式事务，非常方便。我们可以在Spring的配置文件中进行配置：

<bean id="dataSource" class="org.apache.commons.dbcp.BasicDataSource">
    <property name="driverClassName" value="com.mysql.jdbc.Driver"/>
    <property name="url" value="jdbc:mysql://localhost/test"/>
    <property name="username" value="root"/>
    <property name="password" value=""/>
</bean>

<bean id="txManager" class="org.springframework.jdbc.datasource.DataSourceTransactionManager">
    <property name="dataSource" ref="dataSource" />
</bean>

<tx:annotation-driven transaction-manager="txManager" />

可以看到，我们在配置文件中定义了一个DataSourceTransactionManager，它将会管理我们的数据源。在需要使用事务的方法中使用@Transactional注解即可：

@Autowired
private JdbcTemplate jdbcTemplate;

@Transactional
public void updateData() {
    jdbcTemplate.update("UPDATE test_table SET age = age + 1");
    jdbcTemplate.update("UPDATE test_table SET name = 'John' WHERE age > 20");
}

上面的代码会将test_table表中的所有年龄+1，并将年龄大于20的记录的姓名修改为'John'。如果其中任何一个操作失败，将会回滚事务。

示例说明

示例1：查询

假设我们有一个user表，包含id和name列，我们希望查询所有的用户信息。我们可以这样做：

@Autowired
private JdbcTemplate jdbcTemplate;

public List<User> queryAllUsers() {

    List<User> result = new ArrayList<>();

    String sql = "SELECT * FROM user";

    jdbcTemplate.query(sql, new RowCallbackHandler() {
        @Override
        public void processRow(ResultSet rs) throws SQLException {
            User user = new User();
            user.setId(rs.getInt("id"));
            user.setName(rs.getString("name"));

            result.add(user);
        }
    });

    return result;
}

上面的代码将会查询user表的所有数据，并将结果以List的形式返回。

示例2：批量插入

假设我们有一个user表，包含id和name列，我们希望向表中插入多条记录。我们可以这样做：

@Autowired
private JdbcTemplate jdbcTemplate;

public void batchInsert(List<User> users) {

    String sql = "INSERT INTO user (id, name) VALUES (?, ?)";

    jdbcTemplate.batchUpdate(sql, new BatchPreparedStatementSetter() {
        @Override
        public void setValues(PreparedStatement ps, int i) throws SQLException {
            User user = users.get(i);
            ps.setInt(1, user.getId());
            ps.setString(2, user.getName());
        }

        @Override
        public int getBatchSize() {
            return users.size();
        }
    });
}

上面的代码将会向user表中插入多条记录。其中，batchUpdate方法批量执行SQL语句，BatchPreparedStatementSetter会处理参数设置和批量大小控制。

结论

Spring JDBC是一个用于简化数据库操作的强大工具。通过使用JdbcTemplate和声明式事务，可以大大减少与数据库交互时的代码量，并且让事务管理变得更加方便。当然，本文只是介绍了Spring JDBC的基本使用方式，还有许多的高级特性以及更复杂的用例需要读者自己去探索。