模块 wjybxx.commons.concurrent

程序包 cn.wjybxx.sequential

类 AbstractUniScheduledExecutor

java.lang.Object

cn.wjybxx.sequential.AbstractUniExecutor

cn.wjybxx.sequential.AbstractUniScheduledExecutor

所有已实现的接口:

IExecutor, IExecutorService, IScheduledExecutorService, UniExecutorService, UniScheduledExecutor, AutoCloseable, Executor, ExecutorService, ScheduledExecutorService

直接已知子类:

DefaultUniScheduledExecutor

public abstract class AbstractUniScheduledExecutor
extends AbstractUniExecutor
implements UniScheduledExecutor

子类需要在AbstractUniExecutor.execute(Runnable)的时候为任务赋值id和options

作者:

wjybxx date - 2023/4/7

字段概要

从类继承的字段 cn.wjybxx.sequential.AbstractUniExecutor

logger

构造器概要

构造器

构造器	说明
AbstractUniScheduledExecutor()

方法概要

修饰符和类型	方法	说明
void	execute(Consumer<? super IContext> action, IContext ctx)	Consumer和Runnable的lambda差异足够大，因此选择重载。
void	execute(Consumer<? super IContext> action, IContext ctx, int options)
<V> IScheduledPromise<V>	newScheduledPromise()	创建一个promise以用于任务调度 如果当前Executor是SingleThreadExecutor，返回的future将禁止在当前EventLoop上执行阻塞操作。
protected abstract void	removeScheduled(UniScheduledPromiseTask<?> futureTask)	请求删除给定的任务
protected abstract void	reSchedulePeriodic(UniScheduledPromiseTask<?> futureTask, boolean triggered)	请求将当前任务重新压入队列 1.一定从当前线程调用 2.如果无法继续调度任务，则取消任务
<V> IScheduledFuture<V>	schedule(ScheduledTaskBuilder<V> builder)	为避免过多的参数和重载方法，我们通过Builder构建更为复杂的任务。
IScheduledFuture<?>	schedule(Runnable task, long delay, TimeUnit unit)	延迟指定时间后执行给定的任务 延迟指定时间后执行给定的任务
<V> IScheduledFuture<V>	schedule(Callable<V> task, long delay, TimeUnit unit)	延迟指定时间后执行给定的任务 延迟指定时间后执行给定的任务
IScheduledFuture<?>	scheduleAction(Consumer<? super IContext> task, IContext ctx, long delay, TimeUnit unit)	延迟指定时间后执行给定的任务
IScheduledFuture<?>	scheduleAtFixedRate(Runnable task, long initialDelay, long period, TimeUnit unit)	以固定频率执行给定的任务（少执行了会补-慎用） 以固定频率执行给定的任务（少执行了会补-慎用）
<V> IScheduledFuture<V>	scheduleFunc(Function<? super IContext,V> task, IContext ctx, long delay, TimeUnit unit)	延迟指定时间后执行给定的任务
IScheduledFuture<?>	scheduleWithFixedDelay(Runnable task, long initialDelay, long delay, TimeUnit unit)	以固定延迟执行给定的任务(少执行了就少执行了) 以固定延迟执行给定的任务(少执行了就少执行了)
<V> IFuture<V>	submit(TaskBuilder<V> builder)
<T> IFuture<T>	submit(Callable<T> task)
IFuture<?>	submitAction(Runnable task)
IFuture<?>	submitAction(Runnable task, int options)
IFuture<?>	submitAction(Consumer<? super IContext> task, IContext ctx)
IFuture<?>	submitAction(Consumer<? super IContext> task, IContext ctx, int options)
<V> IFuture<V>	submitFunc(Callable<? extends V> task)
<V> IFuture<V>	submitFunc(Callable<? extends V> task, int options)
<V> IFuture<V>	submitFunc(Function<? super IContext,? extends V> task, IContext ctx)
<V> IFuture<V>	submitFunc(Function<? super IContext,? extends V> task, IContext ctx, int options)
protected abstract long	tickTime()	当前线程的时间 1.

