Spring Framework 6.1.4 · org.springframework.core.task.support.TaskExecutorAdapter

Modifier and Type	Field and Description
private final Executor	concurrentExecutor
private TaskDecorator	taskDecorator

Access	Constructor and Description
public	TaskExecutorAdapter(Executor the JDK concurrent executor to delegate to concurrentExecutor) Create a new TaskExecutorAdapter, using the given JDK concurrent executor.

Method Summary

Modifier and Type	Method and Description
protected void	doExecute(Executor the underlying JDK concurrent executor to delegate to concurrentExecutor, TaskDecorator the specified decorator to be applied, if any taskDecorator, Runnable the runnable to execute runnable) Actually execute the given `Runnable` (which may be a user-supplied task or a wrapper around a user-supplied task) with the given executor.
public void	execute(Runnable the `Runnable` to execute (never `null`) task) Implements org.springframework.core.task.TaskExecutor.execute. Delegates to the specified JDK concurrent executor.
public final void	setTaskDecorator(TaskDecorator taskDecorator) Specify a custom `TaskDecorator` to be applied to any `Runnable` about to be executed.
public Future<?>	submit(Runnable the `Runnable` to execute (never `null`) task) Overrides default org.springframework.core.task.AsyncTaskExecutor.submit. Submit a Runnable task for execution, receiving a Future representing that task.
public <T> Future<T>	submit(Callable<T> the `Callable` to execute (never `null`) task) Overrides default org.springframework.core.task.AsyncTaskExecutor.submit. Submit a Callable task for execution, receiving a Future representing that task.
public ListenableFuture<?>	submitListenable(Runnable the `Runnable` to execute (never `null`) task) Implements org.springframework.core.task.AsyncListenableTaskExecutor.submitListenable. References Deprecated `ListenableFuture` is deprecated or references (maybe indirectly) at least one deprecated element. Submit a `Runnable` task for execution, receiving a `ListenableFuture` representing that task.
public <T> ListenableFuture<T>	submitListenable(Callable<T> the `Callable` to execute (never `null`) task) Implements org.springframework.core.task.AsyncListenableTaskExecutor.submitListenable. References Deprecated `ListenableFuture` is deprecated or references (maybe indirectly) at least one deprecated element. Submit a `Callable` task for execution, receiving a `ListenableFuture` representing that task.

Inherited from java.lang.Object:: clone equals finalize getClass hashCode notify notifyAll toString wait wait wait

concurrentExecutor	back to summary
private final Executor concurrentExecutor

taskDecorator	back to summary
private TaskDecorator taskDecorator Annotations @Nullable

TaskExecutorAdapter	back to summary
public TaskExecutorAdapter(Executor concurrentExecutor) Create a new TaskExecutorAdapter, using the given JDK concurrent executor. Parameters concurrentExecutor:Executor the JDK concurrent executor to delegate to

Method Detail

doExecute back to summary

doExecute	back to summary
protected void doExecute(Executor concurrentExecutor, TaskDecorator taskDecorator, Runnable runnable) throws RejectedExecutionException Actually execute the given `Runnable` (which may be a user-supplied task or a wrapper around a user-supplied task) with the given executor. Parameters concurrentExecutor:Executor the underlying JDK concurrent executor to delegate to taskDecorator:TaskDecorator the specified decorator to be applied, if any runnable:Runnable the runnable to execute Exceptions RejectedExecutionException: if the given runnable cannot be accepted Since 4.3

protected void doExecute(Executor concurrentExecutor, TaskDecorator taskDecorator, Runnable runnable) throws RejectedExecutionException

Actually execute the given Runnable (which may be a user-supplied task or a wrapper around a user-supplied task) with the given executor.

Parameters

concurrentExecutor:Executor: the underlying JDK concurrent executor to delegate to
taskDecorator:TaskDecorator: the specified decorator to be applied, if any
runnable:Runnable: the runnable to execute

Exceptions

RejectedExecutionException:: if the given runnable cannot be accepted

Since

4.3

execute back to summary

execute	back to summary
public void execute(Runnable task) Implements org.springframework.core.task.TaskExecutor.execute. Delegates to the specified JDK concurrent executor. Parameters task:Runnable Doc from org.springframework.core.task.TaskExecutor.execute. the `Runnable` to execute (never `null`) Annotations @Override See Also `java.util.concurrent.Executor#execute(Runnable)`

public void execute(Runnable task)

Implements org.springframework.core.task.TaskExecutor.execute.

Delegates to the specified JDK concurrent executor.

Parameters

task:Runnable

Doc from org.springframework.core.task.TaskExecutor.execute.

the Runnable to execute (never null)

Annotations

@Override

setTaskDecorator back to summary

setTaskDecorator	back to summary
public final void setTaskDecorator(TaskDecorator taskDecorator) Specify a custom `TaskDecorator` to be applied to any `Runnable` about to be executed. Note that such a decorator is not necessarily being applied to the user-supplied `Runnable`/`Callable` but rather to the actual execution callback (which may be a wrapper around the user-supplied task). The primary use case is to set some execution context around the task's invocation, or to provide some monitoring/statistics for task execution. Note Exception handling in `TaskDecorator` implementations is limited to plain `Runnable` execution via `execute` calls. In case of `#submit` calls, the exposed `Runnable` will be a `FutureTask` which does not propagate any exceptions; you might have to cast it and call `Future#get` to evaluate exceptions. Since 4.3

public final void setTaskDecorator(TaskDecorator taskDecorator)

