Package org.springframework.boot.task

Class ThreadPoolTaskSchedulerBuilder

java.lang.Object

org.springframework.boot.task.ThreadPoolTaskSchedulerBuilder

public class ThreadPoolTaskSchedulerBuilder
extends Object

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

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

Since:

3.2.0

Author:

Stephane Nicoll

Constructor Summary

Constructors

Constructor	Description
ThreadPoolTaskSchedulerBuilder()
ThreadPoolTaskSchedulerBuilder(Integer poolSize, Boolean awaitTermination, Duration awaitTerminationPeriod, String threadNamePrefix, Set<ThreadPoolTaskSchedulerCustomizer> taskSchedulerCustomizers)

Method Summary

Modifier and Type	Method	Description
ThreadPoolTaskSchedulerBuilder	additionalCustomizers(Iterable<? extends ThreadPoolTaskSchedulerCustomizer> customizers)	Add threadPoolTaskSchedulerCustomizers that should be applied to the ThreadPoolTaskScheduler.
ThreadPoolTaskSchedulerBuilder	additionalCustomizers(ThreadPoolTaskSchedulerCustomizer... customizers)	Add threadPoolTaskSchedulerCustomizers that should be applied to the ThreadPoolTaskScheduler.
ThreadPoolTaskSchedulerBuilder	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.
ThreadPoolTaskSchedulerBuilder	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.
ThreadPoolTaskSchedulerBuilder	customizers(Iterable<? extends ThreadPoolTaskSchedulerCustomizer> customizers)	Set the threadPoolTaskSchedulerCustomizers that should be applied to the ThreadPoolTaskScheduler.
ThreadPoolTaskSchedulerBuilder	customizers(ThreadPoolTaskSchedulerCustomizer... customizers)	Set the threadPoolTaskSchedulerCustomizers that should be applied to the ThreadPoolTaskScheduler.
ThreadPoolTaskSchedulerBuilder	poolSize(int poolSize)	Set the maximum allowed number of threads.
ThreadPoolTaskSchedulerBuilder	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 Details

ThreadPoolTaskSchedulerBuilder

public ThreadPoolTaskSchedulerBuilder()

ThreadPoolTaskSchedulerBuilder

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

Method Details

poolSize

public ThreadPoolTaskSchedulerBuilder poolSize(int poolSize)

Set the maximum allowed number of threads.

Parameters:

poolSize - the pool size to set

Returns:

a new builder instance

awaitTermination

public ThreadPoolTaskSchedulerBuilder 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 ThreadPoolTaskSchedulerBuilder 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 ThreadPoolTaskSchedulerBuilder 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 ThreadPoolTaskSchedulerBuilder customizers(ThreadPoolTaskSchedulerCustomizer... customizers)

Set the threadPoolTaskSchedulerCustomizers 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(ThreadPoolTaskSchedulerCustomizer...)

customizers

public ThreadPoolTaskSchedulerBuilder customizers(Iterable<? extends ThreadPoolTaskSchedulerCustomizer> customizers)

Set the threadPoolTaskSchedulerCustomizers 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(ThreadPoolTaskSchedulerCustomizer...)

additionalCustomizers

public ThreadPoolTaskSchedulerBuilder additionalCustomizers(ThreadPoolTaskSchedulerCustomizer... customizers)

Add threadPoolTaskSchedulerCustomizers 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(ThreadPoolTaskSchedulerCustomizer...)

additionalCustomizers

public ThreadPoolTaskSchedulerBuilder additionalCustomizers(Iterable<? extends ThreadPoolTaskSchedulerCustomizer> customizers)

Add threadPoolTaskSchedulerCustomizers 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(ThreadPoolTaskSchedulerCustomizer...)

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