@Deprecated public class ThreadPoolTaskExecutor extends CustomizableThreadFactory implements SchedulingTaskExecutor, edu.emory.mathcs.backport.java.util.concurrent.Executor, org.springframework.beans.factory.BeanNameAware, org.springframework.beans.factory.InitializingBean, org.springframework.beans.factory.DisposableBean
ThreadPoolExecutor
in bean
style (through its "corePoolSize", "maxPoolSize", "keepAliveSeconds", "queueCapacity"
properties), exposing it as a Spring TaskExecutor
.
This is an alternative to configuring a ThreadPoolExecutor instance directly using
constructor injection, with a separate ConcurrentTaskExecutor
adapter wrapping it.
For any custom needs, in particular for defining a
ScheduledThreadPoolExecutor
,
it is recommended to use a straight definition of the Executor instance or a
factory method definition that points to the JSR-166 backport
Executors
class.
To expose such a raw Executor as a Spring TaskExecutor
,
simply wrap it with a ConcurrentTaskExecutor
adapter.
NOTE: This class implements Spring's
TaskExecutor
interface (and hence implicitly
the standard Java 5 Executor
interface) as well as
the JSR-166 Executor
interface, with the former being the primary interface, the other just
serving as secondary convenience. For this reason, the exception handling
follows the TaskExecutor contract rather than the backport Executor contract, in
particular regarding the TaskRejectedException
.
TaskExecutor
,
Executor
,
ThreadPoolExecutor
,
ScheduledThreadPoolExecutor
,
Executors
,
ConcurrentTaskExecutor
,
Serialized FormConstructor and Description |
---|
ThreadPoolTaskExecutor()
Deprecated.
|
Modifier and Type | Method and Description |
---|---|
void |
afterPropertiesSet()
Deprecated.
Calls
initialize() after the container applied all property values. |
protected edu.emory.mathcs.backport.java.util.concurrent.BlockingQueue |
createQueue(int queueCapacity)
Deprecated.
Create the BlockingQueue to use for the ThreadPoolExecutor.
|
void |
destroy()
Deprecated.
Calls
shutdown when the BeanFactory destroys
the task executor instance. |
void |
execute(Runnable task)
Deprecated.
Implementation of both the JSR-166 backport Executor interface and the Spring
TaskExecutor interface, delegating to the ThreadPoolExecutor instance.
|
void |
execute(Runnable task,
long startTimeout)
Deprecated.
|
int |
getActiveCount()
Deprecated.
Return the number of currently active threads.
|
int |
getCorePoolSize()
Deprecated.
Return the ThreadPoolExecutor's core pool size.
|
int |
getKeepAliveSeconds()
Deprecated.
Return the ThreadPoolExecutor's keep-alive seconds.
|
int |
getMaxPoolSize()
Deprecated.
Return the ThreadPoolExecutor's maximum pool size.
|
int |
getPoolSize()
Deprecated.
Return the current pool size.
|
edu.emory.mathcs.backport.java.util.concurrent.ThreadPoolExecutor |
getThreadPoolExecutor()
Deprecated.
Return the underlying ThreadPoolExecutor for native access.
|
void |
initialize()
Deprecated.
Creates the BlockingQueue and the ThreadPoolExecutor.
|
boolean |
prefersShortLivedTasks()
Deprecated.
This task executor prefers short-lived work units.
|
void |
setAllowCoreThreadTimeOut(boolean allowCoreThreadTimeOut)
Deprecated.
Specify whether to allow core threads to time out.
|
void |
setBeanName(String name)
Deprecated.
|
void |
setCorePoolSize(int corePoolSize)
Deprecated.
Set the ThreadPoolExecutor's core pool size.
|
void |
setKeepAliveSeconds(int keepAliveSeconds)
Deprecated.
Set the ThreadPoolExecutor's keep-alive seconds.
|
void |
setMaxPoolSize(int maxPoolSize)
Deprecated.
Set the ThreadPoolExecutor's maximum pool size.
|
void |
setQueueCapacity(int queueCapacity)
Deprecated.
Set the capacity for the ThreadPoolExecutor's BlockingQueue.
|
void |
setRejectedExecutionHandler(edu.emory.mathcs.backport.java.util.concurrent.RejectedExecutionHandler rejectedExecutionHandler)
Deprecated.
Set the RejectedExecutionHandler to use for the ThreadPoolExecutor.
|
void |
setThreadFactory(edu.emory.mathcs.backport.java.util.concurrent.ThreadFactory threadFactory)
Deprecated.
Set the ThreadFactory to use for the ThreadPoolExecutor's thread pool.
|
void |
setThreadNamePrefix(String threadNamePrefix)
Deprecated.
|
void |
setWaitForTasksToCompleteOnShutdown(boolean waitForJobsToCompleteOnShutdown)
Deprecated.
Set whether to wait for scheduled tasks to complete on shutdown.
|
void |
shutdown()
Deprecated.
Perform a shutdown on the ThreadPoolExecutor.
|
<T> Future<T> |
submit(Callable<T> task)
Deprecated.
|
Future<?> |
submit(Runnable task)
Deprecated.
|
newThread
protected final Log logger
public void setCorePoolSize(int corePoolSize)
This setting can be modified at runtime, for example through JMX.
public int getCorePoolSize()
public void setMaxPoolSize(int maxPoolSize)
Integer.MAX_VALUE
.
This setting can be modified at runtime, for example through JMX.
public int getMaxPoolSize()
public void setKeepAliveSeconds(int keepAliveSeconds)
This setting can be modified at runtime, for example through JMX.
public int getKeepAliveSeconds()
public void setAllowCoreThreadTimeOut(boolean allowCoreThreadTimeOut)
Default is "false". Note that this feature is only available on backport-concurrent 3.0 or above (based on the code in Java 6).
ThreadPoolExecutor.allowCoreThreadTimeOut(boolean)
public void setQueueCapacity(int queueCapacity)
Integer.MAX_VALUE
.
Any positive value will lead to a LinkedBlockingQueue instance; any other value will lead to a SynchronousQueue instance.
LinkedBlockingQueue
,
SynchronousQueue
public void setThreadFactory(edu.emory.mathcs.backport.java.util.concurrent.ThreadFactory threadFactory)
Default is this executor itself (i.e. the factory that this executor
inherits from). See CustomizableThreadCreator
's
javadoc for available bean properties.
CustomizableThreadCreator.setThreadPriority(int)
,
CustomizableThreadCreator.setDaemon(boolean)
public void setRejectedExecutionHandler(edu.emory.mathcs.backport.java.util.concurrent.RejectedExecutionHandler rejectedExecutionHandler)
ThreadPoolExecutor.AbortPolicy
public void setWaitForTasksToCompleteOnShutdown(boolean waitForJobsToCompleteOnShutdown)
Default is "false". Switch this to "true" if you prefer fully completed tasks at the expense of a longer shutdown phase.
ThreadPoolExecutor.shutdown()
,
ThreadPoolExecutor.shutdownNow()
public void setThreadNamePrefix(String threadNamePrefix)
setThreadNamePrefix
in class org.springframework.util.CustomizableThreadCreator
public void setBeanName(String name)
setBeanName
in interface org.springframework.beans.factory.BeanNameAware
public void afterPropertiesSet()
initialize()
after the container applied all property values.afterPropertiesSet
in interface org.springframework.beans.factory.InitializingBean
initialize()
public void initialize()
createQueue(int)
protected edu.emory.mathcs.backport.java.util.concurrent.BlockingQueue createQueue(int queueCapacity)
A LinkedBlockingQueue instance will be created for a positive capacity value; a SynchronousQueue else.
queueCapacity
- the specified queue capacityLinkedBlockingQueue
,
SynchronousQueue
public edu.emory.mathcs.backport.java.util.concurrent.ThreadPoolExecutor getThreadPoolExecutor() throws IllegalStateException
null
)IllegalStateException
- if the ThreadPoolTaskExecutor hasn't been initialized yetpublic void execute(Runnable task)
execute
in interface edu.emory.mathcs.backport.java.util.concurrent.Executor
execute
in interface org.springframework.core.task.TaskExecutor
Executor.execute(Runnable)
,
TaskExecutor.execute(Runnable)
public void execute(Runnable task, long startTimeout)
execute
in interface org.springframework.core.task.AsyncTaskExecutor
public Future<?> submit(Runnable task)
submit
in interface org.springframework.core.task.AsyncTaskExecutor
public <T> Future<T> submit(Callable<T> task)
submit
in interface org.springframework.core.task.AsyncTaskExecutor
public boolean prefersShortLivedTasks()
prefersShortLivedTasks
in interface SchedulingTaskExecutor
true
if this TaskExecutor
prefers
short-lived taskspublic int getPoolSize()
ThreadPoolExecutor.getPoolSize()
public int getActiveCount()
ThreadPoolExecutor.getActiveCount()
public void destroy()
shutdown
when the BeanFactory destroys
the task executor instance.destroy
in interface org.springframework.beans.factory.DisposableBean
shutdown()
public void shutdown()
ThreadPoolExecutor.shutdown()