从聚合根发布事件

DeepSeek V3 中英对照 Publishing Events from Aggregate Roots

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