Spring : AsyncAnnotationBeanPostProcessor

最新推荐文章于 2025-05-01 14:36:50 发布

安迪源文

最新推荐文章于 2025-05-01 14:36:50 发布

阅读量1.6k

点赞数

CC 4.0 BY-SA版权

分类专栏： Spring Core

本文链接：https://blog.youkuaiyun.com/andy_zhang2007/article/details/96612088

本文介绍了Spring框架中的AsyncAnnotationBeanPostProcessor类，它用于处理类或方法级别的异步注解，确保异步方法的正确执行。当检测到@Async注解时，它会使用任务执行器来实现异步调用。默认情况下，它会查找或创建一个SimpleAsyncTaskExecutor。异常处理方面，返回void的方法异常可通过Future捕获，其他返回类型可配置AsyncUncaughtExceptionHandler。AsyncAnnotationBeanPostProcessor还会将目标对象包装在代理中。文章提供了相关类和注解的引用。

摘要生成于 C知道，由 DeepSeek-R1 满血版支持，前往体验 >

概述

AsyncAnnotationBeanPostProcessor是一个AbstractBeanFactoryAwareAdvisingPostProcessor/BeanPostProcessor,它在容器启动时被使用，检测每个bean是否符合在类级别或者方法级别使用异步注解，如果使用了，则会使用一个AsyncAnnotationAdvisor包裹该bean,从而该bean上通过异步注解所定义的方法在调用时会被真正地异步调用起来。

上面所提到的"异步注解"可以通过AsyncAnnotationBeanPostProcessor指定，如果不指定，则缺省是指Spring @Async注解和EJB 3.1 javax.ejb.Asynchronous注解。

另外在真正执行异步调用的方面，可以为AsyncAnnotationBeanPostProcessor指定一个任务执行器TaskExecutor，如果不指定，AsyncAnnotationBeanPostProcessor会这么决定一个任务执行器:

如果容器中存在唯一的一个TaskExecutor bean则使用它;
否则从容器中查找名字为taskExecutor类型为Executor的bean;
再不然，就自己创建一个SimpleAsyncTaskExecutor使用。

以上该逻辑，可以参考类源代码AsyncExecutionInterceptor。

在异步执行的异常处理方面，AsyncAnnotationBeanPostProcessor也做了考虑。方法调用的异步执行根据返回结果类型分两种情况：

返回结果类型为void
返回结果类型为Future
对于返回结果类型为Future的情况，不用做任何设置，调用者就可以使用try-catch机制捕捉异步执行产生的异常。而对于返回结果类型为void的情况，Spring支持设置一个AsyncUncaughtExceptionHandler来支持调用者处理其中发生的异常。这个AsyncUncaughtExceptionHandler可以通过AsyncAnnotationBeanPostProcessor来设置。

另外AsyncAnnotationBeanPostProcessor会将AsyncAnnotationAdvisor包裹到代理对象的最外面，也就是在调用链中会被优先调用到。

关于AsyncAnnotationBeanPostProcessor的使用，可以参考如下类 :

注解@EnableAsync – 导入了 AsyncConfigurationSelector
AsyncConfigurationSelector – 导入了 ProxyAsyncConfiguration
ProxyAsyncConfiguration – 使用AsyncAnnotationBeanPostProcessor定义基础设施bean asyncAdvisor

源代码

源代码版本 : spring-context-5.1.5.RELEASE

package org.springframework.scheduling.annotation;

import java.lang.annotation.Annotation;
import java.util.concurrent.Executor;
import java.util.function.Supplier;

import org.apache.commons.logging.Log;
import org.apache.commons.logging.LogFactory;