AxonFramework 消息拦截机制深度解析-CSDN博客

本文链接：https://blog.csdn.net/gitblog_00618/article/details/148577952

AxonFramework 消息拦截机制深度解析

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

消息拦截概述

在 AxonFramework 中，消息拦截是一个强大的功能，它允许开发者在消息处理的不同阶段插入自定义逻辑。消息拦截主要分为两种类型：

分发拦截器(Dispatch Interceptors)：在消息被分发给处理器之前执行
处理拦截器(Handler Interceptors)：在消息处理器被调用之前执行

这两种拦截器为开发者提供了灵活的控制点，可以实现日志记录、验证、安全控制等横切关注点。

命令消息拦截

命令分发拦截器

命令分发拦截器在命令被分发到命令总线时触发，它们可以修改命令消息或完全阻止命令分发。

典型应用场景：

添加元数据
日志记录
结构验证

示例代码：

public class LoggingDispatchInterceptor implements MessageDispatchInterceptor<CommandMessage<?>> {
    @Override
    public BiFunction<Integer, CommandMessage<?>, CommandMessage<?>> handle(List<? extends CommandMessage<?>> messages) {
        return (index, command) -> {
            logger.info("分发命令: {}", command.getPayload());
            return command;
        };
    }
}

结构验证最佳实践：使用 JSR 303 Bean Validation 可以轻松实现命令的结构验证：

CommandBus commandBus = SimpleCommandBus.builder().build();
commandBus.registerDispatchInterceptor(new BeanValidationInterceptor<>());

命令处理拦截器

命令处理拦截器在命令处理器执行前后触发，可以实现更复杂的业务逻辑控制。

典型应用场景：

权限验证
事务管理
性能监控

示例代码：

public class AuthInterceptor implements MessageHandlerInterceptor<CommandMessage<?>> {
    @Override
    public Object handle(UnitOfWork<? extends CommandMessage<?>> unitOfWork, 
                       InterceptorChain interceptorChain) throws Exception {
        CommandMessage<?> command = unitOfWork.getMessage();
        if(!checkPermission(command)) {
            throw new SecurityException("无权执行此命令");
        }
        return interceptorChain.proceed();
    }
}

聚合内部拦截器

AxonFramework 提供了 @CommandHandlerInterceptor 注解，可以在聚合内部定义拦截逻辑：

@Aggregate
public class OrderAggregate {
    @CommandHandlerInterceptor
    public void intercept(PlaceOrderCommand command, InterceptorChain chain) {
        if(isValid(command)) {
            chain.proceed();
        }
    }
}

事件消息拦截

事件分发拦截器

事件分发拦截器在事件发布时触发，适用于全局事件处理逻辑。

典型应用场景：

事件日志
事件增强
事件过滤

public class EventLoggingInterceptor implements MessageDispatchInterceptor<EventMessage<?>> {
    @Override
    public BiFunction<Integer, EventMessage<?>, EventMessage<?>> handle(List<? extends EventMessage<?>> messages) {
        return (index, event) -> {
            auditService.recordEvent(event);
            return event;
        };
    }
}

事件处理拦截器

事件处理拦截器在事件处理器执行前后触发，适用于特定处理器的逻辑。

public class EventValidationInterceptor implements MessageHandlerInterceptor<EventMessage<?>> {
    @Override
    public Object handle(UnitOfWork<? extends EventMessage<?>> unitOfWork, 
                       InterceptorChain chain) throws Exception {
        EventMessage<?> event = unitOfWork.getMessage();
        if(!isValid(event)) {
            return null; // 丢弃事件
        }
        return chain.proceed();
    }
}

查询消息拦截

查询拦截机制与命令拦截类似，同样支持分发和处理两种拦截器。

验证拦截器配置：

QueryBus queryBus = SimpleQueryBus.builder().build();
queryBus.registerDispatchInterceptor(new BeanValidationInterceptor<>());

注解式拦截器

AxonFramework 提供了 @MessageHandlerInterceptor 注解，可以在处理器类中定义细粒度的拦截逻辑：

@MessageHandlerInterceptor(messageType = EventMessage.class)
public void interceptEvent(EventMessage<?> event, InterceptorChain chain) {
    if(shouldProcess(event)) {
        chain.proceed();
    }
}