首頁 > 軟體

SpringBoot整合Liquibase的範例程式碼

2022-02-10 13:00:06

SpringBoot整合Liquibase雖然不難但坑還是有一點的,主要集中在設定路徑相關的地方,在此記錄一下整合的步驟,方便以後自己再做整合時少走彎路,當然也希望能幫到大家~

整合有兩種情況

  1. 在啟動專案時自動執行指令碼,若新新增了Liquibase指令碼需要重啟專案才能執行指令碼
  2. 在不啟動專案時也能通過外掛或指令手動讓它執行指令碼

整合要麼只整合1,要麼1、2一起整合

只整合2不整合1的話,專案啟動時會生成liquibase相關的bean時報錯

整合1

引入Maven依賴

這裡匯入了Liquibase的包和連線MySQL資料庫的包

<!-- https://mvnrepository.com/artifact/org.liquibase/liquibase-core -->
<dependency>
    <groupId>org.liquibase</groupId>
    <artifactId>liquibase-core</artifactId>
    <version>3.6.2</version>
</dependency>
<dependency>
    <groupId>mysql</groupId>
    <artifactId>mysql-connector-java</artifactId>
    <scope>runtime</scope>
</dependency>

在SpringBoot組態檔中設定

設定中liquibase相關的只需要設定根changelog的位置,資料庫相關設定liquibase會自己去拿datasource下面的,注意url需要加上時區serverTimezone

spring:
  datasource:
    username: root
    password: root
    url: jdbc:mysql://localhost:3306/test_database?useUnicode=true&characterEncoding=UTF-8&serverTimezone=Asia/Shanghai
  liquibase:
    change-log: classpath:/db/liquibaseChangeLogFile.xml

設定liquibaseChangeLogFile.xml

同樣需要注意xml檔案的路徑,按照上述設定的話該檔案在src/main/resources/db/liquibaseChangeLogFile.xml

<?xml version="1.0" encoding="utf-8"?>
<databaseChangeLog
    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    xmlns="http://www.liquibase.org/xml/ns/dbchangelog"
    xsi:schemaLocation="http://www.liquibase.org/xml/ns/dbchangelog
                        http://www.liquibase.org/xml/ns/dbchangelog/dbchangelog-3.4.xsd">
                        
<!--relativeToChangelogFile="true"表示根據該changeLog的相對路徑尋找changeLog檔案-->
    <includeAll path="changelog/" relativeToChangelogFile="true"/>
</databaseChangeLog>

設定changeLog.xml

  • 按照上述的設定的話,changeLog檔案應該放在src/main/resources/db/changelog/
  • 下面簡單寫一個changelog來測試
<?xml version="1.0" encoding="utf-8"?>
<databaseChangeLog
        xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
        xmlns="http://www.liquibase.org/xml/ns/dbchangelog"
        xsi:schemaLocation="http://www.liquibase.org/xml/ns/dbchangelog
                      http://www.liquibase.org/xml/ns/dbchangelog/dbchangelog-3.4.xsd">
    <changeSet id="20201212-01-2344" author="RR">
        <createTable tableName="test_table">
            <column name="id" type="VARCHAR(32)" remarks="表ID">
                <constraints primaryKey="true"/>
            </column>
            <column name="user_name" type="VARCHAR(16)" remarks="使用者名稱">
                <constraints nullable="false"/>
            <column name="age" type="TINYINT">
            <column name="create_date" type="TIMESTAMP" remarks="建立日期" defaultValueComputed="CURRENT_TIMESTAMP"/>
        </createTable>
    </changeSet>
    
</databaseChangeLog>

整合情況:

按照上面的流程設定完,在啟動專案時,它就會執行未執行過的Lisquibase指令碼了~

整合2

有時候想不啟動或不重啟專案時執行Liquibase指令碼,此時就應該整合2

引入Maven外掛

引入的外掛版本和上面的依賴包的版本號保持一致,不過我也沒有考究過不一致會怎樣,有興趣的小夥伴可以試試 ,不過不一致看得不會難受嗎在這裡的configuration標籤中,設定好要讀取的liquibase相關資訊的組態檔,並且注意好路徑

