AxonFramework 命令模型配置详解：从聚合根到仓储实现-优快云博客

本文链接：https://blog.youkuaiyun.com/gitblog_01132/article/details/148577606

AxonFramework 命令模型配置详解：从聚合根到仓储实现

AxonFramework Framework for Evolutionary Message-Driven Microservices on the JVM 项目地址: https://gitcode.com/gh_mirrors/ax/AxonFramework

引言

在基于CQRS架构的应用开发中，命令模型的设计与配置是核心环节。作为AxonFramework的核心模块之一，命令模型的合理配置直接影响到系统的健壮性和可维护性。本文将深入解析AxonFramework中命令模型的配置方法，包括聚合根定义、命令处理器注册以及仓储实现等关键内容。

聚合根配置基础

聚合根是命令模型中的核心概念，它代表业务领域中的核心实体，负责维护业务规则和状态一致性。在AxonFramework中配置聚合根有两种主要方式：

1. 使用配置API方式

通过DefaultConfigurer可以快速配置一个聚合根类：

Configurer configurer = DefaultConfigurer.defaultConfiguration()
       .configureAggregate(GiftCard.class);

这种方式适合纯Java环境下的配置，不依赖任何特定框架。

2. 使用Spring Boot注解方式

对于Spring Boot项目，Axon提供了更便捷的@Aggregate注解：

@Aggregate
public class GiftCard {
    @AggregateIdentifier
    private String id;

    @CommandHandler
    public GiftCard(IssueCardCommand cmd) {
       apply(new CardIssuedEvent(cmd.getCardId(), cmd.getAmount()));
    }
}

关键点说明：

@Aggregate注解标记该类为聚合根
@AggregateIdentifier指定聚合标识符字段
@CommandHandler标记命令处理方法
只需在聚合根类上添加注解，Axon会自动完成剩余配置

命令处理器注册策略

命令处理器是接收并处理特定命令的组件，Axon提供了灵活的注册方式。

聚合内命令处理器

当命令处理方法直接定义在聚合根内部时（如上例所示），聚合注册过程会自动注册这些方法作为命令处理器。这是最直接和推荐的方式。

外部命令处理器

对于需要解耦的场景，可以创建独立的外部命令处理器：

@Component
public class GiftCardCommandHandler {
    private final Repository<GiftCard> giftCardRepository;

    @CommandHandler
    public void handle(RedeemCardCommand cmd) {
        giftCardRepository.load(cmd.getCardId())
                          .execute(giftCard -> giftCard.handle(cmd));
    }
}

在Spring环境中，只需将其声明为Spring组件（@Component）即可自动注册。在纯Java配置中，则需要显式注册：

Configurer axonConfigurer = DefaultConfigurer.defaultConfiguration()
    .registerCommandHandler(conf -> new GiftCardCommandHandler());

重要原则：每个命令类型应该有且只有一个处理器方法，重复注册会导致警告，最后注册的处理器会生效。

仓储实现详解

仓储(Repository)是访问聚合根的入口，Axon提供了多种仓储实现策略。

基础仓储接口

所有仓储都必须实现Repository接口，核心方法包括：

load(identifier)：根据ID加载聚合
load(identifier, version)：带版本号加载（用于冲突检测）
newInstance(factoryMethod)：注册新创建的聚合

删除操作：通过AggregateLifecycle.markDeleted()从聚合内部触发，这是一种状态迁移而非直接删除。

标准仓储实现

标准仓储直接保存聚合的当前状态，适合简单场景：

GenericJpaRepository：基于JPA的实现，要求聚合是JPA实体
自定义仓储：可继承LockingRepository并配合AnnotatedAggregate使用

事件溯源仓储

事件溯源仓储(EventSourcingRepository)只存储事件序列，通过重放事件重建聚合状态：

EventSourcingRepository.builder(GiftCard.class)
    .eventStore(eventStore)
    .build();

在Spring中可自定义仓储bean并通过@Aggregate注解引用：

@Bean
public Repository<GiftCard> customGiftCardRepo(EventStore eventStore) {
    return EventSourcingRepository.builder(GiftCard.class)
                                 .eventStore(eventStore)
                                 .build();
}

@Aggregate(repository = "customGiftCardRepo")
public class GiftCard { /*...*/ }

聚合工厂深度解析

AggregateFactory决定如何从事件流创建聚合实例，是事件溯源仓储的专属配置项。

1. GenericAggregateFactory

默认实现，要求聚合类：

非抽象类
有无参构造函数
不进行初始化操作

2. SpringPrototypeAggregateFactory

支持通过Spring依赖注入的工厂实现：

@Bean
public AggregateFactory<GiftCard> giftCardFactory() {
    return new SpringPrototypeAggregateFactory<>("giftCard");
}

@Scope("prototype")
@Bean
public GiftCard giftCard() {
    return new GiftCard();
}

注意：虽然可以注入依赖，但消息处理方法中的参数注入由Axon的参数解析器处理，与工厂无关。

3. 自定义聚合工厂

对于多态聚合等复杂场景，可自定义工厂：

public class AccountAggregateFactory implements AggregateFactory<Account> {
    @Override
    public Account createAggregateRoot(String aggregateIdentifier, 
                                     DomainEventMessage firstEvent) {
        if (firstEvent instanceof AccountCreatedEvent) {
            AccountCreatedEvent event = (AccountCreatedEvent) firstEvent;
            switch (event.getAccountType()) {
                case PUBLIC: return new PublicUserAccount();
                case BACKOFFICE: return new BackOfficeAccount();
            }
        }
        throw new IllegalArgumentException();
    }
    // 其他必要方法实现...
}