简介
在“聚合”主页中,我们看到了如何创建由“事件来源”支持的聚合。换句话说,事件源聚合的存储方法是通过重放(事件重放)构成聚合上的更改的事件。
但是,聚合也可以原样存储。这样做时,用于保存和加载聚合的存储库就是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.
}