Spring Boot 2.5 终于对数据源动刀了!


分享一份《Spring Boot 学习笔记,太全了!》

差点带沟里了

最近有看过《Spring Boot 2.5 重磅发布》一文的朋友应该都知道,Spring Boot 2.5 有一个数据源的重大变动,那就是某些数据源初始化的方法被重新设计了,下面的数据源参数配置也被废除了:

spring.datasource.*

新的数据源参数配置如下:

spring.sql.init.*

今天把项目升级到了 Spring Boot 2.5,再顺便把 spring.datasource 也换成了 spring.sql.init:

spring:
sql.init:
driver-class-name: com.mysql.cj.jdbc.Driver
url: jdbc:mysql://localhost:3306/javastack
username: root
password: 12345678

以为会很顺利,启动居然报错:

数据源参数不是被重命名了吗,咋不行。。。

看来新的数据源参数并没有被识别,于是抱着怀疑的态度看了下 Spring Boot 2.5 数据源参数绑定类 DataSourceProperties 的源码:

数据源参数绑定前缀依然还是:spring.datasource!!!

咦……怎么和我原先理解的不太一样,有鬼了。。

再注意看上图左边部分,有 4 个类被标识废除了,然后我再全局搜索了下新的参数 spring.sql.init 在源码中使用到的地方:

可以看到一些数据源参数被拿到 SqlInitializationProperties 类去了。

从废除的几个类,再到新参数使用到的几个新类,它们都指向的是初始化 SQL 数据库(比如:新建一张表、初始化表数据),而不是初始化数据源(和数据库建立连接池),这是两个概念,前者需要依赖后者完成。。

WC,差点被带沟里了……

初始化 SQL 数据库

好吧,既然清楚了,我们再来验证下新的 SQL 数据库初始化机制,看看理解是否有错。

下面直接说重点,Spring Boot 基础框架就就不介绍了,不清楚的可以关注公众号:Java技术栈,在后台回复:boot,我写的一堆实战教程都整理好了。

添加数据源和 SQL 初始化参数:

spring:
datasource:
driver-class-name: com.mysql.cj.jdbc.Driver
url: jdbc:mysql://localhost:3306/javastack
username: root
password: 12345678
sql.init:
schemaLocations:
- classpath:sql/create_t_javastack.sql
dataLocations:
- classpath:sql/insert_t_javastack.sql

注意上面的 sql.init.*,更多初始化参数请参考这个类:

org.springframework.boot.autoconfigure.sql.init.SqlInitializationProperties

新建对应的创建表 SQL 文件:

sql/create_t_javastack.sql

CREATE TABLE IF NOT EXISTS `t_javastack`(
`id` INT AUTO_INCREMENT,
`title` VARCHAR(50) NOT NULL,
`content` VARCHAR(100) NOT NULL,
PRIMARY KEY ( `id` )
);

新建对应的初始化表数据 SQL 文件:

sql/insert_t_javastack.sql

insert into t_javastack(title, content) values
('标题1', '内容1'),
('标题2', '内容2'),
('标题3', '内容3'),
('标题4', '内容4'),
('标题5', '内容5');

OK,启动正常,再来验证下表是否创建,数据是否插入:

mysql> desc t_javastack;
+---------+--------------+------+-----+---------+----------------+
| Field | Type | Null | Key | Default | Extra |
+---------+--------------+------+-----+---------+----------------+
| id | int | NO | PRI | NULL | auto_increment |
| title | varchar(50) | NO | | NULL | |
| content | varchar(100) | NO | | NULL | |
+---------+--------------+------+-----+---------+----------------+
3 rows in set (0.00 sec)

mysql> select * from t_javastack;
+----+---------+---------+
| id | title | content |
+----+---------+---------+
| 1 | 标题1 | 内容1 |
| 2 | 标题2 | 内容2 |
| 3 | 标题3 | 内容3 |
| 4 | 标题4 | 内容4 |
| 5 | 标题5 | 内容5 |
+----+---------+---------+
5 rows in set (0.00 sec)

现在终于和我理解的一致了,你理解了吗?

这个功能可能在单元测试的时候有用到,生产环境是不太可能会用到的。

总结

Spring Boot 2.5 中的 spring.sql.init. 是初始化 SQL 数据库使用的新参数前缀,不再使用前缀 spring.datasource. 了,后续版本会进行移除,其实就是 DDL/DML 配置和数据源连接配置分家了。

新的参数确实也更清楚明朗了,小伙伴们有用到 SQL 数据库初始化功能的,升级 Spring Boot 2.5 时可以注意一下。有时候理论看再多,还不如实践一次,实践出真理,你以为你理解对了,其实不然。

本文完整的的示例源码已经上传:

https://github.com/javastacks/spring-boot-best-practice

大家可以 Star 学习一下,Spring Boot 2.5 我还在慢慢踩坑中,后面会形成更多实战干货文章,关注公众号Java技术栈第一时间推送。

最后,大家觉得本文有用的话,动动小手,给栈长来个小小的在看、转发呗,原创不易,需要你的鼓励哦~

版权申明:本文系公众号 “Java技术栈” 原创,原创实属不易,转载、引用本文内容请注明出处,禁止抄袭、洗稿,请自重,尊重大家的劳动成果和知识产权,抄袭必究。


分享一份《Spring Boot 学习笔记,太全了!》