Spring JdbcTemplate 案例详解教程

（感谢您的关注和点赞支持！）

Spring JdbcTemplate

Spring JdbcTemplate 是 Spring Framework 中用于简化 JDBC 操作的一个轻量级封装工具类。它提供了一系列的方法来执行 SQL 查询、更新、批处理等操作，从而减轻了开发者手动处理 JDBC 的繁琐细节，例如关闭连接、处理异常、清理资源等。

Spring提供的数据访问模板，提供了很多方便操作数据库的方法

update (更新数据)
batchUpdate (批量更新数据库)
queryForObject (查询单行)
query （查询多行）
queryForObject (单值查询)不同的

步骤：

1. 添加依赖

<dependency><groupId>org.springframework</groupId><artifactId>spring-orm</artifactId><version>5.3.9</version>
</dependency>
<dependency><groupId>org.springframework</groupId><artifactId>spring-context</artifactId><version>5.3.9</version>
</dependency>

完整 pom.xml 如下：

<?xml version="1.0" encoding="UTF-8"?>
<project xmlns="http://maven.apache.org/POM/4.0.0"xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd"><modelVersion>4.0.0</modelVersion><groupId>org.example</groupId><artifactId>Spring06-JdbcTemplated</artifactId><version>1.0-SNAPSHOT</version><dependencies><dependency><groupId>org.springframework</groupId><artifactId>spring-orm</artifactId><version>5.3.9</version></dependency><dependency><groupId>org.springframework</groupId><artifactId>spring-context</artifactId><version>5.3.9</version></dependency><dependency><groupId>mysql</groupId><artifactId>mysql-connector-java</artifactId><version>8.0.26</version></dependency><dependency><groupId>log4j</groupId><artifactId>log4j</artifactId><version>1.2.17</version></dependency><dependency><groupId>org.projectlombok</groupId><artifactId>lombok</artifactId><version>1.18.20</version></dependency></dependencies>
</project>

2. Spring 配置文件

配置数据源 --》配置 JdbcTemplate 》 Dao 》Service

dao和service 使用注解

配置扫描

spring.xml 文件配置如下：

<?xml version="1.0" encoding="UTF-8"?>
<beans xmlns="http://www.springframework.org/schema/beans"xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"xmlns:context="http://www.springframework.org/schema/context"xsi:schemaLocation="http://www.springframework.org/schema/beans http://www.springframework.org/schema/beans/spring-beans.xsd http://www.springframework.org/schema/context https://www.springframework.org/schema/context/spring-context.xsd"><!--JdbcTempldatedatasource - JdbcTempldate - Dao -Service -Controller--><context:component-scan base-package="com.wdzl"/><bean name="dataSource" class="org.springframework.jdbc.datasource.DriverManagerDataSource"><property name="username" value="root"></property><property name="password" value="root"></property><property name="url" value="jdbc:mysql://127.0.0.1:3306/booksys"></property><property name="driverClassName" value="com.mysql.cj.jdbc.Driver"></property></bean><bean name="jdbcTemplate" class="org.springframework.jdbc.core.JdbcTemplate"><property name="dataSource" ref="dataSource"/></bean>
</beans>

3. 编写类

pojo ---Book
dao ---- IBookDao 和 BookDaoImpl
service ----IBookService 和 BookService

注意：添加注解

实体类 Book ：

@Data
public class Book {private Integer bookid;private String bookname;private Float price;private String author;private Date pubDate;
}

Dao 接口 IBookDao ：

public interface IBookDao {List<Book> queryAll();Book get(Integer bookid);void save(Book book);
}

Dao 接口实现类 BookDaoImpl：

查询用到了 RowMapper 接口

在 Spring JDBC 模块中，RowMapper 是一个接口，用于将数据库结果集中的一行数据映射到 Java 对象。

当从数据库查询数据时，Spring JDBC 提供的 JdbcTemplate 类或者其他类似的类（如 NamedParameterJdbcTemplate）会使用 RowMapper 来将结果集转换成应用程序所需的 POJO（Plain Old Java Object）列表。

@Repository("bookDao")
public class BookDaoImpl implements IBookDao {@Autowiredprivate JdbcTemplate template;@Overridepublic List<Book> queryAll() {String sql = "select bookid,bookname,pubdate,price,authorid from book";List<Book> list = template.query(sql, new BookRowMapper());return list;}@Overridepublic Book get(Integer bookid) {return null;}@Overridepublic void save(Book book) {}// 内部类 实现 RowMapper 接口class BookRowMapper implements RowMapper{@Overridepublic Book mapRow(ResultSet resultSet, int i) throws SQLException {Book book = new Book();book.setBookname(resultSet.getString("bookname"));book.setPrice(resultSet.getFloat("price"));
//            book.setAuthor(resultSet.getString("author"));book.setPubDate(resultSet.getDate("pubdate"));return book;}}
}

业务类接口 IBookService :

