模式创建
在使用 SQL 数据库时,模式是必不可少的部分。Spring Data JDBC 支持广泛的模式选项,但在开始使用领域模型时,构建初始领域模型可能具有挑战性。为了帮助您采用代码优先的方法,Spring Data JDBC 集成了使用 Liquibase 创建数据库变更集的功能。
考虑以下领域实体
@Table
class Person {
@Id long id;
String firstName;
String lastName;
LocalDate birthday;
boolean active;
}
通过以下代码渲染初始变更集
RelationalMappingContext context = … // The context contains the Person entity, ideally initialized through initialEntitySet
LiquibaseChangeSetWriter writer = new LiquibaseChangeSetWriter(context);
writer.writeChangeSet(new FileSystemResource(new File(…)));
生成以下变更日志
databaseChangeLog:
- changeSet:
id: '1685969572426'
author: Spring Data Relational
objectQuotingStrategy: LEGACY
changes:
- createTable:
columns:
- column:
autoIncrement: true
constraints:
nullable: false
primaryKey: true
name: id
type: BIGINT
- column:
constraints:
nullable: true
name: first_name
type: VARCHAR(255 BYTE)
- column:
constraints:
nullable: true
name: last_name
type: VARCHAR(255 BYTE)
- column:
constraints:
nullable: true
name: birthday
type: DATE
- column:
constraints:
nullable: false
name: active
type: TINYINT
tableName: person
列类型由实现 SqlTypeMapping 策略接口的对象计算。可空性从类型推断,如果属性类型使用 Java 原始类型,则设置为 false。
模式支持可以在整个应用程序开发生命周期中为您提供帮助。在差异模式下,您向模式写入器实例提供现有的 Liquibase Database,模式写入器将现有表与映射的实体进行比较,并从差异中推导出要创建/删除的表和列。默认情况下,除非您配置 dropTableFilter 和 dropColumnFilter,否则不会删除任何表和列。这两个过滤谓词都提供了表名和列名,以便您的代码可以计算可以删除哪些表和列。
writer.setDropTableFilter(tableName -> …);
writer.setDropColumnFilter((tableName, columnName) -> …);
| 模式支持只能识别添加和删除,即删除未映射的表/列或添加数据库中不存在的列。列不能重命名,数据不能迁移,因为实体映射不提供模式如何演变的详细信息。 |