<build>
    <plugins>
        <plugin>
            <groupId>org.liquibase</groupId>
            <artifactId>liquibase-maven-plugin</artifactId>
            <version>3.6.2</version>
            <configuration>
                <propertyFile>src/main/resources/liquibase.properties</propertyFile>
                <!--設定引數,以禁用彈出的對話方塊,該對話方塊將確認非本地資料庫上的遷移-->
                <promptOnNonLocalDatabase>false</promptOnNonLocalDatabase>
            </configuration>
        </plugin>
    </plugins>
</build>

設定Liquibase.properties

注意組態檔的路徑應跟在設定Maven外掛時宣告的一致,即src/main/resources/liquibase.properties設定好如下的五個屬性,注意url需要加上時區serverTimezone注意changeLogFile項的路徑,它是一個相對路徑,該設定會在下面展示

#設定都整合在yml組態檔裡了,若想不啟動時執行liquibase指令碼該設定不能省!!!!
driver-class-name=com.mysql.jdbc.Driver
url=jdbc:mysql://localhost:3306/test_database?useUnicode=true&characterEncoding=UTF-8&serverTimezone=Asia/Shanghai
username=root
password=root
changeLogFile=db/liquibaseChangeLogFile.xml

設定liquibaseChangeLogFile.xml

在整合1的時候就已經設定好了~

設定changeLog.xml

按照上述的設定的話,changeLog檔案應該放在src/main/resources/db/changelog/下面再寫一個liquibase指令碼

<?xml version="1.0" encoding="utf-8"?>
<databaseChangeLog
        xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
        xmlns="http://www.liquibase.org/xml/ns/dbchangelog"
        xsi:schemaLocation="http://www.liquibase.org/xml/ns/dbchangelog
                      http://www.liquibase.org/xml/ns/dbchangelog/dbchangelog-3.4.xsd">
    <changeSet id="20201213-01-1525" author="RR">
        <insert tableName="test_table">
            <column name="id" value="34f0186001df406fbb373845c579e6a6"/>
            <column name="user_name" value="小明"/>
            <column name="age" value="18"/>
        </insert>
    </changeSet>
</databaseChangeLog>

測試整合情況

  • 先mvn clean和install一下!!! 否則不能找到我們寫的xml檔案
  • 在maven外掛中找到liquibase:update,雙擊即可~

補充:下面給大家分享一段範例程式碼講解下spring boot 整合 liquibase

1.新增依賴

<dependency>
   <groupId>org.liquibase</groupId>
   <artifactId>liquibase-core</artifactId>
   <version>3.8.3</version>
</dependency>
<dependency>
   <groupId>org.liquibase</groupId>
   <artifactId>liquibase-maven-plugin</artifactId>
   <version>3.8.3</version>
</dependency>
<plugin>
   <groupId>org.liquibase</groupId>
   <artifactId>liquibase-maven-plugin</artifactId>
   <version>3.8.3</version>
   <configuration>
      <propertyFile>src/main/resources/db/liquibase.properties</propertyFile>
   </configuration>
</plugin>

2.建立liquibase.properties 內容如下

url=jdbc:postgresql://127.0.0.1:5432/ems_factorymodeldb
username=name
password=password
driver=org.postgresql.Driver
outputChangeLogFile=src/main/resources/liquibase-outputChangeLog.xml

3.建立 db.changelog-master.xml

<?xml version="1.0" encoding="UTF-8"?>
<databaseChangeLog
        xmlns="http://www.liquibase.org/xml/ns/dbchangelog"
        xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
        xsi:schemaLocation="http://www.liquibase.org/xml/ns/dbchangelog
     http://www.liquibase.org/xml/ns/dbchangelog/dbchangelog-3.8.xsd">
    <!--  版本更新迭代  -->
    <include file="classpath:db/changelogs/liquibase-changeLog.xml" relativeToChangelogFile="false"></include>
    <!--  現有資料  -->
    <includeAll path="./currentdatas" relativeToChangelogFile="true"/>
    <!--  資料初始化 指令碼  -->
    <!-- <includeAll path="./defaultdatas" relativeToChangelogFile="true"/>-->
</databaseChangeLog>

4.增加設定

# liquibase
spring.liquibase.enabled=true
spring.liquibase.change-log=classpath:db/db.changelog-master.xml

到此這篇關於SpringBoot整合Liquibase的文章就介紹到這了,更多相關SpringBoot整合Liquibase內容請搜尋it145.com以前的文章或繼續瀏覽下面的相關文章希望大家以後多多支援it145.com!


IT145.com E-mail:sddin#qq.com