Spring JdbcTemplate执行数据库操作详解

什么是Spring JdbcTemplate?

Spring JdbcTemplate是一个基于JDBC的模板框架，它简化了JDBC API的使用，提供了异常处理、资源管理以及线程安全等特性。JdbcTemplate可以连接任何数据库，仅通过一些简单的配置，就可以执行SQL查询和更新，以及管理事务。

JdbcTemplate的基本操作

1. 配置数据源

在使用JdbcTemplate时，我们需要配置数据源以及相关的连接信息。一般情况下，我们会在Spring配置文件中配置数据源。

此处，我们采用H2内存数据库作为示例，示例代码如下：

<bean id="dataSource" class="org.springframework.jdbc.datasource.DriverManagerDataSource">
    <property name="driverClassName" value="org.h2.Driver"/>
    <property name="url" value="jdbc:h2:mem:test"/>
    <property name="username" value="sa"/>
    <property name="password" value=""/>
</bean>

2. 定义JdbcTemplate

配置好数据源之后，我们需要创建并配置一个JdbcTemplate。在Spring中，可以使用@Configuration注解或XML配置等方式创建JdbcTemplate。

这里的示例代码采用注解方式：

@Configuration
public class JdbcTemplateConfig {

    @Autowired
    private DataSource dataSource;

    @Bean
    public JdbcTemplate jdbcTemplate() {
        return new JdbcTemplate(dataSource);
    }

}

3. 执行SQL查询

执行查询是JdbcTemplate的常规操作之一。示例代码如下：

@Autowired
private JdbcTemplate jdbcTemplate;

public void queryTest() {
    String sql = "SELECT * FROM employee WHERE id = ?";
    Employee employee = jdbcTemplate.queryForObject(sql,
             new Object[]{1},
             new BeanPropertyRowMapper<>(Employee.class));
    System.out.println(employee.toString());
}

解释一下：

• 我们首先注入了一个JdbcTemplate实例，通过该实例可以执行SQL查询和更新。
• jdbcTemplate.queryForObject()方法可以执行一个查询并返回一个结果对象，我们需要传入三个参数：
• SQL查询语句，第一个参数为占位符，使用“?”作为占位符可以避免SQL注入攻击。
• 参数列表，第二个参数为SQL查询中占位符对应的值，同样使用数组的方式传递。
• 结果集映射器，第三个参数指定了结果集需要映射成的对象类型，这里我们使用了Spring提供的BeanPropertyRowMapper，可以自动将结果集映射成指定类型的对象。

4. 执行SQL更新

除了查询操作，我们还需要执行SQL更新操作，例如插入、更新和删除等。示例代码如下：

@Autowired
private JdbcTemplate jdbcTemplate;

public void updateTest() {
    String sql = "INSERT INTO employee(name, age, address) VALUES (?, ?, ?)";
    jdbcTemplate.update(sql, "张三", 25, "北京市海淀区");
}

解释一下：

• 我们同样注入了一个JdbcTemplate实例，通过该实例可以执行SQL查询和更新。
• jdbcTemplate.update()方法可以执行一个SQL更新，我们需要传入两个参数：
• SQL更新语句，同样使用“?”作为占位符。
• 参数列表，第二个参数为SQL占位符对应的值，同样使用数组的方式传递。

示例

下面我们给出两个基于JdbcTemplate的示例：

1. 查询示例

假设我们有如下的数据库表employee：

CREATE TABLE employee (
  id INT PRIMARY KEY AUTO_INCREMENT,
  name VARCHAR(20),
  age INT,
  address VARCHAR(200)
);

我们需要查询出id为1的员工记录，示例代码如下：

@Repository
public class EmployeeDao {

    @Autowired
    private JdbcTemplate jdbcTemplate;

    public Employee getEmployeeById(int id) {
        String sql = "SELECT * FROM employee WHERE id = ?";
        Employee employee = jdbcTemplate.queryForObject(sql,
                 new Object[]{id},
                 new BeanPropertyRowMapper<>(Employee.class));
        return employee;
    }

}

解释一下：

• DAO层中我们注入了一个JdbcTemplate对象，用于执行SQL查询。
• getEmployeeById()方法中我们传入一个int类型的参数id，用于指定查询条件。
• 我们使用了jdbcTemplate.queryForObject()方法执行查询操作，并将结果集映射成一个Employee对象。

2. 更新示例

假设我们需要向employee表中插入一条员工记录，示例代码如下：

@Service
public class EmployeeService {

    @Autowired
    private JdbcTemplate jdbcTemplate;

    public void addEmployee(Employee employee) {
        String sql = "INSERT INTO employee(name, age, address) VALUES (?, ?, ?)";
        jdbcTemplate.update(sql, employee.getName(),
                employee.getAge(),
                employee.getAddress());
    }

}

解释一下：

• Service层中我们同样注入了一个JdbcTemplate对象，用于执行SQL更新操作。
• addEmployee()方法中我们传入一个Employee对象，用于插入一条员工记录。
• 我们使用了jdbcTemplate.update()方法执行插入操作，其中占位符对应的值来自于Employee对象的属性值。

总结

Spring JdbcTemplate是一个非常好用的基于JDBC的模板框架，它简化了JDBC API的使用，提高了开发效率。通过上面的介绍，我们可以看到JdbcTemplate的基本操作和应用，可以在实际项目中快速启动并使用。