quarkus依赖注入之十二：禁用类级别拦截器

欢迎访问我的GitHub

这里分类和汇总了欣宸的全部原创(含配套源码)：https://github.com/zq2599/blog_demos

本篇概览

本篇是《quarkus依赖注入》系列的第十二篇，继续学习拦截器的另一个高级特性：禁用类级别拦截器
本篇由以下内容构成

总的来说，本篇内容非常简单，就是说清楚NoClassInterceptors注解用在哪里，怎么用，可以轻松愉快的阅读

类拦截器和方法拦截器的叠加效果

接下来进行编码，看看作用在类上和方法上的两个拦截器的叠加效果，要新建的文件清单如下

以下是每个文件的详细内容

第一个拦截器TrackClass，用来修饰类，对类的每个方法都有拦截效果

@InterceptorBinding

@Target({ElementType.TYPE, ElementType.METHOD})

@Retention(RetentionPolicy.RUNTIME)

public @interface TrackClass {

}

TrackClass的拦截功能实现类TrackClassInterceptor

@TrackClass

@Interceptor

public class TrackClassInterceptor {

    @AroundInvoke

    Object execute(InvocationContext context) throws Exception {

        Log.info("from TrackClass");

        return context.proceed();

    }

}

第二个拦截器TrackMethod，用来修饰方法，只对被修饰的方法有拦截效果

@InterceptorBinding

@Target({ElementType.TYPE, ElementType.METHOD})

@Retention(RetentionPolicy.RUNTIME)

public @interface TrackMethod {

}

TrackMethod的拦截功能实现类TrackMethodInterceptor

@TrackMethod

@Interceptor

public class TrackMethodInterceptor {

    @AroundInvoke

    Object execute(InvocationContext context) throws Exception {

        Log.info("from TrackMethod");

        return context.proceed();

    }

}

为了演示拦截器的效果，创建一个bean，如下所示，TrackClass修饰在类上面，所以test0和test1方法都会被TrackClassInterceptor拦截，另外，test1方法还会被TrackMethodInterceptor，也就是说两个拦截器都会拦截test1方法

@ApplicationScoped

@TrackClass

public class ExcludeInterceptorDemo {

    public void test0() {

        Log.info("from test0");

    }

    @TrackMethod

    public void test1() {

        Log.info("from test1");

    }

}

用单元测试类验证效果

@QuarkusTest

public class ExcludeInterceptorTest {

    @Inject

    ExcludeInterceptorDemo excludeInterceptorDemo;

    @Test

    public void test() {

        excludeInterceptorDemo.test0();

        Log.info("*****************************");

        excludeInterceptorDemo.test1();

    }

}

运行效果如下，可见test0被类拦截器拦截，而test1先后被类拦截器和方法拦截器拦截

当然了，以上一切都是符合预期的，并没有什么问题

用注解NoClassInterceptors使类拦截器失效

假设遇到了某些冲突（例如和数据库、IO相关等），导致TrackClassInterceptor和TrackMethodInterceptor两个拦截器不能同时对test1方法进行拦截，只能保留TrackMethodInterceptor
此时，可以用注解NoClassInterceptors修饰test1方法，如下图红框所示，这样类拦截器TrackClassInterceptor就会失效，只剩下TrackMethodInterceptor可以正常工作

再次执行单元测试，效果如下图，可见类拦截器TrackClassInterceptor不再拦截被NoClassInterceptors修饰的test1方法

NoClassInterceptors的影响范围

回顾类拦截器TrackClassInterceptor，如下图红框，可见其拦截方法有注解AroundInvoke修饰

而NoClassInterceptors的作用，就是针对有注解AroundInvoke修饰的方法，使他们失效
除了AroundInvoke，NoClassInterceptors还针对AroundConstruct修饰的方法，使他们失效
至此，拦截器的高级特性已经全部学习和实践完成，希望能给您提供一些参考，助您设计出更完善的拦截器

源码下载

本篇实战的完整源码可在GitHub下载到，地址和链接信息如下表所示(https://github.com/zq2599/blog_demos)

名称	链接	备注
项目主页	https://github.com/zq2599/blog_demos	该项目在GitHub上的主页
git仓库地址(https)	https://github.com/zq2599/blog_demos.git	该项目源码的仓库地址，https协议
git仓库地址(ssh)	git@github.com:zq2599/blog_demos.git	该项目源码的仓库地址，ssh协议

这个git项目中有多个文件夹，本次实战的源码在quarkus-tutorials文件夹下，如下图红框

quarkus-tutorials是个父工程，里面有多个module，本篇实战的module是basic-di，如下图红框

欢迎关注博客园：程序员欣宸

学习路上，你不孤单，欣宸原创一路相伴...