Document limited support for lifecycle management

Closes gh-33780
This commit is contained in:
Juergen Hoeller
2024-10-28 22:08:41 +01:00
parent 94d46eba3c
commit 323de1208a
2 changed files with 8 additions and 1 deletions

View File

@@ -78,7 +78,9 @@ import org.springframework.util.ErrorHandler;
* but rather just the hand-off to an execution thread.</b> As a consequence,
* a {@link ScheduledFuture} handle (e.g. from {@link #schedule(Runnable, Instant)})
* represents that hand-off rather than the actual completion of the provided task
* (or series of repeated tasks).
* (or series of repeated tasks). Also, this scheduler participates in lifecycle
* management to a limited degree only, stopping trigger firing and fixed-delay
* task execution but not stopping the execution of handed-off tasks.
*
* <p>As an alternative to the built-in thread-per-task capability, this scheduler
* can also be configured with a separate target executor for scheduled task

View File

@@ -46,6 +46,11 @@ import org.springframework.util.concurrent.ListenableFutureTask;
* executing a large number of short-lived tasks. Alternatively, on JDK 21,
* consider setting {@link #setVirtualThreads} to {@code true}.
*
* <p><b>NOTE: This executor does not participate in context-level lifecycle
* management.</b> Tasks on handed-off execution threads cannot be centrally
* stopped and restarted; if such tight lifecycle management is necessary,
* consider a common {@code ThreadPoolTaskExecutor} setup instead.
*
* @author Juergen Hoeller
* @since 2.0
* @see #setVirtualThreads