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(Integer poolSize, String threadNamePrefix, Set<TaskSchedulerCustomizer> taskSchedulerCustomizers)
TaskSchedulerBuilder(TaskSchedulerCustomizer... taskSchedulerCustomizers)

Method Summary

Modifier and Type	Method and Description
TaskSchedulerBuilder	additionalCustomizers(Collection<? extends TaskSchedulerCustomizer> taskSchedulerCustomizers) Add taskSchedulerCustomizers that should be applied to the ThreadPoolTaskScheduler.
TaskSchedulerBuilder	additionalCustomizers(TaskSchedulerCustomizer... taskSchedulerCustomizers) Add taskSchedulerCustomizers that should be applied to the ThreadPoolTaskScheduler.
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(Collection<? extends TaskSchedulerCustomizer> taskSchedulerCustomizers) Set the taskSchedulerCustomizers that should be applied to the ThreadPoolTaskScheduler.
TaskSchedulerBuilder	customizers(TaskSchedulerCustomizer... taskSchedulerCustomizers) 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(TaskSchedulerCustomizer... taskSchedulerCustomizers)

TaskSchedulerBuilder

public TaskSchedulerBuilder(Integer poolSize,
                            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

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... taskSchedulerCustomizers)

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:

taskSchedulerCustomizers - the customizers to set

Returns:

a new builder instance

See Also:

additionalCustomizers(TaskSchedulerCustomizer...)

customizers

public TaskSchedulerBuilder customizers(Collection<? extends TaskSchedulerCustomizer> taskSchedulerCustomizers)

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:

taskSchedulerCustomizers - the customizers to set

Returns:

a new builder instance

See Also:

additionalCustomizers(TaskSchedulerCustomizer...)

additionalCustomizers

public TaskSchedulerBuilder additionalCustomizers(TaskSchedulerCustomizer... taskSchedulerCustomizers)

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:

taskSchedulerCustomizers - the customizers to add

Returns:

a new builder instance

See Also:

customizers(TaskSchedulerCustomizer...)

additionalCustomizers

public TaskSchedulerBuilder additionalCustomizers(Collection<? extends TaskSchedulerCustomizer> taskSchedulerCustomizers)

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:

taskSchedulerCustomizers - 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()