org.hawaiiframework.async

Class AsyncExecutorConfiguration

java.lang.Object

org.hawaiiframework.async.AsyncExecutorConfiguration

All Implemented Interfaces:

Aware, BeanFactoryPostProcessor, BeanDefinitionRegistryPostProcessor, EnvironmentAware, AsyncConfigurer

@Configuration
 @EnableAsync
public class AsyncExecutorConfiguration
extends Object
implements BeanDefinitionRegistryPostProcessor, AsyncConfigurer, EnvironmentAware

Configuration class to set up asynchronous executors.

The loaded configuration properties are themselves registered as a bean, so they may be in other classes needing them, see EXECUTOR_CONFIGURATION_PROPERTIES.

For each configured task a bean DelegatingExecutor with the name {system_name}.{task_name} is created. The task's configured executor is set in the DelegatingExecutor as it's delegate.

A method annotated with Async can specify its full task name, i.e. {system_name}.{task_name} as the annotation value. The corresponding delegating executor bean will be retrieved by this name.

NOTE: each async task MUST be specified in the configuration, otherwise an exception will be raised.

Since:

2.0.0

Author:

Rutger Lubbers, Paul Klos

Constructor Summary

Constructors

Constructor and Description
AsyncExecutorConfiguration()

Method Summary

Modifier and Type	Method and Description
Executor	getAsyncExecutor()
AsyncUncaughtExceptionHandler	getAsyncUncaughtExceptionHandler()
void	postProcessBeanDefinitionRegistry(BeanDefinitionRegistry registry)
void	postProcessBeanFactory(ConfigurableListableBeanFactory beanFactory)
void	setEnvironment(Environment environment)

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

AsyncExecutorConfiguration

public AsyncExecutorConfiguration()

Method Detail

postProcessBeanDefinitionRegistry

public void postProcessBeanDefinitionRegistry(BeanDefinitionRegistry registry)
                                       throws BeansException

Specified by:

postProcessBeanDefinitionRegistry in interface BeanDefinitionRegistryPostProcessor

Throws:

BeansException

postProcessBeanFactory

public void postProcessBeanFactory(ConfigurableListableBeanFactory beanFactory)
                            throws BeansException

Configured method names are aliased to their corresponding executor, such that bean lookup works.

Specified by:

postProcessBeanFactory in interface BeanFactoryPostProcessor

Throws:

BeansException

getAsyncExecutor

public Executor getAsyncExecutor()

Specified by:

getAsyncExecutor in interface AsyncConfigurer

Returns:

the default executor, as determined from isDefaultExecutor(ExecutorProperties)

getAsyncUncaughtExceptionHandler

public AsyncUncaughtExceptionHandler getAsyncUncaughtExceptionHandler()

Specified by:

getAsyncUncaughtExceptionHandler in interface AsyncConfigurer

Returns:

null, i.e. use the Spring default

setEnvironment

public void setEnvironment(Environment environment)

Use the environment to obtain the location of the configuration file.

Specified by:

setEnvironment in interface EnvironmentAware