程序包 cn.taketoday.scheduling.concurrent

类 ConcurrentTaskScheduler

java.lang.Object

cn.taketoday.scheduling.concurrent.ConcurrentTaskExecutor

cn.taketoday.scheduling.concurrent.ConcurrentTaskScheduler

所有已实现的接口:

cn.taketoday.core.task.AsyncListenableTaskExecutor, cn.taketoday.core.task.AsyncTaskExecutor, cn.taketoday.core.task.TaskExecutor, SchedulingTaskExecutor, TaskScheduler, Executor

直接已知子类:

DefaultManagedTaskScheduler

public class ConcurrentTaskScheduler
extends ConcurrentTaskExecutor
implements TaskScheduler

Adapter that takes a java.util.concurrent.ScheduledExecutorService and exposes a Framework TaskScheduler for it. Extends ConcurrentTaskExecutor in order to implement the SchedulingTaskExecutor interface as well.

Autodetects a JSR-236 ManagedScheduledExecutorService in order to use it for trigger-based scheduling if possible, instead of local trigger management which ends up delegating to regular delay-based scheduling against the java.util.concurrent.ScheduledExecutorService API. For JSR-236 style lookup in a Jakarta EE environment, consider using DefaultManagedTaskScheduler.

Note that there is a pre-built ThreadPoolTaskScheduler that allows for defining a ScheduledThreadPoolExecutor in bean style, exposing it as a Framework TaskScheduler directly. This is a convenient alternative to a raw ScheduledThreadPoolExecutor definition with a separate definition of the present adapter class.

从以下版本开始:

4.0

作者:

Juergen Hoeller, Mark Fisher

另请参阅:

• ScheduledExecutorService
• ScheduledThreadPoolExecutor
• Executors
• DefaultManagedTaskScheduler
• ThreadPoolTaskScheduler

嵌套类概要

从类继承的嵌套类/接口 cn.taketoday.scheduling.concurrent.ConcurrentTaskExecutor

ConcurrentTaskExecutor.ManagedTaskBuilder

字段概要

从接口继承的字段 cn.taketoday.core.task.AsyncTaskExecutor

TIMEOUT_IMMEDIATE, TIMEOUT_INDEFINITE

构造器概要

构造器

构造器	说明
ConcurrentTaskScheduler()	Create a new ConcurrentTaskScheduler, using a single thread executor as default.
ConcurrentTaskScheduler(Executor concurrentExecutor, ScheduledExecutorService scheduledExecutor)	Create a new ConcurrentTaskScheduler, using the given Executor and ScheduledExecutorService as delegates.
ConcurrentTaskScheduler(ScheduledExecutorService scheduledExecutor)	Create a new ConcurrentTaskScheduler, using the given ScheduledExecutorService as shared delegate.

方法概要

修饰符和类型	方法	说明
Clock	getClock()	Return the clock to use for scheduling purposes.
ScheduledFuture<?>	schedule(Runnable task, Trigger trigger)	Schedule the given Runnable, invoking it whenever the trigger indicates a next execution time.
ScheduledFuture<?>	schedule(Runnable task, Instant startTime)	Schedule the given Runnable, invoking it at the specified execution time.
ScheduledFuture<?>	scheduleAtFixedRate(Runnable task, Duration period)	Schedule the given Runnable, starting as soon as possible and invoking it with the given period.
ScheduledFuture<?>	scheduleAtFixedRate(Runnable task, Instant startTime, Duration period)	Schedule the given Runnable, invoking it at the specified execution time and subsequently with the given period.
ScheduledFuture<?>	scheduleWithFixedDelay(Runnable task, Duration delay)	Schedule the given Runnable, starting as soon as possible and invoking it with the given delay between the completion of one execution and the start of the next.
ScheduledFuture<?>	scheduleWithFixedDelay(Runnable task, Instant startTime, Duration delay)	Schedule the given Runnable, invoking it at the specified execution time and subsequently with the given delay between the completion of one execution and the start of the next.
void	setClock(Clock clock)	Set the clock to use for scheduling purposes.
void	setErrorHandler(cn.taketoday.util.ErrorHandler errorHandler)	Provide an ErrorHandler strategy.
void	setScheduledExecutor(ScheduledExecutorService scheduledExecutor)	Specify the ScheduledExecutorService to delegate to.

