类 AsyncAnnotationBeanPostProcessor
- java.lang.Object
- org.springframework.aop.framework.ProxyConfig
- org.springframework.aop.framework.ProxyProcessorSupport
- org.springframework.aop.framework.AbstractAdvisingBeanPostProcessor
- org.springframework.aop.framework.autoproxy.AbstractBeanFactoryAwareAdvisingPostProcessor
- org.springframework.scheduling.annotation.AsyncAnnotationBeanPostProcessor
- 所有已实现的接口:
Serializable
,AopInfrastructureBean
,Aware
,BeanClassLoaderAware
,BeanFactoryAware
,BeanPostProcessor
,Ordered
public class AsyncAnnotationBeanPostProcessor extends AbstractBeanFactoryAwareAdvisingPostProcessor
Bean post-processor that automatically applies asynchronous invocation behavior to any bean that carries theAsync
annotation at class or method-level by adding a correspondingAsyncAnnotationAdvisor
to the exposed proxy (either an existing AOP proxy or a newly generated proxy that implements all of the target's interfaces).The
TaskExecutor
responsible for the asynchronous execution may be provided as well as the annotation type that indicates a method should be invoked asynchronously. If no annotation type is specified, this post- processor will detect both Spring's@Async
annotation as well as the EJB 3.1javax.ejb.Asynchronous
annotation.For methods having a
void
return type, any exception thrown during the asynchronous method invocation cannot be accessed by the caller. AnAsyncUncaughtExceptionHandler
can be specified to handle these cases.Note: The underlying async advisor applies before existing advisors by default, in order to switch to async execution as early as possible in the invocation chain.
- 从以下版本开始:
- 3.0
- 作者:
- Mark Fisher, Juergen Hoeller, Stephane Nicoll
- 另请参阅:
Async
,AsyncAnnotationAdvisor
,AbstractAdvisingBeanPostProcessor.setBeforeExistingAdvisors(boolean)
,ScheduledAnnotationBeanPostProcessor
, 序列化表格
字段概要
字段 修饰符和类型 字段 说明 static String
DEFAULT_TASK_EXECUTOR_BEAN_NAME
The default name of theTaskExecutor
bean to pick up: "taskExecutor".protected Log
logger
从类继承的字段 org.springframework.aop.framework.AbstractAdvisingBeanPostProcessor
advisor, beforeExistingAdvisors
从接口继承的字段 org.springframework.core.Ordered
HIGHEST_PRECEDENCE, LOWEST_PRECEDENCE
构造器概要
构造器 构造器 说明 AsyncAnnotationBeanPostProcessor()
方法概要
所有方法 实例方法 具体方法 修饰符和类型 方法 说明 void
configure(Supplier<Executor> executor, Supplier<AsyncUncaughtExceptionHandler> exceptionHandler)
Configure this post-processor with the given executor and exception handler suppliers, applying the corresponding default if a supplier is not resolvable.void
setAsyncAnnotationType(Class<? extends Annotation> asyncAnnotationType)
Set the 'async' annotation type to be detected at either class or method level.void
setBeanFactory(BeanFactory beanFactory)
Callback that supplies the owning factory to a bean instance.void
setExceptionHandler(AsyncUncaughtExceptionHandler exceptionHandler)
Set theAsyncUncaughtExceptionHandler
to use to handle uncaught exceptions thrown by asynchronous method executions.void
setExecutor(Executor executor)
Set theExecutor
to use when invoking methods asynchronously.从类继承的方法 org.springframework.aop.framework.autoproxy.AbstractBeanFactoryAwareAdvisingPostProcessor
isEligible, prepareProxyFactory
从类继承的方法 org.springframework.aop.framework.AbstractAdvisingBeanPostProcessor
customizeProxyFactory, isEligible, postProcessAfterInitialization, postProcessBeforeInitialization, setBeforeExistingAdvisors
从类继承的方法 org.springframework.aop.framework.ProxyProcessorSupport
evaluateProxyInterfaces, getOrder, getProxyClassLoader, isConfigurationCallbackInterface, isInternalLanguageInterface, setBeanClassLoader, setOrder, setProxyClassLoader
从类继承的方法 org.springframework.aop.framework.ProxyConfig
copyFrom, isExposeProxy, isFrozen, isOpaque, isOptimize, isProxyTargetClass, setExposeProxy, setFrozen, setOpaque, setOptimize, setProxyTargetClass, toString
字段详细资料
DEFAULT_TASK_EXECUTOR_BEAN_NAME
public static final String DEFAULT_TASK_EXECUTOR_BEAN_NAME
The default name of theTaskExecutor
bean to pick up: "taskExecutor".Note that the initial lookup happens by type; this is just the fallback in case of multiple executor beans found in the context.
- 从以下版本开始:
- 4.2
- 另请参阅:
AsyncExecutionAspectSupport.DEFAULT_TASK_EXECUTOR_BEAN_NAME
, 常量字段值
构造器详细资料
AsyncAnnotationBeanPostProcessor
public AsyncAnnotationBeanPostProcessor()
方法详细资料
configure
public void configure(@Nullable Supplier<Executor> executor, @Nullable Supplier<AsyncUncaughtExceptionHandler> exceptionHandler)
Configure this post-processor with the given executor and exception handler suppliers, applying the corresponding default if a supplier is not resolvable.- 从以下版本开始:
- 5.1
setExecutor
public void setExecutor(Executor executor)
Set theExecutor
to use when invoking methods asynchronously.If not specified, default executor resolution will apply: searching for a unique
TaskExecutor
bean in the context, or for anExecutor
bean named "taskExecutor" otherwise. If neither of the two is resolvable, a local default executor will be created within the interceptor.
setExceptionHandler
public void setExceptionHandler(AsyncUncaughtExceptionHandler exceptionHandler)
Set theAsyncUncaughtExceptionHandler
to use to handle uncaught exceptions thrown by asynchronous method executions.- 从以下版本开始:
- 4.1
setAsyncAnnotationType
public void setAsyncAnnotationType(Class<? extends Annotation> asyncAnnotationType)
Set the 'async' annotation type to be detected at either class or method level. By default, both theAsync
annotation and the EJB 3.1javax.ejb.Asynchronous
annotation will be detected.This setter property exists so that developers can provide their own (non-Spring-specific) annotation type to indicate that a method (or all methods of a given class) should be invoked asynchronously.
- 参数:
asyncAnnotationType
- the desired annotation type
setBeanFactory
public void setBeanFactory(BeanFactory beanFactory)
从接口复制的说明:BeanFactoryAware
Callback that supplies the owning factory to a bean instance.Invoked after the population of normal bean properties but before an initialization callback such as
InitializingBean.afterPropertiesSet()
or a custom init-method.- 指定者:
setBeanFactory
在接口中BeanFactoryAware
- 覆盖:
setBeanFactory
在类中AbstractBeanFactoryAwareAdvisingPostProcessor
- 参数:
beanFactory
- owning BeanFactory (nevernull
). The bean can immediately call methods on the factory.- 另请参阅:
BeanInitializationException