|
对于最新的稳定版本，请使用 Spring Modulith 1.4.3！ |
附录
附录 A：Spring Boot 兼容性
| 弹簧 Modulith 版本 | Spring Boot 版本 （编译） |
Spring Boot 版本 （测试示例） |
jMolecules （编译） |
jMolecules （已测试） |
|---|---|---|---|---|
1.4（快照） |
3.4 |
3.1, 3.2, 3.3, 3.4 |
2023.2 |
2023.2、2025.0 RC2 |
1.3 |
3.4 |
3.1, 3.2, 3.3, 3.4 |
2023.1 |
2023.1， 2023.2， 2025.0 RC2 |
1.2 |
3.3 |
3.1, 3.2, 3.3, 3.4 |
2023.1 |
2023.1， 2023.2， 2025.0 RC2 |
1.1 |
3.2 |
3.1, 3.2, 3.3, 3.4 |
2023.1 |
2023.1， 2023.2， 2025.0 RC2 |
附录 B：Spring Modulith 配置属性
| 属性 | 默认值 | 描述 |
|---|---|---|
|
|
是否配置异步处理终止的默认值，即等待任务完成 2 秒。看 |
|
没有 |
用于检测应用程序模块的策略。
可以是自定义实现的类名 |
|
|
如何将事件发布标记为已完成。 支持以下值：
|
|
|
是否启用事件外部化。 |
|
|
是否初始化 JDBC 事件发布模式。 |
|
事件发布表的架构名称。如果未指定，则表将不会进行模式限定。 |
|
|
|
是否启用 JSON 支持 |
|
|
是否自动启用 MongoDB 的事务。要求数据库使用副本集运行。 |
|
|
是否在 Neo4j 事件发布事件哈希属性上创建索引。 |
|
|
是否启用 JSON 支持 |
|
|
是否在重新启动应用程序时重新发布未完成的事件发布。 通常不建议在多实例部署中使用，因为其他实例可能仍在处理事件。 |
|
|
是否启用 |
|
|
要发布的事件的粒度。( |
|
|
这 |
|
|
要发布的事件日期的时区。 |
|
|
自 1.3 起已弃用。喜欢 |
|
没有 |
这可以是预定义值之一 |
|
没有 |
要计算更改文件集的提交哈希。 通常在 CI 环境中传播，以考虑自上次成功构建以来的所有更改。 |
附录 C：Spring Modulith 模块
| 起动机 | 典型范围 | 包括 |
|---|---|---|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 模块 | 典型范围 | 描述 |
|---|---|---|
|
|
一个 Spring Boot 执行器，用于通过执行器公开应用程序模块结构。 |
|
|
要在生产代码中用于自定义 Spring Modulith 的默认行为的抽象。 |
|
|
一个注释处理器，用于提取 Javadoc 以包含在应用程序模块画布中。 |
|
|
核心应用模块模型和API。 |
|
|
这 |
|
|
AMQP 的事件外部化支持。 |
|
|
API 来自定义 Spring Modulith 的事件功能。 |
|
|
事件发布注册表的核心实现以及集成抽象 |
|
|
基于Jackson的 |
|
|
基于 JDBC 的 |
|
|
对 JMS 的事件外部化支持。 |
|
|
基于 JPA 的 |
|
|
对 Kafka 的事件外部化支持。 |
|
|
Spring Messaging 中的事件外部化支持 |
|
|
基于 MongoDB 的 |
|
|
基于 Neo4j 的 |
|
|
基于应用程序模块结构的测试执行优化。在此处查找更多详细信息。 |
|
|
此处描述的时间流逝事件实现。 |
|
|
此处描述的可观测性基础设施。 |
|
|
支持引导 |
|
|
集成测试支持。在此处查找更多详细信息。 |
附录 E：事件发布注册表架构
基于 JDBC 的事件发布注册表支持期望数据库中存在以下数据库模式。
如果您希望 Spring Modulith 为您创建模式，请设置应用程序属性spring.modulith.events.jdbc-schema-initialization.enabled自true.
H2
CREATE TABLE IF NOT EXISTS EVENT_PUBLICATION
(
ID UUID NOT NULL,
COMPLETION_DATE TIMESTAMP(9) WITH TIME ZONE,
EVENT_TYPE VARCHAR(512) NOT NULL,
LISTENER_ID VARCHAR(512) NOT NULL,
PUBLICATION_DATE TIMESTAMP(9) WITH TIME ZONE NOT NULL,
SERIALIZED_EVENT VARCHAR(4000) NOT NULL,
PRIMARY KEY (ID)
);
CREATE INDEX IF NOT EXISTS EVENT_PUBLICATION_BY_LISTENER_ID_AND_SERIALIZED_EVENT_IDX ON EVENT_PUBLICATION (LISTENER_ID, SERIALIZED_EVENT);
CREATE INDEX IF NOT EXISTS EVENT_PUBLICATION_BY_COMPLETION_DATE_IDX ON EVENT_PUBLICATION (COMPLETION_DATE);HSQLDB
CREATE TABLE IF NOT EXISTS EVENT_PUBLICATION
(
ID UUID NOT NULL,
COMPLETION_DATE TIMESTAMP(9),
EVENT_TYPE VARCHAR(512) NOT NULL,
LISTENER_ID VARCHAR(512) NOT NULL,
PUBLICATION_DATE TIMESTAMP(9) NOT NULL,
SERIALIZED_EVENT VARCHAR(4000) NOT NULL,
PRIMARY KEY (ID)
);
CREATE INDEX IF NOT EXISTS EVENT_PUBLICATION_BY_LISTENER_ID_AND_SERIALIZED_EVENT_IDX ON EVENT_PUBLICATION (LISTENER_ID, SERIALIZED_EVENT);
CREATE INDEX IF NOT EXISTS EVENT_PUBLICATION_BY_COMPLETION_DATE_IDX ON EVENT_PUBLICATION (COMPLETION_DATE);玛丽亚数据库
CREATE TABLE IF NOT EXISTS EVENT_PUBLICATION
(
ID VARCHAR(36) NOT NULL,
LISTENER_ID VARCHAR(512) NOT NULL,
EVENT_TYPE VARCHAR(512) NOT NULL,
SERIALIZED_EVENT VARCHAR(4000) NOT NULL,
PUBLICATION_DATE TIMESTAMP(6) NOT NULL,
COMPLETION_DATE TIMESTAMP(6) DEFAULT NULL NULL,
PRIMARY KEY (ID),
INDEX EVENT_PUBLICATION_BY_COMPLETION_DATE_IDX (COMPLETION_DATE)
);Microsoft SQL Server
IF NOT EXISTS(SELECT * FROM INFORMATION_SCHEMA.TABLES WHERE TABLE_NAME = 'EVENT_PUBLICATION')
CREATE TABLE EVENT_PUBLICATION
(
ID VARCHAR(36) NOT NULL,
LISTENER_ID VARCHAR(512) NOT NULL,
EVENT_TYPE VARCHAR(512) NOT NULL,
SERIALIZED_EVENT VARCHAR(MAX) NOT NULL,
PUBLICATION_DATE DATETIME2(6) NOT NULL,
COMPLETION_DATE DATETIME2(6) NULL,
PRIMARY KEY (ID),
INDEX EVENT_PUBLICATION_BY_COMPLETION_DATE_IDX (COMPLETION_DATE)
);MySQL
CREATE TABLE IF NOT EXISTS EVENT_PUBLICATION
(
ID VARCHAR(36) NOT NULL,
LISTENER_ID VARCHAR(512) NOT NULL,
EVENT_TYPE VARCHAR(512) NOT NULL,
SERIALIZED_EVENT VARCHAR(4000) NOT NULL,
PUBLICATION_DATE TIMESTAMP(6) NOT NULL,
COMPLETION_DATE TIMESTAMP(6) DEFAULT NULL NULL,
PRIMARY KEY (ID),
INDEX EVENT_PUBLICATION_BY_COMPLETION_DATE_IDX (COMPLETION_DATE)
);PostgreSQL
CREATE TABLE IF NOT EXISTS event_publication
(
id UUID NOT NULL,
listener_id TEXT NOT NULL,
event_type TEXT NOT NULL,
serialized_event TEXT NOT NULL,
publication_date TIMESTAMP WITH TIME ZONE NOT NULL,
completion_date TIMESTAMP WITH TIME ZONE,
PRIMARY KEY (id)
);
CREATE INDEX IF NOT EXISTS event_publication_serialized_event_hash_idx ON event_publication USING hash(serialized_event);
CREATE INDEX IF NOT EXISTS event_publication_by_completion_date_idx ON event_publication (completion_date);附录 F：从 Moduliths 迁移
-
o.m.model.Modules已重命名为o.s.m.model.ApplicationModules -
o.m.model.ModuleDetectionStrategy已重命名为o.s.m.model.ApplicationModuleDetectionStrategy -
@o.m.test.ModuleTest已重命名为@o.s.m.test.ApplicationModuleTest -
o.m.docs.Documenter.Options已重命名为o.s.m.docs.Documenter.DiagramOptions -
组件图的图表样式现在默认为
DiagramStyle.C4（通过调用DiagramOptions.withStyle(DiagramStyle.UML)) -
默认情况下，模块画布隐藏未公开的类型。 要在画布中包含 application-module-internal 类型，请配置
CanvasOptions自….revealInternals(). -
组件图和应用程序模块画布的输出文件夹已从
moduliths-docs自spring-modulith-docs位于构建的目标文件夹（例如target对于 Maven）。