9. 附录

附录 A：Spring 模数配置属性

财产 默认值 描述

spring.modulith.default-async-terminationspring-doc.cadn.net.cn

truespring-doc.cadn.net.cn

是否为异步处理终止配置默认值，即等待任务完成 2 秒。看TaskExecutionProperties了解详情。spring-doc.cadn.net.cn

spring.modulith.events.jdbc.schema-initialization.enabledspring-doc.cadn.net.cn

falsespring-doc.cadn.net.cn

是否初始化 JDBC 事件发布架构。spring-doc.cadn.net.cn

spring.modulith.events.mongodb.transaction-management.enabledspring-doc.cadn.net.cn

truespring-doc.cadn.net.cn

是否自动为 MongoDB 启用事务。要求使用副本集运行数据库。spring-doc.cadn.net.cn

spring.modulith.moments.enableTimeMachinespring-doc.cadn.net.cn

falsespring-doc.cadn.net.cn

是否启用TimeMachine.spring-doc.cadn.net.cn

spring.modulith.moments.granularityspring-doc.cadn.net.cn

HOURSspring-doc.cadn.net.cn

要发布的事件的粒度。(HOURS,DAYS)spring-doc.cadn.net.cn

spring.modulith.moments.localespring-doc.cadn.net.cn

Locale.getDefault()spring-doc.cadn.net.cn

这Locale在确定周边界时使用。spring-doc.cadn.net.cn

spring.modulith.moments.zoneIdspring-doc.cadn.net.cn

ZoneOffset.UTCspring-doc.cadn.net.cn

要发布的事件的日期的时区。spring-doc.cadn.net.cn

spring.modulith.republish-outstanding-events-on-restartspring-doc.cadn.net.cn

falsespring-doc.cadn.net.cn

是否在应用程序重新启动时重新发布未完成的事件发布。spring-doc.cadn.net.cn

附录 B：Spring Modulith 模块

表 4.Spring Modulith Starters POM
起动机 典型范围 包括

spring-modulith-starter-corespring-doc.cadn.net.cn

compilespring-doc.cadn.net.cn

spring-modulith-starter-insightspring-doc.cadn.net.cn

runtimespring-doc.cadn.net.cn

spring-modulith-starter-jdbcspring-doc.cadn.net.cn

compilespring-doc.cadn.net.cn

spring-modulith-starter-jpaspring-doc.cadn.net.cn

compilespring-doc.cadn.net.cn

spring-modulith-starter-mongodbspring-doc.cadn.net.cn

compilespring-doc.cadn.net.cn

spring-modulith-starter-testspring-doc.cadn.net.cn

testspring-doc.cadn.net.cn
表 5.单个 Spring Modulith JAR
模块 典型范围 描述

spring-modulith-actuatorspring-doc.cadn.net.cn

runtimespring-doc.cadn.net.cn

一个 Spring Boot 执行器，用于通过 Actuator 公开应用程序模块结构。spring-doc.cadn.net.cn

spring-modulith-apispring-doc.cadn.net.cn

compilespring-doc.cadn.net.cn

要在 生产代码中用于自定义 Spring Modulith 的默认行为的抽象。spring-doc.cadn.net.cn

spring-modulith-corespring-doc.cadn.net.cn

runtimespring-doc.cadn.net.cn

核心应用程序模块模型和 API。spring-doc.cadn.net.cn

spring-modulith-docsspring-doc.cadn.net.cn

testspring-doc.cadn.net.cn

这DocumenterAPI 从模块模型创建 Asciidoctor 和 PlantUML 文档。spring-doc.cadn.net.cn

spring-modulith-events-corespring-doc.cadn.net.cn

runtimespring-doc.cadn.net.cn

事件发布注册表的核心实现以及集成抽象EventPublicationRegistry和EventPublicationSerializer.spring-doc.cadn.net.cn

spring-modulith-events-jacksonspring-doc.cadn.net.cn

runtimespring-doc.cadn.net.cn

基于 Jackson 的EventPublicationSerializer.spring-doc.cadn.net.cn

spring-modulith-events-jdbcspring-doc.cadn.net.cn

runtimespring-doc.cadn.net.cn

基于 JDBC 的EventPublicationRegistry.spring-doc.cadn.net.cn

spring-modulith-events-jpaspring-doc.cadn.net.cn

runtimespring-doc.cadn.net.cn

基于 JPA 的EventPublicationRegistry.spring-doc.cadn.net.cn

spring-modulith-events-mongodbspring-doc.cadn.net.cn

runtimespring-doc.cadn.net.cn

基于 MongoDB 的EventPublicationRegistry.spring-doc.cadn.net.cn

spring-modulith-momentsspring-doc.cadn.net.cn

compilespring-doc.cadn.net.cn

此处介绍了 Passage of Time 事件实现。spring-doc.cadn.net.cn

spring-modulith-runtimespring-doc.cadn.net.cn

runtimespring-doc.cadn.net.cn

支持引导ApplicationModules实例。通常不直接依赖，而是传递使用spring-modulith-actuator和spring-modulith-observability.spring-doc.cadn.net.cn

spring-modulith-observabilityspring-doc.cadn.net.cn

runtimespring-doc.cadn.net.cn

可观测性基础设施。spring-doc.cadn.net.cn

附录 C：事件发布注册表架构

基于 JDBC 的事件发布注册表支持要求数据库中存在以下数据库架构。 如果您希望 Spring Modulith 为您创建模式，请设置 application 属性spring.modulith.events.jdbc-schema-initialization.enabled自true.spring-doc.cadn.net.cn

9.C.1.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)
)

9.C.2.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)
)

9.C.3.MySQL （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)
)

9.C.4.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)
)

附录 D：从 Moduliths 迁移

  • o.m.model.Modules已重命名为o.s.m.model.ApplicationModulesspring-doc.cadn.net.cn

  • o.m.model.ModuleDetectionStrategy已重命名为o.s.m.model.ApplicationModuleDetectionStrategyspring-doc.cadn.net.cn

  • @o.m.test.ModuleTest已重命名为@o.s.m.test.ApplicationModuleTestspring-doc.cadn.net.cn

  • o.m.docs.Documenter.Options已重命名为o.s.m.docs.Documenter.DiagramOptionsspring-doc.cadn.net.cn

  • 组件图的图表样式现在默认为DiagramStyle.C4（通过调用DiagramOptions.withStyle(DiagramStyle.UML))spring-doc.cadn.net.cn

  • 默认情况下，模块 canvas 会隐藏未公开的类型。 要在画布中包含 application-module-internal 类型，请配置CanvasOptions自….revealInternals().spring-doc.cadn.net.cn

  • 组件图和应用程序模块 canvases 的输出文件夹已从moduliths-docs自spring-modulith-docs位于构建的目标文件夹（例如target对于 Maven）。spring-doc.cadn.net.cn