Spring Modulith 运行时支持
前几章中描述的功能都在测试场景中使用了应用程序模块安排以进行验证和文档记录,或者是有助于松散耦合模块但不能直接与应用程序模块结构一起使用的一般支持功能。 在本节中,我们将描述 Spring Modulith 对应用程序运行时模块初始化的支持。
设置应用程序模块的运行时支持
要启用 Spring Modulith 的运行时支持,请确保包含spring-modulith-runtime
JAR 中的。
-
Maven
-
Gradle
<dependency>
<groupId>org.springframework.modulith</groupId>
<artifactId>spring-modulith-runtime</artifactId>
<scope>runtime</scope>
</dependency>
dependencies {
runtimeOnly 'org.springframework.modulith:spring-modulith-runtime'
}
添加此 JAR 将导致 Spring Boot 自动配置运行,从而在应用程序中注册以下组件:
-
一
ApplicationModulesRuntime
允许访问ApplicationModules
. -
一个
SpringBootApplicationRuntime
支持前一个 bean 以检测 main application 类。 -
一个
ApplicationStartedEvent
将调用ApplicationModuleInitializer
在应用程序上下文中定义的 bean。
应用程序模块初始化器
使用应用程序模块时,通常需要在应用程序启动时执行一些特定于单个模块的代码。 这意味着该代码的执行顺序需要遵循应用程序模块的依赖项结构。 如果模块 B 依赖于模块 A,则 A 的初始化代码必须在 B 的初始化代码之前运行,即使初始化器不直接依赖于另一个初始化器。
虽然开发人员当然可以通过 Spring 的标准来定义执行顺序@Order
annotation 或Ordered
接口中,Spring Modulith 提供了一个ApplicationModuleInitializer
在应用程序启动时运行的 bean 的接口。
这些 bean 的执行顺序将自动遵循应用程序模块依赖项结构。
-
Java
-
Kotlin
@Component
class MyInitializer implements ApplicationModuleInitializer {
@Override
public void initialize() {
// Initialization code goes here
}
}
@Component
class MyInitializer : ApplicationModuleInitializer {
override fun initialize() {
// Initialization code goes here
}
}
请注意,ApplicationModuleInitializer
仅当spring-modulith-runtime
JAR 位于 Classpath 上(请参见设置应用程序模块的运行时支持),因为它会提取根据应用程序模块结构对初始值设定项进行拓扑排序所需的依赖项。