模块 wjybxx.commons.concurrent

程序包 cn.wjybxx.concurrent

类 AbstractEventLoopGroup

java.lang.Object

cn.wjybxx.concurrent.AbstractEventLoopGroup

所有已实现的接口:

EventLoopGroup, IExecutor, IExecutorService, IScheduledExecutorService, AutoCloseable, Iterable<EventLoop>, Executor, ExecutorService, ScheduledExecutorService

直接已知子类:

DefaultFixedEventLoopGroup

public abstract class AbstractEventLoopGroup
extends Object
implements EventLoopGroup

默认的实现仅仅是简单的将任务分配给某个EventLoop执行

作者:

wjybxx date 2023/4/8

构造器概要

构造器

构造器	说明
AbstractEventLoopGroup()

方法概要

修饰符和类型	方法	说明
void	execute(Runnable command)	在将来的某个时间执行给定的命令。
void	execute(Runnable command, int options)	在将来的某个时间执行给定的命令。
void	execute(Consumer<? super IContext> action, IContext ctx)	Consumer和Runnable的lambda差异足够大，因此选择重载。
void	execute(Consumer<? super IContext> action, IContext ctx, int options)
<T> List<Future<T>>	invokeAll(Collection<? extends Callable<T>> tasks)
<T> List<Future<T>>	invokeAll(Collection<? extends Callable<T>> tasks, long timeout, TimeUnit unit)
<T> T	invokeAny(Collection<? extends Callable<T>> tasks)
<T> T	invokeAny(Collection<? extends Callable<T>> tasks, long timeout, TimeUnit unit)
<T> IPromise<T>	newPromise()	创建一个promise以用于任务调度 如果当前Executor是SingleThreadExecutor，返回的future将禁止在当前EventLoop上执行阻塞操作。
<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)	以固定延迟执行给定的任务(少执行了就少执行了) 以固定延迟执行给定的任务(少执行了就少执行了)
<T> IFuture<T>	submit(TaskBuilder<T> 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)

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

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

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

awaitTermination, isShutdown, isShuttingDown, isTerminated, iterator, select, shutdown, shutdownNow, terminationFuture

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

close

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

submit, submit

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

newScheduledPromise

从接口继承的方法 java.lang.Iterable

forEach, spliterator

构造器详细资料

AbstractEventLoopGroup

public AbstractEventLoopGroup()

方法详细资料

execute

public void execute(@Nonnull
 Runnable command)

从接口复制的说明: IExecutor

在将来的某个时间执行给定的命令。 命令可以在新线程中执行，也可以在池线程中执行，或者在调用线程中执行，这由Executor实现决定。 Executor.execute(Runnable)

指定者:

execute 在接口中 Executor

指定者:

execute 在接口中 IExecutor

参数:

command - 要执行的任务，注意ITask类型

execute

public void execute(Runnable command,
 int options)

从接口复制的说明: IExecutor

在将来的某个时间执行给定的命令。 命令可以在新线程中执行，也可以在池线程中执行，或者在调用线程中执行，这由Executor实现决定。 Executor.execute(Runnable)

任务的调度特征值 1.Executor需要感知用户任务的一些属性，以实现更好的管理。 2.选项可参考TaskOption。 3.该接口不应该测试任务的类型，应当以参数的options为准。

指定者:

execute 在接口中 IExecutor

参数:

command - 要执行的任务

options - 任务的调度特征值，见TaskOption

execute

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

从接口复制的说明: IExecutor

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

指定者:

execute 在接口中 IExecutor

参数:

action - 要执行的任务

ctx - 任务绑定的上下文

execute

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

指定者:

execute 在接口中 IExecutor

newPromise

public <T> IPromise<T> newPromise()

从接口复制的说明: IExecutorService

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

指定者:

newPromise 在接口中 IExecutorService

submit

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

指定者:

submit 在接口中 IExecutorService

submit

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

指定者:

submit 在接口中 ExecutorService

指定者:

submit 在接口中 IExecutorService

submitFunc

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

指定者:

submitFunc 在接口中 IExecutorService

submitFunc

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

指定者:

submitFunc 在接口中 IExecutorService

submitFunc

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

指定者:

submitFunc 在接口中 IExecutorService

submitFunc

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

指定者:

submitFunc 在接口中 IExecutorService

submitAction

public IFuture<?> submitAction(Runnable task)

指定者:

submitAction 在接口中 IExecutorService

submitAction

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

指定者:

submitAction 在接口中 IExecutorService

submitAction

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

指定者:

submitAction 在接口中 IExecutorService

submitAction

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

指定者:

submitAction 在接口中 IExecutorService

schedule

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

从接口复制的说明: IScheduledExecutorService

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

指定者:

schedule 在接口中 IScheduledExecutorService

类型参数:

V - 任务的结果类型

参数:

builder - 任务构建器。

返回:

future

scheduleAction

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

从接口复制的说明: IScheduledExecutorService

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

指定者:

scheduleAction 在接口中 IScheduledExecutorService

参数:

task - 要执行的任务

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

scheduleFunc

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

从接口复制的说明: IScheduledExecutorService

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

指定者:

scheduleFunc 在接口中 IScheduledExecutorService

参数:

task - 要执行的任务

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

schedule

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

从接口复制的说明: IScheduledExecutorService

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

指定者:

schedule 在接口中 IScheduledExecutorService

指定者:

schedule 在接口中 ScheduledExecutorService

schedule

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

从接口复制的说明: IScheduledExecutorService

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

指定者:

schedule 在接口中 IScheduledExecutorService

指定者:

schedule 在接口中 ScheduledExecutorService

scheduleWithFixedDelay

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

从接口复制的说明: IScheduledExecutorService

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

指定者:

scheduleWithFixedDelay 在接口中 IScheduledExecutorService

指定者:

scheduleWithFixedDelay 在接口中 ScheduledExecutorService

scheduleAtFixedRate

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

从接口复制的说明: IScheduledExecutorService

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

指定者:

scheduleAtFixedRate 在接口中 IScheduledExecutorService

指定者:

scheduleAtFixedRate 在接口中 ScheduledExecutorService

invokeAll

@Nonnull
public <T> List<Future<T>> invokeAll(@Nonnull
 Collection<? extends Callable<T>> tasks)
                              throws InterruptedException

指定者:

invokeAll 在接口中 ExecutorService

指定者:

invokeAll 在接口中 IExecutorService

抛出:

InterruptedException

invokeAll

@Nonnull
public <T> List<Future<T>> invokeAll(@Nonnull
 Collection<? extends Callable<T>> tasks,
 long timeout,
 @Nonnull
 TimeUnit unit)
                              throws InterruptedException

指定者:

invokeAll 在接口中 ExecutorService

指定者:

invokeAll 在接口中 IExecutorService

抛出:

InterruptedException

invokeAny

@Nonnull
public <T> T invokeAny(@Nonnull
 Collection<? extends Callable<T>> tasks)
                throws InterruptedException,
ExecutionException

指定者:

invokeAny 在接口中 ExecutorService

指定者:

invokeAny 在接口中 IExecutorService

抛出:

InterruptedException

ExecutionException

invokeAny

public <T> T invokeAny(@Nonnull
 Collection<? extends Callable<T>> tasks,
 long timeout,
 @Nonnull
 TimeUnit unit)
                throws InterruptedException,
ExecutionException,
TimeoutException

指定者:

invokeAny 在接口中 ExecutorService

指定者:

invokeAny 在接口中 IExecutorService

抛出:

InterruptedException

ExecutionException

TimeoutException