public interface IBookService {List<Book> queryAll();Book get(Integer bookid);void save(Book book);
}

业务类 BookService :

@Service
public class BookService implements IBookService {@Autowired@Qualifier("bookDao")private IBookDao bookDao;@Overridepublic List<Book> queryAll() {return bookDao.queryAll();}@Overridepublic Book get(Integer bookid) {return bookDao.get(bookid);}@Overridepublic void save(Book book) {bookDao.save(book);}
}

4. 测试类

public class TestJdbc {public static void main(String[] args) {ApplicationContext context = new ClassPathXmlApplicationContext("sping.xml");IBookService bookSerice = context.getBean("bookService", IBookService.class);bookSerice.queryAll().forEach(System.out::println);}
}

BeanPropertyRowMapper 用法

BeanPropertyRowMapper 实现了 RowMapper 接口的实现类

BeanPropertyRowMapper 是 Spring JDBC 提供的一个预定义的 RowMapper 实现类，它可以自动将数据库查询结果映射到 Java Bean 类型的对象上。

相比于自定义 RowMapper，BeanPropertyRowMapper 更加方便和快捷，因为它可以根据 Java Bean 类的属性名与数据库查询结果中的列名自动进行映射。

使用 BeanPropertyRowMapper 的优势在于，只需要提供对应的 Java Bean 类型，它就能通过反射机制自动将 ResultSet 中的列值注入到 Bean 的相应属性中。

前提条件是，Java Bean 类的属性名必须与数据库表的列名大小写完全一致，或者按照驼峰命名规则自动转化为下划线分隔的小写形式。

@Overridepublic Book get(Integer bookid) {String sql = "select bookid ,bookname,pubdate,price,authorid from book where bookid=?";
//        Book book = template.queryForObject(sql, Book.class,bookid);Book book = template.queryForObject(sql, new BeanPropertyRowMapper<>(Book.class),bookid);return book;}

批量更新

batchUpdate() 是 Spring JDBC 模块中 JdbcTemplate 类提供的一个方法，用于批量执行 SQL 更新操作，比如 INSERT、UPDATE 或 DELETE。

这种方法主要用于提高数据库操作的性能，特别是在处理大量数据时，通过一次性发送一组 SQL 语句到数据库，可以显著降低网络传输开销，并且数据库通常会对批量操作进行优化处理。

public void batchSave(List<Book> list){String sql = "insert into book (bookname,price,authorid,pubdate)values(?,?,?,?)";List<Object[]> params = new ArrayList<>();for (Book book : list) {Object[] param = {book.getBookname(),book.getPrice(),2,new Date()};params.add(param);}int[] ints = template.batchUpdate(sql, params);System.out.println(Arrays.toString(ints));
}

c3p0 连接池

如果需要使用第三方的连接池，只需要修改 <bean name="dataSource"> 的配置即可

添加依赖

<dependency><groupId>com.mchange</groupId><artifactId>c3p0</artifactId><version>0.9.5.2</version>
</dependency>

配置更换数据源

<!-- c3p0 连接 -->
<bean name="dataSource" class="com.mchange.v2.c3p0.ComboPooledDataSource"><property name="user" value="root"></property><property name="password" value="root"></property><property name="jdbcUrl" value="jdbc:mysql://127.0.0.1:3306/booksys"></property><property name="driverClass" value="com.mysql.cj.jdbc.Driver"></property><property name="initialPoolSize" value="3"/>
</bean>

更换完成后，直接使用之前的测试类运行即可！

属性文件引用

数据源连接配置信息，单独使用资源文件编辑

在 spring 配置文件中引用

配置引入文件

<context:property-placeholder location="db.properties"/>

修改数据源配置

注意：常见错误
配置使用${username} 时，异常：
Access denied for user 'Administrator'@'localhost' (using password: YES)
原因：username 是默认关键字，默认取值为操作系统登录用户名

解决办法：修改属性文件中关键字，不用username

<bean name="dataSource" class="com.mchange.v2.c3p0.ComboPooledDataSource"><property name="user" value="${username}"></property><property name="password" value="${password}"></property><property name="jdbcUrl" value="${url}"></property><property name="driverClass" value="${driver}"></property><property name="initialPoolSize" value="3"/>
</bean>

上面问题的解决办法如下：

属性文件文件 db.properties 如下：

jdbc.url=jdbc:mysql://127.0.0.1:3306/booksys?serverTimezone=GMT
jdbc.driver=com.mysql.cj.jdbc.Driver
jdbc.username=root
jdbc.password=root

spring.xml 配置文件中使用 ${} 引用上面的键即可

<bean name="dataSource" class="com.mchange.v2.c3p0.ComboPooledDataSource"><property name="user" value="${jdbc.username}"></property><property name="password" value="${jdbc.password}"></property><property name="jdbcUrl" value="${jdbc.url}"></property><property name="driverClass" value="${jdbc.driver}"></property><property name="initialPoolSize" value="3"/>
</b