org.springframework.scheduling.concurrent

Class ConcurrentTaskExecutor

java.lang.Object

org.springframework.scheduling.concurrent.ConcurrentTaskExecutor

All Implemented Interfaces:

Executor, org.springframework.core.task.AsyncTaskExecutor, org.springframework.core.task.TaskExecutor, SchedulingTaskExecutor

Direct Known Subclasses:

ConcurrentTaskScheduler

public class ConcurrentTaskExecutor
extends Object
implements SchedulingTaskExecutor

Adapter that takes a JDK 1.5 java.util.concurrent.Executor and exposes a Spring TaskExecutor for it. Also detects an extended java.util.concurrent.ExecutorService, adapting the AsyncTaskExecutor interface accordingly.

Note that there is a pre-built ThreadPoolTaskExecutor that allows for defining a JDK 1.5 ThreadPoolExecutor in bean style, exposing it as a Spring TaskExecutor directly. This is a convenient alternative to a raw ThreadPoolExecutor definition with a separate definition of the present adapter class.

Since:

2.0

Author:

Juergen Hoeller

See Also:

Executor, ExecutorService, ThreadPoolExecutor, Executors, ThreadPoolTaskExecutor

Field Summary

Fields inherited from interface org.springframework.core.task.AsyncTaskExecutor

TIMEOUT_IMMEDIATE, TIMEOUT_INDEFINITE

Constructor Summary

Constructors

Constructor and Description
ConcurrentTaskExecutor() Create a new ConcurrentTaskExecutor, using a single thread executor as default.
ConcurrentTaskExecutor(Executor concurrentExecutor) Create a new ConcurrentTaskExecutor, using the given JDK 1.5 concurrent executor.

Method Summary

Methods

Modifier and Type	Method and Description
void	execute(Runnable task)
void	execute(Runnable task, long startTimeout)
Executor	getConcurrentExecutor() Return the JDK 1.5 concurrent executor that this adapter delegates to.
boolean	prefersShortLivedTasks() This task executor prefers short-lived work units.
void	setConcurrentExecutor(Executor concurrentExecutor) Specify the JDK 1.5 concurrent executor to delegate to.
<T> Future<T>	submit(Callable<T> task)
Future<?>	submit(Runnable task)

Methods inherited from class java.lang.Object

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

Constructor Detail

ConcurrentTaskExecutor

public ConcurrentTaskExecutor()

Create a new ConcurrentTaskExecutor, using a single thread executor as default.

See Also:

Executors.newSingleThreadExecutor()

ConcurrentTaskExecutor

public ConcurrentTaskExecutor(Executor concurrentExecutor)

Create a new ConcurrentTaskExecutor, using the given JDK 1.5 concurrent executor.

Parameters:

concurrentExecutor - the JDK 1.5 concurrent executor to delegate to

Method Detail

setConcurrentExecutor

public final void setConcurrentExecutor(Executor concurrentExecutor)

Specify the JDK 1.5 concurrent executor to delegate to.

getConcurrentExecutor

public final Executor getConcurrentExecutor()

Return the JDK 1.5 concurrent executor that this adapter delegates to.

execute

public void execute(Runnable task)

Specified by:

execute in interface Executor

Specified by:

execute in interface org.springframework.core.task.TaskExecutor

execute

public void execute(Runnable task,
           long startTimeout)

Specified by:

execute in interface org.springframework.core.task.AsyncTaskExecutor

submit

public Future<?> submit(Runnable task)

Specified by:

submit in interface org.springframework.core.task.AsyncTaskExecutor

submit

public <T> Future<T> submit(Callable<T> task)

Specified by:

submit in interface org.springframework.core.task.AsyncTaskExecutor

prefersShortLivedTasks

public boolean prefersShortLivedTasks()

This task executor prefers short-lived work units.

Specified by:

prefersShortLivedTasks in interface SchedulingTaskExecutor

Returns:

true if this TaskExecutor prefers short-lived tasks