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();
}
事件处理器的某些方面也可以在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模块的依赖关系。