Spring Boot 2.5.0 重新設(shè)計(jì)的spring.sql.init 配置有啥用
棄用內(nèi)容
先來糾正一個(gè)誤區(qū)。主要之前在版本更新介紹的時(shí)候,存在一些表述上的問題。導(dǎo)致部分讀者認(rèn)為這次的更新是Datasource本身初始化的調(diào)整,但其實(shí)并不是。這次重新設(shè)計(jì)的只是對Datasource腳本初始化機(jī)制的重新設(shè)計(jì)。
先來看看這次被棄用部分的內(nèi)容(位于org.springframework.boot.autoconfigure.jdbc.DataSourceProperties
),如果你有用過這些配置內(nèi)容,那么新配置就很容易理解了。
/** * Mode to apply when determining if DataSource initialization should be performed * using the available DDL and DML scripts. */ @Deprecated private DataSourceInitializationMode initializationMode = DataSourceInitializationMode.EMBEDDED; /** * Platform to use in the DDL or DML scripts (such as schema-${platform}.sql or * data-${platform}.sql). */ @Deprecated private String platform = "all"; /** * Schema (DDL) script resource references. */ private List<String> schema; /** * Username of the database to execute DDL scripts (if different). */ @Deprecated private String schemaUsername; /** * Password of the database to execute DDL scripts (if different). */ @Deprecated private String schemaPassword; /** * Data (DML) script resource references. */ @Deprecated private List<String> data; /** * Username of the database to execute DML scripts (if different). */ @Deprecated private String dataUsername; /** * Password of the database to execute DML scripts (if different). */ @Deprecated private String dataPassword; /** * Whether to stop if an error occurs while initializing the database. */ @Deprecated private boolean continueOnError = false; /** * Statement separator in SQL initialization scripts. */ @Deprecated private String separator = ";"; /** * SQL scripts encoding. */ @Deprecated private Charset sqlScriptEncoding;
對應(yīng)到配置文件里的屬性如下(這里僅列出部分,就不全部列出了,主要就是對應(yīng)上面源碼中的屬性):
spring.datasource.schema= spring.datasource.schema-username= spring.datasource.schema-password= ...
這些配置主要用來指定數(shù)據(jù)源初始化之后要用什么用戶、去執(zhí)行哪些腳本、遇到錯(cuò)誤是否繼續(xù)等功能。
新的設(shè)計(jì)
Spring Boot 2.5.0開始,啟用了全新的配置方式,我們可以從這個(gè)類org.springframework.boot.autoconfigure.sql.init.SqlInitializationProperties
里看到詳情。
下面我們通過一個(gè)簡單的例子來體驗(yàn)這個(gè)功能的作用。
創(chuàng)建一個(gè)Spring Boot的基礎(chǔ)應(yīng)用,并在pom.xml中引入和mysql的依賴:
<dependency> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-starter-jdbc</artifactId> </dependency> <dependency> <groupId>mysql</groupId> <artifactId>mysql-connector-java</artifactId> </dependency>
在配置文件中增加數(shù)據(jù)源和初始化數(shù)據(jù)源的配置,具體如下:
spring.datasource.url=jdbc:mysql://localhost:3306/test spring.datasource.username=root spring.datasource.password= spring.datasource.driver-class-name=com.mysql.cj.jdbc.Driver # Spring Boot 2.5.0 init schema & data # 執(zhí)行初始化腳本的用戶名稱 spring.sql.init.username=root # 執(zhí)行初始化腳本的用戶密碼 spring.sql.init.password= # 初始化的schema腳本位置 spring.sql.init.schema-locations=classpath*:schema-all.sql
根據(jù)上面配置的定義,接下來就在resource
目錄下,創(chuàng)建腳本文件schema-all.sql
,并寫入一些初始化表結(jié)構(gòu)的腳本
create table test.user_info ( id int unsigned auto_increment comment '用戶id' primary key, open_id varchar(255) default '' null comment '微信小程序openid', nick_name varchar(255) default '' null comment '微信名', head_img varchar(255) default '' null comment '微信頭像', sex varchar(255) default '' null comment '性別', phone varchar(255) default '' null comment '手機(jī)', province varchar(255) default '' null comment '注冊地址:省', city varchar(255) default '' null comment '注冊地址:城市', country varchar(255) default '' null comment '注冊地址:縣/區(qū)', status tinyint unsigned default 0 not null comment '是否標(biāo)記刪除 0:否 1:是', create_time datetime not null comment '創(chuàng)建時(shí)間', update_time datetime not null comment '更新時(shí)間' ) comment '用戶表';
完成上面步驟之后,啟動應(yīng)用。然后打開MySQL客戶端,可以看到在test
庫下,多了一個(gè)user_info
表
通過上面的例子,不難想到這樣的功能主要可以用來管理應(yīng)用啟動與數(shù)據(jù)庫配置的自動執(zhí)行,以減少應(yīng)用部署過程中手工執(zhí)行的內(nèi)容,降低應(yīng)用部署的執(zhí)行步驟。
配置詳解
除了上面用到的配置屬性之外,還有一些其他的配置,下面詳細(xì)講解一下作用。
spring.sql.init.enabled
:是否啟動初始化的開關(guān),默認(rèn)是true。如果不想執(zhí)行初始化腳本,設(shè)置為false即可。通過-D的命令行參數(shù)會更容易控制。spring.sql.init.username
和spring.sql.init.password
:配置執(zhí)行初始化腳本的用戶名與密碼。這個(gè)非常有必要,因?yàn)榘踩芾硪?,通常給業(yè)務(wù)應(yīng)用分配的用戶對一些建表刪表等命令沒有權(quán)限。這樣就可以與datasource中的用戶分開管理。spring.sql.init.schema-locations
:配置與schema變更相關(guān)的sql腳本,可配置多個(gè)(默認(rèn)用;
分割)spring.sql.init.data-locations
:用來配置與數(shù)據(jù)相關(guān)的sql腳本,可配置多個(gè)(默認(rèn)用;
分割)spring.sql.init.encoding
:配置腳本文件的編碼spring.sql.init.separator
:配置多個(gè)sql文件的分隔符,默認(rèn)是;
spring.sql.init.continue-on-error:如果執(zhí)行腳本過程中碰到錯(cuò)誤是否繼續(xù),默認(rèn)是
false`;所以,上面的例子第二次執(zhí)行的時(shí)候會報(bào)錯(cuò)并啟動失敗,因?yàn)榈谝淮螆?zhí)行的時(shí)候表已經(jīng)存在。
應(yīng)用建議
關(guān)于這些配置的應(yīng)用,相信聰明的你一定會把它與數(shù)據(jù)庫的版本管理聯(lián)系起來(因?yàn)榭梢宰詣拥膱?zhí)行腳本)。
那么依靠這些配置,是否可以勝任業(yè)務(wù)應(yīng)用部署時(shí)候數(shù)據(jù)庫初始化的自動化實(shí)現(xiàn)呢?
個(gè)人認(rèn)為就上述所介紹的配置,雖然具備了一定的自動執(zhí)行能力。但由于缺失對當(dāng)前環(huán)境的判斷能力,所以要應(yīng)對實(shí)際的部署場景來說,還是遠(yuǎn)遠(yuǎn)不夠的。
如果要自動化的管理數(shù)據(jù)庫表結(jié)構(gòu)、初始化數(shù)據(jù)的話,我的建議是:
- 默認(rèn)提供的這個(gè)初始化功能可以且僅用于單元測試,自動創(chuàng)建數(shù)據(jù)庫結(jié)構(gòu)與初始化數(shù)據(jù),使用完畢后銷毀??梢苑奖愕目刂泼看螁卧獪y試的執(zhí)行環(huán)境一致。
- 應(yīng)用在環(huán)境部署的時(shí)候,還是要使用之前介紹過的Flyway來實(shí)現(xiàn),如何使用可見之前的分享:使用Flyway來管理數(shù)據(jù)庫版本。
- 聯(lián)合Flyway一同使用,通過
org.springframework.jdbc.datasource.init.DataSourceInitializer
來定義更復(fù)雜的執(zhí)行邏輯。
更多本系列免費(fèi)教程連載「點(diǎn)擊進(jìn)入?yún)R總目錄」
代碼示例
本文的相關(guān)例子可以查看下面?zhèn)}庫中的chapter3-13
目錄:
Github:https://github.com/dyc87112/SpringBoot-Learning/
Gitee:https://gitee.com/didispace/SpringBoot-Learning/
到此這篇關(guān)于Spring Boot 2.5.0 重新設(shè)計(jì)的spring.sql.init 配置有啥用?的文章就介紹到這了,更多相關(guān)spring.sql.init 配置內(nèi)容請搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關(guān)文章希望大家以后多多支持腳本之家!
相關(guān)文章
java Spring松耦合高效應(yīng)用簡單實(shí)例分析
在Java項(xiàng)目,龐大的對象依賴關(guān)系將一直緊密耦合引起對象難以管理或修改。在這種情況下,可以使用Spring框架作為一個(gè)核心模塊輕松高效地管理所有的對象依賴。本文章向大家介紹Spring松耦合的實(shí)例,需要的朋友可以參考一下。2016-12-12Java設(shè)計(jì)模式之備忘錄模式_動力節(jié)點(diǎn)Java學(xué)院
我們在編程的時(shí)候,經(jīng)常需要保存對象的中間狀態(tài),當(dāng)需要的時(shí)候,可以恢復(fù)到這個(gè)狀態(tài)。接下來通過本文給大家分享java設(shè)計(jì)模式之備忘錄模式,感興趣的的朋友一起看看吧2017-08-08logback輸出日志屏蔽quartz的debug等級日志方式
這篇文章主要介紹了logback輸出日志屏蔽quartz的debug等級日志方式,具有很好的參考價(jià)值,希望對大家有所幫助。如有錯(cuò)誤或未考慮完全的地方,望不吝賜教2021-08-08Java 關(guān)于遞歸的調(diào)用機(jī)制精細(xì)解讀
關(guān)于遞歸是什么,簡單的說: 遞歸就是方法自己調(diào)用自己,每次調(diào)用時(shí) 傳入不同的變量.遞歸有助于編程者解決復(fù)雜的問題,同時(shí)可以讓代碼變得簡潔2021-10-10使用SpringSecurity 進(jìn)行自定義Token校驗(yàn)
這篇文章主要介紹了使用SpringSecurity 進(jìn)行自定義Token校驗(yàn)操作,具有很好的參考價(jià)值,希望對大家有所幫助。如有錯(cuò)誤或未考慮完全的地方,望不吝賜教2021-06-06Netty進(jìn)階之ChannelPoolMap源碼解析
這篇文章主要介紹了Netty進(jìn)階之ChannelPoolMap源碼解析,ChannelPoolMap是用來存儲ChannelPool和指定key的一個(gè)集合Map,實(shí)際的應(yīng)用場景就是服務(wù)器端是一個(gè)分布式集群服務(wù),擁有多個(gè)配置地址,這樣我們就可以配置多個(gè)服務(wù)地址,減輕單臺服務(wù)器的壓力,需要的朋友可以參考下2023-11-11SpringBoot應(yīng)用監(jiān)控Actuator使用隱患及解決方案
SpringBoot的Actuator 模塊提供了生產(chǎn)級別的功能,比如健康檢查,審計(jì),指標(biāo)收集,HTTP 跟蹤等,幫助我們監(jiān)控和管理Spring Boot 應(yīng)用,本文將給大家介紹SpringBoot應(yīng)用監(jiān)控Actuator使用隱患及解決方案,需要的朋友可以參考下2024-07-07