Spring Boot集成外部库Liquibase多Changelog管理教程

package com.example.app.config;

import liquibase.integration.spring.SpringLiquibase;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
import org.springframework.context.annotation.DependsOn;

import javax.sql.DataSource;

@Configuration // 确保这个配置类被Spring扫描到
public class MultipleLiquibaseConfiguration {

    /**
     * 配置外部库的Liquibase实例
     * 负责执行 library.xml 中的迁移
     * @param dataSource 应用程序的数据源
     * @return 配置好的 SpringLiquibase 实例
     */
    @Bean
    public SpringLiquibase liquibaseLib(DataSource dataSource) {
        SpringLiquibase liquibase = new SpringLiquibase();
        liquibase.setDataSource(dataSource);
        liquibase.setChangeLog("classpath:library.xml"); // 指定库的 changelog 文件
        // 可以根据需要设置其他属性，如默认模式、上下文等
        // liquibase.setDefaultSchema("lib_schema");
        return liquibase;
    }

    /**
     * 配置主应用程序的Liquibase实例
     * 负责执行 main.xml 中的迁移
     * @param dataSource 应用程序的数据源
     * @return 配置好的 SpringLiquibase 实例
     */
    @Bean
    @DependsOn("liquibaseLib") // 如果主应用的迁移依赖于库的迁移，则使用 @DependsOn
    public SpringLiquibase liquibaseMain(DataSource dataSource) {
        SpringLiquibase liquibase = new SpringLiquibase();
        liquibase.setDataSource(dataSource);
        liquibase.setChangeLog("classpath:main.xml"); // 指定主应用的 changelog 文件
        // 可以根据需要设置其他属性
        return liquibase;
    }
}

# 主应用程序的Liquibase配置 (通常由 spring.liquibase 自动配置)
spring.liquibase.change-log=classpath:/main.xml
spring.liquibase.enabled=true
# ... 其他 spring.liquibase.* 属性

# 外部库的Liquibase配置，使用自定义前缀 'lib.liquibase'
lib.liquibase.change-log=classpath:/library.xml
lib.liquibase.enabled=true
# ... 其他 lib.liquibase.* 属性

package com.example.app; // 假设这是你的主应用包

import liquibase.integration.spring.SpringLiquibase;
import org.springframework.beans.factory.ObjectProvider;
import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
import org.springframework.boot.autoconfigure.liquibase.LiquibaseAutoConfiguration.LiquibaseConfiguration;
import org.springframework.boot.autoconfigure.liquibase.LiquibaseDataSource;
import org.springframework.boot.autoconfigure.liquibase.LiquibaseProperties;
import org.springframework.boot.context.properties.ConfigurationProperties;
import org.springframework.boot.context.properties.EnableConfigurationProperties;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.DependsOn;

import javax.sql.DataSource;

@SpringBootApplication
// 启用对 LiquibaseProperties 的配置属性绑定，允许我们创建多个实例
@EnableConfigurationProperties(LiquibaseProperties.class)
public class DemoApplication { // 可以是你的主启动类或任何 @Configuration 类

    public static void main(String[] args) {
        SpringApplication.run(DemoApplication.class, args);
    }

    /**
     * 创建并配置主应用程序的Liquibase实例。
     * 绑定到 'spring.liquibase' 前缀的属性。
     * 
     * @param dataSource 主数据源
     * @param liquibaseDataSource 特定于Liquibase的数据源 (如果定义)
     * @param properties 绑定到 'spring.liquibase' 的 LiquibaseProperties
     * @return 配置好的 SpringLiquibase 实例
     */
    @Bean // "main" liquibase
    // 如果需要，可以指定执行顺序：@DependsOn("liquibaseLib")
    @ConfigurationProperties("spring.liquibase") // 绑定到 spring.liquibase.* 属性
    public SpringLiquibase liquibaseMain(
            ObjectProvider<DataSource> dataSource,
            @LiquibaseDataSource ObjectProvider<DataSource> liquibaseDataSource,
            LiquibaseProperties properties) {
        // 使用 Spring Boot 内部的 LiquibaseConfiguration 辅助类来创建 SpringLiquibase 实例
        // 这样可以复用 Spring Boot 自动配置的逻辑
        LiquibaseConfiguration helper = new LiquibaseConfiguration(properties);
        return helper.liquibase(dataSource, liquibaseDataSource);
    }

    /**
     * 创建并配置外部库的Liquibase实例。
     * 绑定到 'lib.liquibase' 前缀的属性。
     * 
     * @param dataSource 主数据源
     * @param liquibaseDataSource 特定于Liquibase的数据源 (如果定义)
     * @param properties 绑定到 'lib.liquibase' 的 LiquibaseProperties
     * @return 配置好的 SpringLiquibase 实例
     */
    @Bean // lib liquibase
    @ConfigurationProperties("lib.liquibase") // 绑定到 lib.liquibase.* 属性
    public SpringLiquibase liquibaseLib(
            ObjectProvider<DataSource> dataSource,
            @LiquibaseDataSource ObjectProvider<DataSource> liquibaseDataSource,
            LiquibaseProperties properties) {
        // 同上，使用辅助类
        LiquibaseConfiguration helper = new LiquibaseConfiguration(properties);
        return helper.liquibase(dataSource, liquibaseDataSource);
    }
}