从类继承的方法 cn.taketoday.scheduling.concurrent.ConcurrentTaskExecutor

execute, execute, getConcurrentExecutor, setConcurrentExecutor, setTaskDecorator, submit, submit, submitListenable, submitListenable

从类继承的方法 java.lang.Object

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

从接口继承的方法 cn.taketoday.core.task.AsyncTaskExecutor

submitCompletable, submitCompletable

从接口继承的方法 cn.taketoday.scheduling.SchedulingTaskExecutor

prefersShortLivedTasks

从接口继承的方法 cn.taketoday.scheduling.TaskScheduler

schedule, scheduleAtFixedRate, scheduleAtFixedRate, scheduleWithFixedDelay, scheduleWithFixedDelay

构造器详细资料

ConcurrentTaskScheduler

public ConcurrentTaskScheduler()

Create a new ConcurrentTaskScheduler, using a single thread executor as default.

另请参阅:

• Executors.newSingleThreadScheduledExecutor()

ConcurrentTaskScheduler

public ConcurrentTaskScheduler(ScheduledExecutorService scheduledExecutor)

Create a new ConcurrentTaskScheduler, using the given ScheduledExecutorService as shared delegate.

Autodetects a JSR-236 ManagedScheduledExecutorService in order to use it for trigger-based scheduling if possible, instead of local trigger management.

参数:

scheduledExecutor - the ScheduledExecutorService to delegate to for SchedulingTaskExecutor as well as TaskScheduler invocations

ConcurrentTaskScheduler

public ConcurrentTaskScheduler(Executor concurrentExecutor,
 ScheduledExecutorService scheduledExecutor)

Create a new ConcurrentTaskScheduler, using the given Executor and ScheduledExecutorService as delegates.

Autodetects a JSR-236 ManagedScheduledExecutorService in order to use it for trigger-based scheduling if possible, instead of local trigger management.

参数:

concurrentExecutor - the Executor to delegate to for SchedulingTaskExecutor invocations

scheduledExecutor - the ScheduledExecutorService to delegate to for TaskScheduler invocations

方法详细资料

setScheduledExecutor

public void setScheduledExecutor(@Nullable
 ScheduledExecutorService scheduledExecutor)

Specify the ScheduledExecutorService to delegate to.

Autodetects a JSR-236 ManagedScheduledExecutorService in order to use it for trigger-based scheduling if possible, instead of local trigger management.

Note: This will only apply to TaskScheduler invocations. If you want the given executor to apply to SchedulingTaskExecutor invocations as well, pass the same executor reference to ConcurrentTaskExecutor.setConcurrentExecutor(java.util.concurrent.Executor).

另请参阅:

• ConcurrentTaskExecutor.setConcurrentExecutor(java.util.concurrent.Executor)

setErrorHandler

public void setErrorHandler(cn.taketoday.util.ErrorHandler errorHandler)

Provide an ErrorHandler strategy.

setClock

public void setClock(Clock clock)

Set the clock to use for scheduling purposes.

The default clock is the system clock for the default time zone.

另请参阅:

• Clock.systemDefaultZone()

getClock

public Clock getClock()

从接口复制的说明: TaskScheduler

Return the clock to use for scheduling purposes.

指定者:

getClock 在接口中 TaskScheduler

另请参阅:

• Clock.systemDefaultZone()

schedule

@Nullable
public ScheduledFuture<?> schedule(Runnable task,
 Trigger trigger)

从接口复制的说明: TaskScheduler

