Axon参考指南 - 6.命令处理 - State-Stored Aggregates（状态存储的聚合）

简介

在“聚合”主页中，我们看到了如何创建由“事件来源”支持的聚合。换句话说，事件源聚合的存储方法是通过重放（事件重放）构成聚合上的更改的事件。

但是，聚合也可以原样存储。这样做时，用于保存和加载聚合的存储库就是GenericJpaRepository。（疑问：每一次改变就保存一个聚合状态？还是更新状态？）状态存储的聚合的结构与事件来源的聚合略有不同：

import org.axonframework.commandhandling.CommandHandler;
import org.axonframework.eventhandling.EventHandler;
import org.axonframework.modelling.command.AggregateIdentifier;
import org.axonframework.modelling.command.AggregateMember;

import javax.persistence.CascadeType;
import javax.persistence.Entity;
import javax.persistence.FetchType;
import javax.persistence.Id;
import javax.persistence.JoinColumn;
import javax.persistence.OneToMany;

@Entity // 1.
/**
 * 由于聚合存储在JPA存储库中，因此需要使用@Entity注释该类。
 */
public class GiftCard {

    @Id // 2.
    /**
     * 聚合根必须声明一个包含聚合标识符的字段。发布第一个事件时，必须最迟初始化此标识符。
     * 该标识符字段必须由@AggregateIdentifier注释进行注释。
     * 使用JPA存储聚合时，Axon知道使用JPA提供的@Id批注。由于Aggregate是实体，因此@Id注释是一个硬要求。
     */
    @AggregateIdentifier
    private String id;

    // 3.
    /**
     * 该汇总有几个“汇总成员”。由于聚合按原样存储，因此应考虑实体的正确映射。
     */
    @OneToMany(fetch = FetchType.EAGER, cascade = CascadeType.ALL)
    @JoinColumn(name = "giftCardId")
    @AggregateMember
    private List<GiftCardTransaction> transactions = new ArrayList<>();

    private int remainingValue;

    @CommandHandler  // 4.
    /**
     * @CommandHandler批注的构造函数，或以其他方式放置“命令处理构造函数”。
     * 此注释告诉框架给定的构造函数能够处理IssueCardCommand。
     */
    public GiftCard(IssueCardCommand cmd) {
        if (cmd.getAmount() <= 0) {
            throw new IllegalArgumentException("amount <= 0");
        }
        id = cmd.getCardId();
        remainingValue = cmd.getAmount();

        // 5.
        /**
         * 静态AggregateLifecycle＃apply（Object ...）可用于发布事件消息。
         * 调用此函数后，提供的对象将在应用它们的聚合范围内以EventMessages的形式发布。
         */
        apply(new CardIssuedEvent(cmd.getCardId(), cmd.getAmount()));
    }

    @CommandHandler
    public void handle(RedeemCardCommand cmd) {
        // 6.
        /**
         * Command Handling方法将首先确定传入的Command在这一点上是否有效。
         */
        if (cmd.getAmount() <= 0) {
            throw new IllegalArgumentException("amount <= 0");
        }
        if (cmd.getAmount() > remainingValue) {
            throw new IllegalStateException("amount > remaining value");
        }
        if (transactions.stream().map(GiftCardTransaction::getTransactionId).anyMatch(cmd.getTransactionId()::equals)) {
            throw new IllegalStateException("TransactionId must be unique");
        }

        // 7.
        /**
         * 验证业务逻辑后，可以调整聚合状态
         */
        remainingValue -= cmd.getAmount();
        transactions.add(new GiftCardTransaction(id, cmd.getTransactionId(), cmd.getAmount()));

        apply(new CardRedeemedEvent(id, cmd.getTransactionId(), cmd.getAmount()));
    }

    @EventHandler  // 8.
    /**
     * 通过定义@EventHandler带注释的方法，聚合中的实体可以侦听聚合发布的事件。
     * 当事件消息在被任何外部处理程序处理之前发布时，将调用这些方法。
     */
    protected void on(CardReimbursedEvent event) {
        this.remainingValue += event.getAmount();
    }

    /**
     * JPA必需的无参数构造函数。
     * 如果不提供此构造函数，则会在加载Aggregate时导致异常。
     */
    protected GiftCard() { }  // 9.
}