从类继承的方法 cn.wjybxx.sequential.AbstractUniExecutor

awaitTermination, execute, execute, logCause, newPromise, safeExecute

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

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

从接口继承的方法 java.util.concurrent.ExecutorService

close

从接口继承的方法 cn.wjybxx.concurrent.IExecutor

execute, execute

从接口继承的方法 cn.wjybxx.concurrent.IExecutorService

awaitTermination, isShutdown, isShuttingDown, isTerminated, newPromise, shutdown, shutdownNow, submit, submit, terminationFuture

从接口继承的方法 cn.wjybxx.sequential.UniExecutorService

invokeAll, invokeAll, invokeAny, invokeAny, needMoreUpdate, update

构造器详细资料

AbstractUniScheduledExecutor

public AbstractUniScheduledExecutor()

方法详细资料

newScheduledPromise

public <V> IScheduledPromise<V> newScheduledPromise()

从接口复制的说明: IScheduledExecutorService

创建一个promise以用于任务调度 如果当前Executor是SingleThreadExecutor，返回的future将禁止在当前EventLoop上执行阻塞操作。

指定者:

newScheduledPromise 在接口中 IScheduledExecutorService

schedule

public <V> IScheduledFuture<V> schedule(ScheduledTaskBuilder<V> builder)

从接口复制的说明: IScheduledExecutorService

为避免过多的参数和重载方法，我们通过Builder构建更为复杂的任务。

指定者:

schedule 在接口中 IScheduledExecutorService

类型参数:

V - 任务的结果类型

参数:

builder - 任务构建器。

返回:

future

scheduleFunc

public <V> IScheduledFuture<V> scheduleFunc(Function<? super IContext,V> task,
 IContext ctx,
 long delay,
 TimeUnit unit)

从接口复制的说明: IScheduledExecutorService

延迟指定时间后执行给定的任务

指定者:

scheduleFunc 在接口中 IScheduledExecutorService

参数:

task - 要执行的任务

ctx - 上下文-主要是取消令牌

scheduleAction

public IScheduledFuture<?> scheduleAction(Consumer<? super IContext> task,
 IContext ctx,
 long delay,
 TimeUnit unit)

从接口复制的说明: IScheduledExecutorService

延迟指定时间后执行给定的任务

指定者:

scheduleAction 在接口中 IScheduledExecutorService

参数:

task - 要执行的任务

ctx - 上下文-主要是取消令牌

schedule

public IScheduledFuture<?> schedule(Runnable task,
 long delay,
 TimeUnit unit)

从接口复制的说明: IScheduledExecutorService

延迟指定时间后执行给定的任务

指定者:

schedule 在接口中 IScheduledExecutorService

指定者:

schedule 在接口中 ScheduledExecutorService

schedule

public <V> IScheduledFuture<V> schedule(Callable<V> task,
 long delay,
 TimeUnit unit)

从接口复制的说明: IScheduledExecutorService

延迟指定时间后执行给定的任务

指定者:

schedule 在接口中 IScheduledExecutorService

指定者:

schedule 在接口中 ScheduledExecutorService

scheduleAtFixedRate

public IScheduledFuture<?> scheduleAtFixedRate(Runnable task,
 long initialDelay,
 long period,
 TimeUnit unit)

从接口复制的说明: IScheduledExecutorService

以固定频率执行给定的任务（少执行了会补-慎用）

指定者:

scheduleAtFixedRate 在接口中 IScheduledExecutorService

指定者:

scheduleAtFixedRate 在接口中 ScheduledExecutorService

scheduleWithFixedDelay

public IScheduledFuture<?> scheduleWithFixedDelay(Runnable task,
 long initialDelay,
 long delay,
 TimeUnit unit)

从接口复制的说明: IScheduledExecutorService

