Class MultipleTimeTask

java.lang.Object

cool.scx.scheduling.MultipleTimeTask

All Implemented Interfaces:

ScheduleTask

public final class MultipleTimeTask
extends Object
implements ScheduleTask

多次执行的任务

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static enum	MultipleTimeTask.Type

Constructor Summary

Constructors

Constructor	Description
MultipleTimeTask()

Method Summary

Modifier and Type	Method	Description
MultipleTimeTask	concurrent(boolean concurrentExecution)	是否运行并发执行 运行并发执行的时候 当到达规定时间时 无论上一次任务是否结束 都会开启下一次任务
MultipleTimeTask	delay(Duration delay)
MultipleTimeTask	executor(ScheduledExecutorService executor)	执行器
MultipleTimeTask	expirationPolicy(ExpirationPolicy expirationPolicy)	过期策略
MultipleTimeTask	maxRunCount(long maxRunCount)	最大运行次数 (此参数不受并发影响) 注意 当 并行(concurrent) 设置为 false 的时候 也可以在任务内部 取消 如下
ScheduleStatus	start()	启动任务
MultipleTimeTask	startTime(Instant startTime)
MultipleTimeTask	startTime(Supplier<Instant> startTime)
MultipleTimeTask	task(Consumer<ScheduleStatus> task)	任务
MultipleTimeTask	type(MultipleTimeTask.Type type)

Methods inherited from class java.lang.Object

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

Methods inherited from interface cool.scx.scheduling.ScheduleTask

start

Constructor Details

MultipleTimeTask

public MultipleTimeTask()

Method Details

startTime

public MultipleTimeTask startTime(Supplier<Instant> startTime)

startTime

public MultipleTimeTask startTime(Instant startTime)

delay

public MultipleTimeTask delay(Duration delay)

type

public MultipleTimeTask type(MultipleTimeTask.Type type)

concurrent

public MultipleTimeTask concurrent(boolean concurrentExecution)

Description copied from interface: ScheduleTask

是否运行并发执行 运行并发执行的时候 当到达规定时间时 无论上一次任务是否结束 都会开启下一次任务

Specified by:

concurrent in interface ScheduleTask

Parameters:

concurrentExecution - 并发执行

Returns:

self

maxRunCount

public MultipleTimeTask maxRunCount(long maxRunCount)

Description copied from interface: ScheduleTask

最大运行次数 (此参数不受并发影响) 注意 当 并行(concurrent) 设置为 false 的时候 也可以在任务内部 取消 如下

        ScxScheduling
                 .fixedRate()
                 .delay(Duration.ofMillis(1))
                 .concurrent(false)
                 .start(c -> {
                     if (c.runCount() > 10){
                         c.cancel();
                     }
                     System.err.println(" runCount : " + c.runCount());
                 });
  

但是此方式在 允许并发时并不准确 runCount 计数会因为多个线程同时运行累加从而跳过判断条件 所以如果需要 限制最大运行次数 推荐使用此参数

Specified by:

maxRunCount in interface ScheduleTask

Parameters:

maxRunCount - 最大运行次数

Returns:

self

expirationPolicy

public MultipleTimeTask expirationPolicy(ExpirationPolicy expirationPolicy)

Description copied from interface: ScheduleTask

过期策略

Specified by:

expirationPolicy in interface ScheduleTask

Parameters:

expirationPolicy - a

Returns:

a

executor

public MultipleTimeTask executor(ScheduledExecutorService executor)

Description copied from interface: ScheduleTask

执行器

默认会使用单例的 ScxScheduler 不建议自行设置

Specified by:

executor in interface ScheduleTask

Parameters:

executor - 执行器

Returns:

self

task

public MultipleTimeTask task(Consumer<ScheduleStatus> task)

Description copied from interface: ScheduleTask

任务

Specified by:

task in interface ScheduleTask

Parameters:

task - 任务

Returns:

self

start

public ScheduleStatus start()

Description copied from interface: ScheduleTask

启动任务

Specified by:

start in interface ScheduleTask

Returns:

调度状态