Axon Framework官方文档(十二)

12. Spring Boot AutoConfiguration

Axon对Springboot的自动配置的支持是最简单的选择,可以用它开始配置Axon基础设施组件。你只需添axon-spring-boot-starter依赖,Axon将自动配置基本的基础设施组件(命令总线、事件总线),以及运行和存储聚合和Sagas所需的任何组件。
根据在应用程序上下文中的其他组件,如果他们在应用程序上下文中不是已经明确定义,Axon将定义某些组件。这意味着只需要配置不同于默认值的组件。

12.1 Event Bus and Event Store Configuration(事件总线和事件存储配置)

如果JPA可用,事件存储默认使用JPA事件存储引擎。这允许在没有任何显式配置的情况下使用事件源存储聚合。
如果JPA不可用,那么Axon默认设置为SimpleEventBus,这意味着您需要为每个聚合指定一个非事件源存储库,或者在您的Spring配置中配置一个EventStorageEngine。
要配置一个不同的事件存储引擎,即使JPA在类路径上,只需定义一个类型EventStorageEngine的bean(使用事件源)或EventBus(如果不需要事件源的话)。

12.2 Command Bus Configuration(事件总线配置)

如果在应用程序上下文中没有显式定义CommandBus的实现,那么Axon将配置SimpleCommandBus。这个CommandBus将使用PlatformTransactionManager管理事务,如果这个事务管理在上下文中可用的话。
如果定义的唯一CommandBus bean是DistributedCommandBus 实现,那么Axon仍将配置CommandBus实现,以作为分布式CommandBus的本地段。这个bean将获得一个“localSegment”的限定符。建议将DistributedCommandBus 定义为@primary,以便在依赖项注入时获得优先级。

12.3 Aggregate Configuration(聚合配置)

@Aggregate注解(包org.axonframework.spring.stereotype)触发自动配置,设置必要的组件,来讲被注解的类型看做聚合。注意,只有聚合根需要该注解。
Axon会自动将所有@ commandhandler注释的方法注册到命令总线中,如果仓储不存在的话,则会设置一个存储库。
建立一个与默认情况不同的存储库,可以在应用程序上下文中定义一个。可选地,你可以定义要使用的存储库的名称,在@Aggregate上使用repository 属性。如果没有定义存储库属性,Axon将尝试以聚合的名称使用存储库(第一个字符小写),后缀为Repository。依此类推,一个MyAggregate类的类型,默认的存储库名字叫myAggregateRepository。如果没有找到那个名称的bean,Axon将定义一个EventSourcingRepository(如果没有可用的EventStore则会失败)。

12.4 Saga Configuration(saga配置)

操作saga的基础设施组件的配置是@Saga注解触发的(在org.axonframework.spring.stereotype包中)。Axon会配置一个SagaManagert和SagaRepository。SagaRepository将在上下文中使用一个可用的SagaStore(如果找到JPA默认为JPASagaStore)为实际Saga存储。
为Saga使用不同的SagaStores,在每个@Saga注解的sagaStore属性中,提供要使用的SagaStore的bean名称。
Saga将从应用程序上下文中注入资源。注意,这并不意味着Spring-injecting用于注入这些资源。@Autowired和@javax.inject.Inject注解可用于标定依赖关系,但它们由Axon通过寻找这些被注解的字段和方法来注入。构造函数注入(还)不支持。

12.5 Event Handling Configuration(事件处理程序的配置)

默认情况下,包含@EventHandler注解方法的所有单实例Spring bean组件将被订阅到事件处理器上,以接收发布到事件总线的事件消息。
EventHandlingConfiguration bean,在应用上下文中可用,它有许多方法可以帮助我们来调整事件处理程序。有关配置事件处理程序和事件处理器的详细信息,请参阅配置API。
更新事件处理程序配置,创建一个autowired方法,设置你想要的配置:
@Autowired
public void configure(EventHandlingConfiguration config) {
    config.usingTrackingProcessors(); // default all processors to tracking mode.
}
事件处理器的某些方面也可以在application.properties中配置。
axon.eventhandling.processors["name"].mode=tracking
axon.eventhandling.processors["name"].source=eventBus
或者使用application.yml:
axon:
    eventhandling:
        processors:
            name:
                mode: tracking
                source: eventBus
我们在上面配置的source属性指的是实现了SubscribableMessageSource或StreamableMessageSource的bean的名称,它被用来做上述处理器的事件源。source的默认事件总线或事件存储应该在应用程序上下文中定义。

12.6 Enabling AMQP

为了启用AMQP支持,确保axon-amqp模块在类路径上,并且在应用程序上下文中AMQP ConnectionFactory是可用的(例如通过引用spring-boot-starter-amqp)。
将应用程序中生成的事件转发给AMQP通道,一行application.properties配置就够了:
axon.amqp.exchange=ExchangeName
这将自动发送所有已发布的事件到AMQP中给定名字的Exchange上。
默认情况下,发送时没有使用AMQP事务。这可以使用axon.amqp.transaction-mode属性来覆盖,并设置它为transactional 或publisher-ack。
要从队列中接收事件并在Axon应用程序中进行处理,您需要配置SpringAMQPMessageSource:
@Bean
public SpringAMQPMessageSource myQueueMessageSource(AMQPMessageConverter messageConverter) {
    return new SpringAMQPMessageSource(messageConverter) {

        @RabbitListener(queues = "myQueue")
        @Override
        public void onMessage(Message message, Channel channel) throws Exception {
            super.onMessage(message, channel);
        }
    };
}
然后配置一个处理器来使用此bean作为其消息的源:
axon.eventhandling.processors["name"].source=myQueueMessageSource

12.7 Distributing commands using JGroups

还在开发中。。。
如果您不能等待,就添加对axon -spring-boot-starter- jgroups模块的依赖关系。
  • 0
    点赞
  • 2
    收藏
    觉得还不错? 一键收藏
  • 0
    评论
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值