Schedule the given Runnable, invoking it whenever the trigger indicates a next execution time.

Execution will end once the scheduler shuts down or the returned ScheduledFuture gets cancelled.

指定者:

schedule 在接口中 TaskScheduler

参数:

task - the Runnable to execute whenever the trigger fires

trigger - an implementation of the Trigger interface, e.g. a CronTrigger object wrapping a cron expression

返回:

a ScheduledFuture representing pending completion of the task, or null if the given Trigger object never fires (i.e. returns null from Trigger.nextExecutionTime(cn.taketoday.scheduling.TriggerContext))

另请参阅:

• CronTrigger

schedule

public ScheduledFuture<?> schedule(Runnable task,
 Instant startTime)

从接口复制的说明: TaskScheduler

Schedule the given Runnable, invoking it at the specified execution time.

Execution will end once the scheduler shuts down or the returned ScheduledFuture gets cancelled.

指定者:

schedule 在接口中 TaskScheduler

参数:

task - the Runnable to execute whenever the trigger fires

startTime - the desired execution time for the task (if this is in the past, the task will be executed immediately, i.e. as soon as possible)

返回:

a ScheduledFuture representing pending completion of the task

scheduleAtFixedRate

public ScheduledFuture<?> scheduleAtFixedRate(Runnable task,
 Instant startTime,
 Duration period)

从接口复制的说明: TaskScheduler

Schedule the given Runnable, invoking it at the specified execution time and subsequently with the given period.

Execution will end once the scheduler shuts down or the returned ScheduledFuture gets cancelled.

指定者:

scheduleAtFixedRate 在接口中 TaskScheduler

参数:

task - the Runnable to execute whenever the trigger fires

startTime - the desired first execution time for the task (if this is in the past, the task will be executed immediately, i.e. as soon as possible)

period - the interval between successive executions of the task

返回:

a ScheduledFuture representing pending completion of the task

scheduleAtFixedRate

public ScheduledFuture<?> scheduleAtFixedRate(Runnable task,
 Duration period)

从接口复制的说明: TaskScheduler

Schedule the given Runnable, starting as soon as possible and invoking it with the given period.

Execution will end once the scheduler shuts down or the returned ScheduledFuture gets cancelled.

指定者:

scheduleAtFixedRate 在接口中 TaskScheduler

参数:

task - the Runnable to execute whenever the trigger fires

period - the interval between successive executions of the task

返回:

a ScheduledFuture representing pending completion of the task

scheduleWithFixedDelay

public ScheduledFuture<?> scheduleWithFixedDelay(Runnable task,
 Instant startTime,
 Duration delay)

从接口复制的说明: TaskScheduler

Schedule the given Runnable, invoking it at the specified execution time and subsequently with the given delay between the completion of one execution and the start of the next.

Execution will end once the scheduler shuts down or the returned ScheduledFuture gets cancelled.

指定者:

scheduleWithFixedDelay 在接口中 TaskScheduler

参数:

task - the Runnable to execute whenever the trigger fires

startTime - the desired first execution time for the task (if this is in the past, the task will be executed immediately, i.e. as soon as possible)

delay - the delay between the completion of one execution and the start of the next

返回:

a ScheduledFuture representing pending completion of the task

scheduleWithFixedDelay

public ScheduledFuture<?> scheduleWithFixedDelay(Runnable task,
 Duration delay)

从接口复制的说明: TaskScheduler

Schedule the given Runnable, starting as soon as possible and invoking it with the given delay between the completion of one execution and the start of the next.

Execution will end once the scheduler shuts down or the returned ScheduledFuture gets cancelled.

指定者:

scheduleWithFixedDelay 在接口中 TaskScheduler

参数:

task - the Runnable to execute whenever the trigger fires

delay - the delay between the completion of one execution and the start of the next

返回:

a ScheduledFuture representing pending completion of the task

另请参阅:

• TaskScheduler.scheduleWithFixedDelay(Runnable, long)