从 Aggregate Roots 发布事件

QWen Flash 中英对照 Publishing Events from Aggregate Roots

由 repositories 管理的实体是聚合根。在 Domain-Driven Design 应用中，这些聚合根通常会发布领域事件。Spring Data 提供了一个名为 @DomainEvents 的注解，你可以将其用于聚合根的方法上，使发布尽可能简单，如下例所示：

class AnAggregateRoot {

    @DomainEvents 1
    Collection<Object> domainEvents() {
        // … return events you want to get published here
    }

    @AfterDomainEventPublication 2
    void callbackMethod() {
       // … potentially clean up domain events list
    }
}

java

• 使用 @DomainEvents 的方法可以返回单个事件实例或事件集合。该方法不得接受任何参数。

• 在所有事件发布完成后，存在一个使用 @AfterDomainEventPublication 注解的方法。您可以使用它来清理待发布的事件列表（以及其他用途）。

每当调用以下任一 Spring Data 仓库方法时，这些方法都会被调用：

• save(…), saveAll(…)

• delete(…), deleteAll(…), deleteAllInBatch(…), deleteInBatch(…)

请注意，这些方法以聚合根实例作为参数。这也是 deleteById(…) 明显缺失的原因：实现可能会选择发起删除实例的查询，因此我们一开始就无法访问聚合实例。