从聚合根发布事件

Doubao 中英对照 Publishing Events from Aggregate Roots

由仓库管理的实体是聚合根。在领域驱动设计应用程序中，这些聚合根通常会发布领域事件。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(…) 明显缺席的原因，因为实现可能会选择发出一条删除该实例的查询，这样我们一开始就根本无法访问聚合实例。