Liquibase Hibernate 集成项目技术文档

1. 安装指南

1.1 前提条件

• Liquibase 核心库（Liquibase Core）：请从 Liquibase 官方下载页面 下载并安装 Liquibase 核心库。
• Java 1.8 或更高版本。

1.2 下载扩展

根据您的 Hibernate 版本，下载相应的 Liquibase Hibernate 扩展 .jar 文件：

• 对于 Hibernate 6.0+，下载 liquibase-hibernate6.jar。
• 对于 Hibernate 5.0+，下载 liquibase-hibernate5.jar。

1.3 安装扩展

将下载的 .jar 文件放置在 Liquibase 安装目录的 liquibase/lib 文件夹中。如果您希望将扩展文件放置在其他位置，可以在 liquibase.properties 文件中指定扩展 .jar 文件的路径。

2. 项目使用说明

2.1 配置扩展

在您的项目中配置 Liquibase Hibernate 扩展，以便使用 Hibernate 配置作为比较数据库。您可以通过以下方式运行 Liquibase：

• 命令行
• Gradle
• Maven
• Ant

2.2 命令行使用

将扩展 .jar 文件放置在 liquibase/lib 目录后，您可以通过命令行运行 Liquibase 命令，例如 diff、diffChangeLog 和 generateChangeLog。

2.3 Maven 使用

在您的 pom.xml 文件中添加以下依赖项：

<plugin>
    <groupId>org.liquibase</groupId>
    <artifactId>liquibase-maven-plugin</artifactId>
    <version>4.19.0</version>
    <configuration>
        <propertyFile>liquibase.properties</propertyFile>
    </configuration>
    <dependencies>
        <dependency>
            <groupId>org.liquibase.ext</groupId>
            <artifactId>liquibase-hibernate</artifactId>
            <version>${liquibase-hibernate.version}</version>
        </dependency>
    </dependencies>
</plugin>

3. 项目 API 使用文档

3.1 核心 API

Liquibase Hibernate 扩展提供了以下核心 API：

• diff：比较两个数据库的差异。
• diffChangeLog：生成包含差异的变更日志文件。
• generateChangeLog：生成数据库的变更日志。

3.2 配置文件

您可以通过 liquibase.properties 文件配置 Liquibase 和 Hibernate 的连接信息。例如：

classpath=path/to/liquibase-hibernate.jar
url=hibernate:spring:com.example.package?dialect=org.hibernate.dialect.MySQLDialect

4. 项目安装方式

4.1 命令行安装

1. 下载 Liquibase 核心库并安装。
2. 下载 Liquibase Hibernate 扩展 .jar 文件。
3. 将扩展文件放置在 liquibase/lib 目录中。

4.2 Maven 安装

在 pom.xml 文件中添加 Liquibase Hibernate 扩展的依赖项，如上文所述。

4.3 Gradle 安装

在 build.gradle 文件中添加以下依赖项：

dependencies {
    liquibaseRuntime 'org.liquibase.ext:liquibase-hibernate:版本号'
}

通过以上步骤，您可以成功安装并使用 Liquibase Hibernate 扩展，实现与 Hibernate 的集成。