Class ThreadPoolExecutorFactoryBean
- All Implemented Interfaces:
Serializable
,ThreadFactory
,org.springframework.beans.factory.Aware
,org.springframework.beans.factory.BeanNameAware
,org.springframework.beans.factory.DisposableBean
,org.springframework.beans.factory.FactoryBean<ExecutorService>
,org.springframework.beans.factory.InitializingBean
ThreadPoolExecutor
in bean style (through its "corePoolSize", "maxPoolSize", "keepAliveSeconds",
"queueCapacity" properties) and exposing it as a bean reference of its native
ExecutorService
type.
The default configuration is a core pool size of 1, with unlimited max pool size
and unlimited queue capacity. This is roughly equivalent to
Executors.newSingleThreadExecutor()
, sharing a single
thread for all tasks. Setting "queueCapacity"
to 0 mimics
Executors.newCachedThreadPool()
, with immediate scaling
of threads in the pool to a potentially very high number. Consider also setting a
"maxPoolSize"
at that point, as well as possibly a higher
"corePoolSize"
(see also the
"allowCoreThreadTimeOut"
mode of scaling).
For an alternative, you may set up a ThreadPoolExecutor
instance directly
using constructor injection, or use a factory method definition that points to the
Executors
class.
This is strongly recommended in particular for common @Bean
methods in
configuration classes, where this FactoryBean
variant would force you to
return the FactoryBean
type instead of the actual Executor
type.
If you need a timing-based ScheduledExecutorService
instead, consider ScheduledExecutorFactoryBean
.
- Since:
- 3.0
- Author:
- Juergen Hoeller
- See Also:
-
Field Summary
Fields inherited from class org.springframework.scheduling.concurrent.ExecutorConfigurationSupport
logger
Fields inherited from interface org.springframework.beans.factory.FactoryBean
OBJECT_TYPE_ATTRIBUTE
-
Constructor Summary
-
Method Summary
Modifier and TypeMethodDescriptionprotected ThreadPoolExecutor
createExecutor
(int corePoolSize, int maxPoolSize, int keepAliveSeconds, BlockingQueue<Runnable> queue, ThreadFactory threadFactory, RejectedExecutionHandler rejectedExecutionHandler) Create a new instance ofThreadPoolExecutor
or a subclass thereof.protected BlockingQueue<Runnable>
createQueue
(int queueCapacity) Create the BlockingQueue to use for the ThreadPoolExecutor.Class<? extends ExecutorService>
protected ExecutorService
initializeExecutor
(ThreadFactory threadFactory, RejectedExecutionHandler rejectedExecutionHandler) Create the targetExecutorService
instance.boolean
void
setAllowCoreThreadTimeOut
(boolean allowCoreThreadTimeOut) Specify whether to allow core threads to time out.void
setCorePoolSize
(int corePoolSize) Set the ThreadPoolExecutor's core pool size.void
setExposeUnconfigurableExecutor
(boolean exposeUnconfigurableExecutor) Specify whether this FactoryBean should expose an unconfigurable decorator for the created executor.void
setKeepAliveSeconds
(int keepAliveSeconds) Set the ThreadPoolExecutor's keep-alive seconds.void
setMaxPoolSize
(int maxPoolSize) Set the ThreadPoolExecutor's maximum pool size.void
setPrestartAllCoreThreads
(boolean prestartAllCoreThreads) Specify whether to start all core threads, causing them to idly wait for work.void
setQueueCapacity
(int queueCapacity) Set the capacity for the ThreadPoolExecutor's BlockingQueue.Methods inherited from class org.springframework.scheduling.concurrent.ExecutorConfigurationSupport
afterPropertiesSet, cancelRemainingTask, destroy, initialize, setAwaitTerminationMillis, setAwaitTerminationSeconds, setBeanName, setRejectedExecutionHandler, setThreadFactory, setThreadNamePrefix, setWaitForTasksToCompleteOnShutdown, shutdown
Methods inherited from class org.springframework.scheduling.concurrent.CustomizableThreadFactory
newThread
Methods inherited from class org.springframework.util.CustomizableThreadCreator
createThread, getDefaultThreadNamePrefix, getThreadGroup, getThreadNamePrefix, getThreadPriority, isDaemon, nextThreadName, setDaemon, setThreadGroup, setThreadGroupName, setThreadPriority
-
Constructor Details
-
ThreadPoolExecutorFactoryBean
public ThreadPoolExecutorFactoryBean()
-
-
Method Details
-
setCorePoolSize
public void setCorePoolSize(int corePoolSize) Set the ThreadPoolExecutor's core pool size. Default is 1. -
setMaxPoolSize
public void setMaxPoolSize(int maxPoolSize) Set the ThreadPoolExecutor's maximum pool size. Default isInteger.MAX_VALUE
. -
setKeepAliveSeconds
public void setKeepAliveSeconds(int keepAliveSeconds) Set the ThreadPoolExecutor's keep-alive seconds. Default is 60. -
setAllowCoreThreadTimeOut
public void setAllowCoreThreadTimeOut(boolean allowCoreThreadTimeOut) Specify whether to allow core threads to time out. This enables dynamic growing and shrinking even in combination with a non-zero queue (since the max pool size will only grow once the queue is full).Default is "false".
-
setPrestartAllCoreThreads
public void setPrestartAllCoreThreads(boolean prestartAllCoreThreads) Specify whether to start all core threads, causing them to idly wait for work.Default is "false".
- Since:
- 5.3.14
- See Also:
-
setQueueCapacity
public void setQueueCapacity(int queueCapacity) Set the capacity for the ThreadPoolExecutor's BlockingQueue. Default isInteger.MAX_VALUE
.Any positive value will lead to a LinkedBlockingQueue instance; any other value will lead to a SynchronousQueue instance.
- See Also:
-
setExposeUnconfigurableExecutor
public void setExposeUnconfigurableExecutor(boolean exposeUnconfigurableExecutor) Specify whether this FactoryBean should expose an unconfigurable decorator for the created executor.Default is "false", exposing the raw executor as bean reference. Switch this flag to "true" to strictly prevent clients from modifying the executor's configuration.
-
initializeExecutor
protected ExecutorService initializeExecutor(ThreadFactory threadFactory, RejectedExecutionHandler rejectedExecutionHandler) Description copied from class:ExecutorConfigurationSupport
Create the targetExecutorService
instance. Called byafterPropertiesSet
.- Specified by:
initializeExecutor
in classExecutorConfigurationSupport
- Parameters:
threadFactory
- the ThreadFactory to userejectedExecutionHandler
- the RejectedExecutionHandler to use- Returns:
- a new ExecutorService instance
- See Also:
-
createExecutor
protected ThreadPoolExecutor createExecutor(int corePoolSize, int maxPoolSize, int keepAliveSeconds, BlockingQueue<Runnable> queue, ThreadFactory threadFactory, RejectedExecutionHandler rejectedExecutionHandler) Create a new instance ofThreadPoolExecutor
or a subclass thereof.The default implementation creates a standard
ThreadPoolExecutor
. Can be overridden to provide customThreadPoolExecutor
subclasses.- Parameters:
corePoolSize
- the specified core pool sizemaxPoolSize
- the specified maximum pool sizekeepAliveSeconds
- the specified keep-alive time in secondsqueue
- the BlockingQueue to usethreadFactory
- the ThreadFactory to userejectedExecutionHandler
- the RejectedExecutionHandler to use- Returns:
- a new ThreadPoolExecutor instance
- See Also:
-
createQueue
Create the BlockingQueue to use for the ThreadPoolExecutor.A LinkedBlockingQueue instance will be created for a positive capacity value; a SynchronousQueue else.
- Parameters:
queueCapacity
- the specified queue capacity- Returns:
- the BlockingQueue instance
- See Also:
-
getObject
- Specified by:
getObject
in interfaceorg.springframework.beans.factory.FactoryBean<ExecutorService>
-
getObjectType
- Specified by:
getObjectType
in interfaceorg.springframework.beans.factory.FactoryBean<ExecutorService>
-
isSingleton
public boolean isSingleton()- Specified by:
isSingleton
in interfaceorg.springframework.beans.factory.FactoryBean<ExecutorService>
-