Spring 与 JDBC

在现代 Java 企业级应用开发中，数据库操作是一个核心部分。Spring Framework 提供了强大的 JDBC 支持，通过 JdbcTemplate 使得与数据库的交互变得更加简单和高效。本文将介绍 JdbcTemplate 的概述、如何使用 JdbcTemplate 进行数据库操作以及如何配置数据源。

1. JdbcTemplate 概述

JdbcTemplate 是 Spring 提供的一个用来简化 JDBC 代码的工具类。它封装了常用的 JDBC 操作，如查询、插入、更新和删除，使得开发人员不再需要编写冗长的 JDBC 代码（如获取连接、创建语句、处理结果集和关闭资源等）。通过 JdbcTemplate，开发人员可以更专注于业务逻辑，实现更简洁和可维护的代码。

1.1 JdbcTemplate 的特点

• 简化 JDBC 操作：减少了大量的样板代码，开发人员可以专注于 SQL 查询和参数设置。
• 自动资源管理：自动处理连接、语句和结果集的打开和关闭，避免资源泄露。
• 统一的异常处理：将 JDBC 异常转换为 Spring 的 DataAccessException，提供更一致的异常处理方式。

2. 使用 JdbcTemplate 进行数据库操作

接下来，我们将通过具体的代码示例，展示如何使用 JdbcTemplate 进行数据库操作。

2.1 添加依赖

在 pom.xml 文件中添加必要的依赖：

<dependencies>
    <!-- Spring JDBC 依赖 -->
    <dependency>
        <groupId>org.springframework</groupId>
        <artifactId>spring-jdbc</artifactId>
        <version>5.3.10</version>
    </dependency>

    <!-- H2 数据库依赖（用于示例） -->
    <dependency>
        <groupId>com.h2database</groupId>
        <artifactId>h2</artifactId>
        <version>1.4.200</version>
        <scope>runtime</scope>
    </dependency>
</dependencies>

2.2 配置数据源

在 Spring 中配置数据源有多种方式，这里我们使用 Java 配置的方式：

package com.example.config;

import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
import org.springframework.jdbc.core.JdbcTemplate;
import org.springframework.jdbc.datasource.DriverManagerDataSource;

import javax.sql.DataSource;

@Configuration
public class DataSourceConfig {

    @Bean
    public DataSource dataSource() {
        DriverManagerDataSource dataSource = new DriverManagerDataSource();
        dataSource.setDriverClassName("org.h2.Driver");
        dataSource.setUrl("jdbc:h2:mem:testdb");
        dataSource.setUsername("sa");
        dataSource.setPassword("");
        return dataSource;
    }

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

2.3 使用 JdbcTemplate 进行数据库操作

创建一个 User 实体类和一个 UserDao 数据访问对象类，演示如何使用 JdbcTemplate 进行数据库操作。

package com.example.entity;

public class User {
    private int id;
    private String name;
    private String email;

    // Getters and Setters
}

package com.example.dao;

import com.example.entity.User;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.jdbc.core.JdbcTemplate;
import org.springframework.jdbc.core.RowMapper;
import org.springframework.stereotype.Repository;

import java.sql.ResultSet;
import java.sql.SQLException;
import java.util.List;

@Repository
public class UserDao {

    @Autowired
    private JdbcTemplate jdbcTemplate;

    public int save(User user) {
        String sql = "INSERT INTO users (name, email) VALUES (?, ?)";
        return jdbcTemplate.update(sql, user.getName(), user.getEmail());
    }

    public int update(User user) {
        String sql = "UPDATE users SET name=?, email=? WHERE id=?";
        return jdbcTemplate.update(sql, user.getName(), user.getEmail(), user.getId());
    }

    public int delete(int id) {
        String sql = "DELETE FROM users WHERE id=?";
        return jdbcTemplate.update(sql, id);
    }

    public User findById(int id) {
        String sql = "SELECT * FROM users WHERE id=?";
        return jdbcTemplate.queryForObject(sql, new RowMapper<User>() {
            @Override
            public User mapRow(ResultSet rs, int rowNum) throws SQLException {
                User user = new User();
                user.setId(rs.getInt("id"));
                user.setName(rs.getString("name"));
                user.setEmail(rs.getString("email"));
                return user;
            }
        }, id);
    }

    public List<User> findAll() {
        String sql = "SELECT * FROM users";
        return jdbcTemplate.query(sql, new RowMapper<User>() {
            @Override
            public User mapRow(ResultSet rs, int rowNum) throws SQLException {
                User user = new User();
                user.setId(rs.getInt("id"));
                user.setName(rs.getString("name"));
                user.setEmail(rs.getString("email"));
                return user;
            }
        });
    }
}

2.4 测试 JdbcTemplate

编写一个简单的 MainApp 类来测试我们的 JdbcTemplate 功能：

package com.example;

import com.example.config.DataSourceConfig;
import com.example.dao.UserDao;
import com.example.entity.User;
import org.springframework.context.ApplicationContext;
import org.springframework.context.annotation.AnnotationConfigApplicationContext;

public class MainApp {
    public static void main(String[] args) {
        ApplicationContext context = new AnnotationConfigApplicationContext(DataSourceConfig.class);
        UserDao userDao = context.getBean(UserDao.class);

        // 创建表
        userDao.jdbcTemplate().execute("CREATE TABLE users (id INT AUTO_INCREMENT, name VARCHAR(50), email VARCHAR(50), PRIMARY KEY (id))");

        // 添加用户
        User user = new User();
        user.setName("Alice");
        user.setEmail("alice@example.com");
        userDao.save(user);

        // 查询所有用户
        System.out.println("All users: " + userDao.findAll());

        // 更新用户
        user.setName("Alice Updated");
        userDao.update(user);

        // 查询用户
        User foundUser = userDao.findById(user.getId());
        System.out.println("Found user: " + foundUser);

        // 删除用户
        userDao.delete(user.getId());

        // 查询所有用户
        System.out.println("All users after delete: " + userDao.findAll());
    }
}

3. 总结

通过本文的示例，我们展示了如何使用 Spring JdbcTemplate 简化数据库操作。通过配置数据源和 JdbcTemplate，我们可以轻松地进行数据库查询、插入、更新和删除操作。Spring JdbcTemplate 提供了统一的异常处理和自动资源管理，极大地简化了开发过程，提高了代码的可维护性和可靠性。