org.springframework.boot.task

Class TaskSchedulerBuilder

java.lang.Object

org.springframework.boot.task.TaskSchedulerBuilder

public class TaskSchedulerBuilder
extends Object

Builder that can be used to configure and create a TaskScheduler. Provides convenience methods to set common ThreadPoolTaskScheduler settings. For advanced configuration, consider using TaskSchedulerCustomizer.

In a typical auto-configured Spring Boot application this builder is available as a bean and can be injected whenever a TaskScheduler is needed.

Since:

2.1.0

Author:

Stephane Nicoll

Constructor Summary

Constructors

Constructor and Description
TaskSchedulerBuilder()
TaskSchedulerBuilder(Integer poolSize, Boolean awaitTermination, Duration awaitTerminationPeriod, String threadNamePrefix, Set<TaskSchedulerCustomizer> taskSchedulerCustomizers)

Method Summary

Modifier and Type	Method and Description
TaskSchedulerBuilder	additionalCustomizers(Iterable<TaskSchedulerCustomizer> customizers) Add taskSchedulerCustomizers that should be applied to the ThreadPoolTaskScheduler.
TaskSchedulerBuilder	additionalCustomizers(TaskSchedulerCustomizer... customizers) Add taskSchedulerCustomizers that should be applied to the ThreadPoolTaskScheduler.
TaskSchedulerBuilder	awaitTermination(boolean awaitTermination) Set whether the executor should wait for scheduled tasks to complete on shutdown, not interrupting running tasks and executing all tasks in the queue.
TaskSchedulerBuilder	awaitTerminationPeriod(Duration awaitTerminationPeriod) Set the maximum time the executor is supposed to block on shutdown.
ThreadPoolTaskScheduler	build() Build a new ThreadPoolTaskScheduler instance and configure it using this builder.
<T extends ThreadPoolTaskScheduler> T	configure(T taskScheduler) Configure the provided ThreadPoolTaskScheduler instance using this builder.
TaskSchedulerBuilder	customizers(Iterable<TaskSchedulerCustomizer> customizers) Set the taskSchedulerCustomizers that should be applied to the ThreadPoolTaskScheduler.
TaskSchedulerBuilder	customizers(TaskSchedulerCustomizer... customizers) Set the TaskSchedulerCustomizers that should be applied to the ThreadPoolTaskScheduler.
TaskSchedulerBuilder	poolSize(int poolSize) Set the maximum allowed number of threads.
TaskSchedulerBuilder	threadNamePrefix(String threadNamePrefix) Set the prefix to use for the names of newly created threads.

Methods inherited from class java.lang.Object

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

Constructor Detail

TaskSchedulerBuilder

public TaskSchedulerBuilder()

TaskSchedulerBuilder

public TaskSchedulerBuilder(Integer poolSize,
                            Boolean awaitTermination,
                            Duration awaitTerminationPeriod,
                            String threadNamePrefix,
                            Set<TaskSchedulerCustomizer> taskSchedulerCustomizers)

Method Detail

poolSize

public TaskSchedulerBuilder poolSize(int poolSize)

Set the maximum allowed number of threads.

Parameters:

poolSize - the pool size to set

Returns:

a new builder instance

awaitTermination

public TaskSchedulerBuilder awaitTermination(boolean awaitTermination)

Set whether the executor should wait for scheduled tasks to complete on shutdown, not interrupting running tasks and executing all tasks in the queue.

Parameters:

awaitTermination - whether the executor needs to wait for the tasks to complete on shutdown

Returns:

a new builder instance

See Also:

awaitTerminationPeriod(Duration)

awaitTerminationPeriod

public TaskSchedulerBuilder awaitTerminationPeriod(Duration awaitTerminationPeriod)

Set the maximum time the executor is supposed to block on shutdown. When set, the executor blocks on shutdown in order to wait for remaining tasks to complete their execution before the rest of the container continues to shut down. This is particularly useful if your remaining tasks are likely to need access to other resources that are also managed by the container.

Parameters:

awaitTerminationPeriod - the await termination period to set

Returns:

a new builder instance

threadNamePrefix

public TaskSchedulerBuilder threadNamePrefix(String threadNamePrefix)

Set the prefix to use for the names of newly created threads.

Parameters:

threadNamePrefix - the thread name prefix to set

Returns:

a new builder instance

customizers

public TaskSchedulerBuilder customizers(TaskSchedulerCustomizer... customizers)

Set the TaskSchedulerCustomizers that should be applied to the ThreadPoolTaskScheduler. Customizers are applied in the order that they were added after builder configuration has been applied. Setting this value will replace any previously configured customizers.

Parameters:

customizers - the customizers to set

Returns:

a new builder instance

See Also:

additionalCustomizers(TaskSchedulerCustomizer...)

customizers

public TaskSchedulerBuilder customizers(Iterable<TaskSchedulerCustomizer> customizers)

Set the taskSchedulerCustomizers that should be applied to the ThreadPoolTaskScheduler. Customizers are applied in the order that they were added after builder configuration has been applied. Setting this value will replace any previously configured customizers.

Parameters:

customizers - the customizers to set

Returns:

a new builder instance

See Also:

additionalCustomizers(TaskSchedulerCustomizer...)

additionalCustomizers

public TaskSchedulerBuilder additionalCustomizers(TaskSchedulerCustomizer... customizers)

Add taskSchedulerCustomizers that should be applied to the ThreadPoolTaskScheduler. Customizers are applied in the order that they were added after builder configuration has been applied.

Parameters:

customizers - the customizers to add

Returns:

a new builder instance

See Also:

customizers(TaskSchedulerCustomizer...)

additionalCustomizers

public TaskSchedulerBuilder additionalCustomizers(Iterable<TaskSchedulerCustomizer> customizers)

Add taskSchedulerCustomizers that should be applied to the ThreadPoolTaskScheduler. Customizers are applied in the order that they were added after builder configuration has been applied.

Parameters:

customizers - the customizers to add

Returns:

a new builder instance

See Also:

customizers(TaskSchedulerCustomizer...)

build

public ThreadPoolTaskScheduler build()

Build a new ThreadPoolTaskScheduler instance and configure it using this builder.

Returns:

a configured ThreadPoolTaskScheduler instance.

See Also:

configure(ThreadPoolTaskScheduler)

configure

public <T extends ThreadPoolTaskScheduler> T configure(T taskScheduler)

Configure the provided ThreadPoolTaskScheduler instance using this builder.

Type Parameters:

T - the type of task scheduler

Parameters:

taskScheduler - the ThreadPoolTaskScheduler to configure

Returns:

the task scheduler instance

See Also:

build()