5. Moments — 时间流逝事件 API

spring-modulith-moments是一个 Passage of Time Events 实现，深受 Matthias Verraes 博客文章的启发。 这是一种基于事件的时间方法，用于触发与经过的特定时间段相关的操作。spring-doc.cn

要使用抽象，请在项目中包括以下依赖项：spring-doc.cn

<dependency>
  <groupId>org.springframework.modulith</groupId>
  <artifactId>spring-modulith-moments</artifactId>
</dependency>

添加到项目 Classpath 的依赖项会导致应用程序中出现以下情况：spring-doc.cn

  • 应用程序代码可以引用 Spring 事件侦听器中的 、 类型，以便在经过一定时间时收到通知。HourHasPassedDayHasPassedWeekHasPassedMonthHasPassedQuarterHasPassedYearHasPassedspring-doc.cn

  • 中提供了一个 类型的 bean，其中包含触发这些事件的逻辑。org.springframework.modulith.MomentsApplicationContextspring-doc.cn

  • 如果设置为 ，则该实例将是一个允许 “转移” 时间的实例，并触发所有中间事件，这对于由事件触发的集成测试功能非常有用。spring.modulith.moments.enable-time-machinetrueorg.springframework.modulith.TimeMachinespring-doc.cn

默认情况下，Moments 使用实例。要自定义此 bean，请声明 类型为 的 bean。Clock.systemUTC()Clockspring-doc.cn

@Configuration
class MyConfiguration {

  @Bean
  Clock myCustomClock() {
    // Create a custom Clock here
  }
}

Moments 公开了以下应用程序属性以进行高级自定义：spring-doc.cn

表 1.可用的应用程序属性
财产 默认值 描述

spring.modulith.moments.enable-time-machinespring-doc.cn

假spring-doc.cn

如果设置为 ，则实例将是一个 ，它将公开 API 以向前移动时间。对于需要由 Passed of Time Events 触发的功能的集成测试非常有用。trueMomentsTimeMachinespring-doc.cn

spring.modulith.moments.granularityspring-doc.cn

小时spring-doc.cn

要触发的事件的最小粒度。避免每小时事件的替代值。daysspring-doc.cn

spring.modulith.moments.localespring-doc.cn

Locale.getDefault()spring-doc.cn

确定周边界时使用的。Localespring-doc.cn

spring.modulith.moments.quarter-start-monthspring-doc.cn

Months.JANUARYspring-doc.cn

季度开始的月份。spring-doc.cn

spring.modulith.moments.zone-idspring-doc.cn

ZoneOffset#UTCspring-doc.cn

确定附加到事件发布时间。ZoneIdspring-doc.cn