Specify a custom TaskDecorator to be applied to any Runnable about to be executed.

Note that such a decorator is not necessarily being applied to the user-supplied Runnable/Callable but rather to the actual execution callback (which may be a wrapper around the user-supplied task).

The primary use case is to set some execution context around the task's invocation, or to provide some monitoring/statistics for task execution.

Note

Exception handling in TaskDecorator implementations is limited to plain Runnable execution via execute calls. In case of #submit calls, the exposed Runnable will be a FutureTask which does not propagate any exceptions; you might have to cast it and call Future#get to evaluate exceptions.

Since: 4.3

submit back to summary

submit	back to summary
public Future<?> submit(Runnable task) Overrides default org.springframework.core.task.AsyncTaskExecutor.submit. Doc from org.springframework.core.task.AsyncTaskExecutor.submit. Submit a Runnable task for execution, receiving a Future representing that task. The Future will return a `null` result upon completion. As of 6.1, this method comes with a default implementation that delegates to `execute(Runnable)`. Parameters task:Runnable the `Runnable` to execute (never `null`) Returns:Future<?> a Future representing pending completion of the task Annotations @Override

public Future<?> submit(Runnable task)

Overrides default org.springframework.core.task.AsyncTaskExecutor.submit.

Doc from org.springframework.core.task.AsyncTaskExecutor.submit.

Submit a Runnable task for execution, receiving a Future representing that task. The Future will return a null result upon completion.

As of 6.1, this method comes with a default implementation that delegates to execute(Runnable).

Parameters

task:Runnable: the Runnable to execute (never null)

Returns:Future<?>

a Future representing pending completion of the task

Annotations

@Override

submit back to summary

submit	back to summary
public <T> Future<T> submit(Callable<T> task) Overrides default org.springframework.core.task.AsyncTaskExecutor.submit. Doc from org.springframework.core.task.AsyncTaskExecutor.submit. Submit a Callable task for execution, receiving a Future representing that task. The Future will return the Callable's result upon completion. As of 6.1, this method comes with a default implementation that delegates to `execute(Runnable)`. Parameters task:Callable<T> the `Callable` to execute (never `null`) Returns:Future<T> a Future representing pending completion of the task Annotations @Override

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

Overrides default org.springframework.core.task.AsyncTaskExecutor.submit.

Doc from org.springframework.core.task.AsyncTaskExecutor.submit.

Submit a Callable task for execution, receiving a Future representing that task. The Future will return the Callable's result upon completion.

As of 6.1, this method comes with a default implementation that delegates to execute(Runnable).

Parameters

task:Callable<T>: the Callable to execute (never null)

Returns:Future<T>

a Future representing pending completion of the task

Annotations

@Override

submitListenable back to summary

submitListenable	back to summary
public ListenableFuture<?> submitListenable(Runnable task) Implements org.springframework.core.task.AsyncListenableTaskExecutor.submitListenable. Doc from org.springframework.core.task.AsyncListenableTaskExecutor.submitListenable. References Deprecated `ListenableFuture` is deprecated or references (maybe indirectly) at least one deprecated element. See corresponding docs for further information. Submit a `Runnable` task for execution, receiving a `ListenableFuture` representing that task. The Future will return a `null` result upon completion. Parameters task:Runnable the `Runnable` to execute (never `null`) Returns:ListenableFuture<?> a `ListenableFuture` representing pending completion of the task Annotations @Override

public ListenableFuture<?> submitListenable(Runnable task)

Implements org.springframework.core.task.AsyncListenableTaskExecutor.submitListenable.

Doc from org.springframework.core.task.AsyncListenableTaskExecutor.submitListenable.

References Deprecated

ListenableFuture is deprecated or references (maybe indirectly) at least one deprecated element.

See corresponding docs for further information.

Submit a Runnable task for execution, receiving a ListenableFuture representing that task. The Future will return a null result upon completion.

Parameters

task:Runnable: the Runnable to execute (never null)

Returns:ListenableFuture<?>

a ListenableFuture representing pending completion of the task

Annotations

@Override

submitListenable back to summary

submitListenable	back to summary
public <T> ListenableFuture<T> submitListenable(Callable<T> task) Implements org.springframework.core.task.AsyncListenableTaskExecutor.submitListenable. Doc from org.springframework.core.task.AsyncListenableTaskExecutor.submitListenable. References Deprecated `ListenableFuture` is deprecated or references (maybe indirectly) at least one deprecated element. See corresponding docs for further information. Submit a `Callable` task for execution, receiving a `ListenableFuture` representing that task. The Future will return the Callable's result upon completion. Parameters task:Callable<T> the `Callable` to execute (never `null`) Returns:ListenableFuture<T> a `ListenableFuture` representing pending completion of the task Annotations @Override

public <T> ListenableFuture<T> submitListenable(Callable<T> task)

Implements org.springframework.core.task.AsyncListenableTaskExecutor.submitListenable.

Doc from org.springframework.core.task.AsyncListenableTaskExecutor.submitListenable.

References Deprecated

ListenableFuture is deprecated or references (maybe indirectly) at least one deprecated element.

See corresponding docs for further information.

Submit a Callable task for execution, receiving a ListenableFuture representing that task. The Future will return the Callable's result upon completion.

Parameters

task:Callable<T>: the Callable to execute (never null)

Returns:ListenableFuture<T>

a ListenableFuture representing pending completion of the task

Annotations

@Override

public Class TaskExecutorAdapter

Field Summary

Constructor Summary

Method Summary

Field Detail

Constructor Detail

Method Detail