从聚合根发布事件

DeepSeek V3 中英对照 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(…) 方法明显缺失的原因，因为实现可能会选择发出一个删除实例的查询，因此我们首先就无法访问到聚合实例。