以固定延迟执行给定的任务(少执行了就少执行了)

指定者:

scheduleWithFixedDelay 在接口中 IScheduledExecutorService

指定者:

scheduleWithFixedDelay 在接口中 ScheduledExecutorService

submit

public <V> IFuture<V> submit(@Nonnull
 TaskBuilder<V> builder)

指定者:

submit 在接口中 IExecutorService

覆盖:

submit 在类中 AbstractUniExecutor

execute

public void execute(Consumer<? super IContext> action,
 IContext ctx)

从接口复制的说明: IExecutor

Consumer和Runnable的lambda差异足够大，因此选择重载。

指定者:

execute 在接口中 IExecutor

覆盖:

execute 在类中 AbstractUniExecutor

参数:

action - 要执行的任务

ctx - 任务绑定的上下文

execute

public void execute(Consumer<? super IContext> action,
 IContext ctx,
 int options)

指定者:

execute 在接口中 IExecutor

覆盖:

execute 在类中 AbstractUniExecutor

submit

public <T> IFuture<T> submit(Callable<T> task)

指定者:

submit 在接口中 ExecutorService

指定者:

submit 在接口中 IExecutorService

覆盖:

submit 在类中 AbstractUniExecutor

submitFunc

public <V> IFuture<V> submitFunc(Callable<? extends V> task)

指定者:

submitFunc 在接口中 IExecutorService

覆盖:

submitFunc 在类中 AbstractUniExecutor

submitFunc

public <V> IFuture<V> submitFunc(Callable<? extends V> task,
 int options)

指定者:

submitFunc 在接口中 IExecutorService

覆盖:

submitFunc 在类中 AbstractUniExecutor

submitFunc

public <V> IFuture<V> submitFunc(Function<? super IContext,? extends V> task,
 IContext ctx)

指定者:

submitFunc 在接口中 IExecutorService

覆盖:

submitFunc 在类中 AbstractUniExecutor

submitFunc

public <V> IFuture<V> submitFunc(Function<? super IContext,? extends V> task,
 IContext ctx,
 int options)

指定者:

submitFunc 在接口中 IExecutorService

覆盖:

submitFunc 在类中 AbstractUniExecutor

submitAction

public IFuture<?> submitAction(Runnable task)

指定者:

submitAction 在接口中 IExecutorService

覆盖:

submitAction 在类中 AbstractUniExecutor

submitAction

public IFuture<?> submitAction(Runnable task,
 int options)

指定者:

submitAction 在接口中 IExecutorService

覆盖:

submitAction 在类中 AbstractUniExecutor

submitAction

public IFuture<?> submitAction(Consumer<? super IContext> task,
 IContext ctx)

指定者:

submitAction 在接口中 IExecutorService

覆盖:

submitAction 在类中 AbstractUniExecutor

submitAction

public IFuture<?> submitAction(Consumer<? super IContext> task,
 IContext ctx,
 int options)

指定者:

submitAction 在接口中 IExecutorService

覆盖:

submitAction 在类中 AbstractUniExecutor

tickTime

protected abstract long tickTime()

当前线程的时间 1. 可以使用缓存的时间，也可以使用实时查询，只要不破坏任务的执行约定即可。 2. 如果使用缓存时间，接口中并不约定时间的更新时机，也不约定一个大循环只更新一次。也就是说，线程可能在任意时间点更新缓存的时间，只要不破坏线程安全性和约定的任务时序。

reSchedulePeriodic

protected abstract void reSchedulePeriodic(UniScheduledPromiseTask<?> futureTask,
 boolean triggered)

请求将当前任务重新压入队列 1.一定从当前线程调用 2.如果无法继续调度任务，则取消任务

参数:

triggered - 是否是执行之后压入队列；通常用于在执行成功之后降低优先级

removeScheduled

protected abstract void removeScheduled(UniScheduledPromiseTask<?> futureTask)

请求删除给定的任务