Modifier and Type	Class and Description
private static class	NonStickyEventExecutorGroup.NonStickyOrderedEventExecutor

Modifier and Type	Field and Description
private final EventExecutorGroup	group
private final int	maxTaskExecutePerRun

Access	Constructor and Description
public	NonStickyEventExecutorGroup(EventExecutorGroup group) Creates a new instance.
public	NonStickyEventExecutorGroup(EventExecutorGroup group, int maxTaskExecutePerRun) Creates a new instance.

Method Summary

Modifier and Type	Method and Description
public boolean	awaitTermination(long The non-negative maximum amount of time to wait for the executor group to terminate. timeout, TimeUnit The non-null time unit of the timeout. unit) Overrides default io.netty5.util.concurrent.EventExecutorGroup.awaitTermination. Wait for this `EventExecutorGroup` to terminate, up to the given timeout.
public void	execute(Runnable the runnable task task) Overrides default io.netty5.util.concurrent.EventExecutorGroup.execute. Executes the given command at some time in the future.
public boolean	isShutdown() Implements io.netty5.util.concurrent.EventExecutorGroup.isShutdown. Returns `true` if all `EventExecutor`s managed by this `EventExecutorGroup` have been shut down gracefully and moved past the grace period so that they are no longer accepting any new tasks.
public boolean	isShuttingDown() Implements io.netty5.util.concurrent.EventExecutorGroup.isShuttingDown. Returns `true` if and only if all `EventExecutor`s managed by this `EventExecutorGroup` are being shut down gracefully or was shut down.
public boolean	isTerminated() Overrides default io.netty5.util.concurrent.EventExecutorGroup.isTerminated. Returns `true` if all `EventExecutor`s managed by this `EventExecutorGroup` are shut down, and all of their tasks have completed.
public Iterator<EventExecutor>	iterator() Implements io.netty5.util.concurrent.EventExecutorGroup.iterator. Returns an iterator over elements of type `T`.
private NonStickyEventExecutorGroup.NonStickyOrderedEventExecutor	newExecutor(EventExecutor executor)
public EventExecutor	next() Implements io.netty5.util.concurrent.EventExecutorGroup.next. Returns one of the `EventExecutor`s managed by this `EventExecutorGroup`.
public Future<Void>	schedule(Runnable The task that should be executed in this `EventExecutorGroup` after the given delay. task, long A positive time delay, in the given time unit. delay, TimeUnit The non-null time unit for the delay. unit) Overrides default io.netty5.util.concurrent.EventExecutorGroup.schedule. Schedule the given task for execution after the given delay, in the next available `EventExecutor` in this group, and return a future that produces a `null` result when the task completes.
public <V> Future<V>	schedule(Callable<V> The task that should be executed in this `EventExecutorGroup` after the given delay. task, long A positive time delay, in the given time unit. delay, TimeUnit The non-null time unit for the delay. unit) Overrides default io.netty5.util.concurrent.EventExecutorGroup.schedule. Schedule the given task for execution after the given delay, in the next available `EventExecutor` in this group, and return a future that will return the result of the callable when the task completes.
public Future<Void>	scheduleAtFixedRate(Runnable The task that should be scheduled to execute at a fixed rate in this `EventExecutorGroup`. task, long The positive initial delay for the first task execution, in terms of the given time unit. initialDelay, long The positive period for the execution frequency to use after the first execution has started, in terms of the given time unit. period, TimeUnit The non-null time unit for the delay and period. unit) Overrides default io.netty5.util.concurrent.EventExecutorGroup.scheduleAtFixedRate. Schedule the given task for periodic execution in the next available `EventExecutor`.
public Future<Void>	scheduleWithFixedDelay(Runnable The task that should be scheduled to execute with fixed delays in this `EventExecutorGroup`. task, long The positive initial delay for the first task execution, in terms of the given time unit. initialDelay, long The positive subsequent delay between task, to use after the first execution has completed, in terms of the given time unit. delay, TimeUnit The non-null time unit for the delays. unit) Overrides default io.netty5.util.concurrent.EventExecutorGroup.scheduleWithFixedDelay. Schedule the given task for periodic execution in the next available `EventExecutor`.
public Future<Void>	shutdownGracefully() Overrides default io.netty5.util.concurrent.EventExecutorGroup.shutdownGracefully. Shortcut method for `shutdownGracefully(long, long, TimeUnit)` with sensible default values.
public Future<Void>	shutdownGracefully(long the quiet period as described in the documentation quietPeriod, long the maximum amount of time to wait until the executor is shutting down regardless if a task was submitted during the quiet period. timeout, TimeUnit the unit of `quietPeriod` and `timeout` unit) Implements io.netty5.util.concurrent.EventExecutorGroup.shutdownGracefully. Signals this executor that the caller wants the executor to be shut down.
public Future<Void>	submit(Runnable The task that should be executed in this `EventExecutorGroup`. task) Overrides default io.netty5.util.concurrent.EventExecutorGroup.submit. Submit the given task for execution in the next available `EventExecutor` in this group, and return a future that produces a `null` result when the task completes.
public <T> Future<T>	submit(Runnable The task that should be executed in this `EventExecutorGroup`. task, T The value that the returned future will complete with, if the task completes successfully. result) Overrides default io.netty5.util.concurrent.EventExecutorGroup.submit. Submit the given task for execution in the next available `EventExecutor` in this group, and return a future that produces the given result when the task completes.
public <T> Future<T>	submit(Callable<T> The task that should be executed in this `EventExecutorGroup`. task) Overrides default io.netty5.util.concurrent.EventExecutorGroup.submit. Submit the given task for execution in the next available `EventExecutor` in this group, and return a future that will return the result of the callable when the task completes.
public Future<Void>	terminationFuture() Implements io.netty5.util.concurrent.EventExecutorGroup.terminationFuture. Returns the `Future` which is notified when all `EventExecutor`s managed by this `EventExecutorGroup` have been terminated.
private static EventExecutorGroup	verify(EventExecutorGroup group)

Inherited from java.lang.Object:: clone equals finalize getClass hashCode notify notifyAll toString wait wait wait

Field Detail

group	back to summary
private final EventExecutorGroup group

maxTaskExecutePerRun	back to summary
private final int maxTaskExecutePerRun

NonStickyEventExecutorGroup	back to summary
public NonStickyEventExecutorGroup(EventExecutorGroup group) Creates a new instance. Be aware that the given `EventExecutorGroup` MUST NOT contain any `OrderedEventExecutor`s.

NonStickyEventExecutorGroup	back to summary
public NonStickyEventExecutorGroup(EventExecutorGroup group, int maxTaskExecutePerRun) Creates a new instance. Be aware that the given `EventExecutorGroup` MUST NOT contain any `OrderedEventExecutor`s.

Method Detail

awaitTermination back to summary

awaitTermination	back to summary
public boolean awaitTermination(long timeout, TimeUnit unit) throws InterruptedException Overrides default io.netty5.util.concurrent.EventExecutorGroup.awaitTermination. Doc from io.netty5.util.concurrent.EventExecutorGroup.awaitTermination. Wait for this `EventExecutorGroup` to terminate, up to the given timeout. Parameters timeout:long The non-negative maximum amount of time to wait for the executor group to terminate. unit:TimeUnit The non-null time unit of the timeout. Returns:boolean `true` if the executor group terminated within the specific timeout. Annotations @Override Exceptions InterruptedException: If this thread was interrupted while waiting for executor group to terminate.

public boolean awaitTermination(long timeout, TimeUnit unit) throws InterruptedException

Overrides default io.netty5.util.concurrent.EventExecutorGroup.awaitTermination.

Doc from io.netty5.util.concurrent.EventExecutorGroup.awaitTermination.

Wait for this EventExecutorGroup to terminate, up to the given timeout.

Parameters

timeout:long: The non-negative maximum amount of time to wait for the executor group to terminate.
unit:TimeUnit: The non-null time unit of the timeout.

Returns:boolean

true if the executor group terminated within the specific timeout.

Annotations

@Override

Exceptions

InterruptedException:: If this thread was interrupted while waiting for executor group to terminate.

execute back to summary

execute	back to summary
public void execute(Runnable task) Overrides default io.netty5.util.concurrent.EventExecutorGroup.execute. Doc from java.util.concurrent.Executor.execute. Executes the given command at some time in the future. The command may execute in a new thread, in a pooled thread, or in the calling thread, at the discretion of the `Executor` implementation. Parameters task:Runnable the runnable task Annotations @Override

public void execute(Runnable task)

Overrides default io.netty5.util.concurrent.EventExecutorGroup.execute.

Doc from java.util.concurrent.Executor.execute.

Executes the given command at some time in the future. The command may execute in a new thread, in a pooled thread, or in the calling thread, at the discretion of the Executor implementation.

Parameters

task:Runnable: the runnable task

Annotations

@Override

isShutdown back to summary

isShutdown	back to summary
public boolean isShutdown() Implements io.netty5.util.concurrent.EventExecutorGroup.isShutdown. Doc from io.netty5.util.concurrent.EventExecutorGroup.isShutdown. Returns `true` if all `EventExecutor`s managed by this `EventExecutorGroup` have been shut down gracefully and moved past the grace period so that they are no longer accepting any new tasks. An executor group that "is shut down" might still be executing tasks that it has queued up, but it will no longer be accepting any new tasks. Once all running and queued tasks have completed, the executor group will be terminated. Returns:boolean `true` if all executors in this group have shut down and are no longer accepting any new tasks. Annotations @Override

public boolean isShutdown()

Implements io.netty5.util.concurrent.EventExecutorGroup.isShutdown.

Doc from io.netty5.util.concurrent.EventExecutorGroup.isShutdown.

Returns true if all EventExecutors managed by this EventExecutorGroup have been shut down gracefully and moved past the grace period so that they are no longer accepting any new tasks.

An executor group that "is shut down" might still be executing tasks that it has queued up, but it will no longer be accepting any new tasks. Once all running and queued tasks have completed, the executor group will be terminated.

Returns:boolean

true if all executors in this group have shut down and are no longer accepting any new tasks.

Annotations

@Override

isShuttingDown back to summary

isShuttingDown	back to summary
public boolean isShuttingDown() Implements io.netty5.util.concurrent.EventExecutorGroup.isShuttingDown. Doc from io.netty5.util.concurrent.EventExecutorGroup.isShuttingDown. Returns `true` if and only if all `EventExecutor`s managed by this `EventExecutorGroup` are being shut down gracefully or was shut down. An executor group that "is shutting down" can still accept new tasks for a little while (the grace period), but will eventually start rejecting new tasks. At that point, the executor group will be shut down. Returns:boolean `true` if all executors in this group have at least started shutting down, otherwise `false`. Annotations @Override

public boolean isShuttingDown()

Implements io.netty5.util.concurrent.EventExecutorGroup.isShuttingDown.

Doc from io.netty5.util.concurrent.EventExecutorGroup.isShuttingDown.

Returns true if and only if all EventExecutors managed by this EventExecutorGroup are being shut down gracefully or was shut down.

An executor group that "is shutting down" can still accept new tasks for a little while (the grace period), but will eventually start rejecting new tasks. At that point, the executor group will be shut down.

Returns:boolean

true if all executors in this group have at least started shutting down, otherwise false.

Annotations

@Override

isTerminated back to summary

isTerminated	back to summary
public boolean isTerminated() Overrides default io.netty5.util.concurrent.EventExecutorGroup.isTerminated. Doc from io.netty5.util.concurrent.EventExecutorGroup.isTerminated. Returns `true` if all `EventExecutor`s managed by this `EventExecutorGroup` are shut down, and all of their tasks have completed. Returns:boolean `true` if all executors in this group have terminated. Annotations @Override

public boolean isTerminated()

Overrides default io.netty5.util.concurrent.EventExecutorGroup.isTerminated.

Doc from io.netty5.util.concurrent.EventExecutorGroup.isTerminated.

Returns true if all EventExecutors managed by this EventExecutorGroup are shut down, and all of their tasks have completed.

Returns:boolean

true if all executors in this group have terminated.

Annotations

@Override

iterator back to summary

iterator	back to summary
public Iterator<EventExecutor> iterator() Implements io.netty5.util.concurrent.EventExecutorGroup.iterator. Doc from java.lang.Iterable.iterator. Returns an iterator over elements of type `T`. Returns:Iterator<EventExecutor> an Iterator. Annotations @Override

public Iterator<EventExecutor> iterator()

Implements io.netty5.util.concurrent.EventExecutorGroup.iterator.

Doc from java.lang.Iterable.iterator.

Returns an iterator over elements of type T.

Returns:Iterator<EventExecutor>

an Iterator.

Annotations

@Override

newExecutor	back to summary
private NonStickyEventExecutorGroup.NonStickyOrderedEventExecutor newExecutor(EventExecutor executor)

next back to summary

next	back to summary
public EventExecutor next() Implements io.netty5.util.concurrent.EventExecutorGroup.next. Doc from io.netty5.util.concurrent.EventExecutorGroup.next. Returns one of the `EventExecutor`s managed by this `EventExecutorGroup`. Annotations @Override

public EventExecutor next()

Implements io.netty5.util.concurrent.EventExecutorGroup.next.

Doc from io.netty5.util.concurrent.EventExecutorGroup.next.

Returns one of the EventExecutors managed by this EventExecutorGroup.

Annotations

@Override

schedule back to summary

schedule	back to summary
public Future<Void> schedule(Runnable task, long delay, TimeUnit unit) Overrides default io.netty5.util.concurrent.EventExecutorGroup.schedule. Doc from io.netty5.util.concurrent.EventExecutorGroup.schedule. Schedule the given task for execution after the given delay, in the next available `EventExecutor` in this group, and return a future that produces a `null` result when the task completes. Parameters task:Runnable The task that should be executed in this `EventExecutorGroup` after the given delay. delay:long A positive time delay, in the given time unit. unit:TimeUnit The non-null time unit for the delay. Returns:Future<Void> A future that represents the completion of the scheduled task. Annotations @Override

public Future<Void> schedule(Runnable task, long delay, TimeUnit unit)

Overrides default io.netty5.util.concurrent.EventExecutorGroup.schedule.

Doc from io.netty5.util.concurrent.EventExecutorGroup.schedule.

Schedule the given task for execution after the given delay, in the next available EventExecutor in this group, and return a future that produces a null result when the task completes.

Parameters

task:Runnable: The task that should be executed in this EventExecutorGroup after the given delay.
delay:long: A positive time delay, in the given time unit.
unit:TimeUnit: The non-null time unit for the delay.

Returns:Future<Void>

A future that represents the completion of the scheduled task.

Annotations

@Override

schedule back to summary

schedule	back to summary
public <V> Future<V> schedule(Callable<V> task, long delay, TimeUnit unit) Overrides default io.netty5.util.concurrent.EventExecutorGroup.schedule. Doc from io.netty5.util.concurrent.EventExecutorGroup.schedule. Schedule the given task for execution after the given delay, in the next available `EventExecutor` in this group, and return a future that will return the result of the callable when the task completes. Parameters <V> The type of the future result. task:Callable<V> The task that should be executed in this `EventExecutorGroup` after the given delay. delay:long A positive time delay, in the given time unit. unit:TimeUnit The non-null time unit for the delay. Returns:Future<V> A future that represents the completion of the scheduled task. Annotations @Override

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

Overrides default io.netty5.util.concurrent.EventExecutorGroup.schedule.

Doc from io.netty5.util.concurrent.EventExecutorGroup.schedule.

Schedule the given task for execution after the given delay, in the next available EventExecutor in this group, and return a future that will return the result of the callable when the task completes.

Parameters

<V>: The type of the future result.
task:Callable<V>: The task that should be executed in this EventExecutorGroup after the given delay.
delay:long: A positive time delay, in the given time unit.
unit:TimeUnit: The non-null time unit for the delay.

Returns:Future<V>

A future that represents the completion of the scheduled task.

Annotations

@Override

scheduleAtFixedRate back to summary

scheduleAtFixedRate	back to summary
public Future<Void> scheduleAtFixedRate(Runnable task, long initialDelay, long period, TimeUnit unit) Overrides default io.netty5.util.concurrent.EventExecutorGroup.scheduleAtFixedRate. Doc from io.netty5.util.concurrent.EventExecutorGroup.scheduleAtFixedRate. Schedule the given task for periodic execution in the next available `EventExecutor`. The first execution will occur after the given initial delay, and the following repeated executions will occur with the given period of time between each execution is started. If the task takes longer to complete than the requested period, then the following executions will be delayed, rather than allowing multiple instances of the task to run concurrently. The task will be executed repeatedly until it either fails with an exception, or its future is cancelled. The future thus will never complete successfully. Parameters task:Runnable The task that should be scheduled to execute at a fixed rate in this `EventExecutorGroup`. initialDelay:long The positive initial delay for the first task execution, in terms of the given time unit. period:long The positive period for the execution frequency to use after the first execution has started, in terms of the given time unit. unit:TimeUnit The non-null time unit for the delay and period. Returns:Future<Void> A future that represents the recurring task, and which can be cancelled to stop future executions. Annotations @Override

public Future<Void> scheduleAtFixedRate(Runnable task, long initialDelay, long period, TimeUnit unit)

Overrides default io.netty5.util.concurrent.EventExecutorGroup.scheduleAtFixedRate.

Doc from io.netty5.util.concurrent.EventExecutorGroup.scheduleAtFixedRate.

Schedule the given task for periodic execution in the next available EventExecutor. The first execution will occur after the given initial delay, and the following repeated executions will occur with the given period of time between each execution is started. If the task takes longer to complete than the requested period, then the following executions will be delayed, rather than allowing multiple instances of the task to run concurrently.

The task will be executed repeatedly until it either fails with an exception, or its future is cancelled. The future thus will never complete successfully.

Parameters

task:Runnable: The task that should be scheduled to execute at a fixed rate in this EventExecutorGroup.
initialDelay:long: The positive initial delay for the first task execution, in terms of the given time unit.
period:long: The positive period for the execution frequency to use after the first execution has started, in terms of the given time unit.
unit:TimeUnit: The non-null time unit for the delay and period.

Returns:Future<Void>

A future that represents the recurring task, and which can be cancelled to stop future executions.

Annotations

@Override

scheduleWithFixedDelay back to summary

scheduleWithFixedDelay	back to summary
public Future<Void> scheduleWithFixedDelay(Runnable task, long initialDelay, long delay, TimeUnit unit) Overrides default io.netty5.util.concurrent.EventExecutorGroup.scheduleWithFixedDelay. Doc from io.netty5.util.concurrent.EventExecutorGroup.scheduleWithFixedDelay. Schedule the given task for periodic execution in the next available `EventExecutor`. The first execution will occur after the given initial delay, and the following repeated executions will occur with the given subsequent delay between one task completing and the next task starting. The delay from the completion of one task, to the start of the next, stays unchanged regardless of how long a task takes to complete. This is in contrast to `scheduleAtFixedRate(Runnable, long, long, TimeUnit)` which varies the delays between the tasks in order to hit a given frequency. The task will be executed repeatedly until it either fails with an exception, or its future is cancelled. The future thus will never complete successfully. Parameters task:Runnable The task that should be scheduled to execute with fixed delays in this `EventExecutorGroup`. initialDelay:long The positive initial delay for the first task execution, in terms of the given time unit. delay:long The positive subsequent delay between task, to use after the first execution has completed, in terms of the given time unit. unit:TimeUnit The non-null time unit for the delays. Returns:Future<Void> A future that represents the recurring task, and which can be cancelled to stop future executions. Annotations @Override

public Future<Void> scheduleWithFixedDelay(Runnable task, long initialDelay, long delay, TimeUnit unit)

Overrides default io.netty5.util.concurrent.EventExecutorGroup.scheduleWithFixedDelay.

Doc from io.netty5.util.concurrent.EventExecutorGroup.scheduleWithFixedDelay.

Schedule the given task for periodic execution in the next available EventExecutor. The first execution will occur after the given initial delay, and the following repeated executions will occur with the given subsequent delay between one task completing and the next task starting. The delay from the completion of one task, to the start of the next, stays unchanged regardless of how long a task takes to complete.

This is in contrast to scheduleAtFixedRate(Runnable, long, long, TimeUnit) which varies the delays between the tasks in order to hit a given frequency.

The task will be executed repeatedly until it either fails with an exception, or its future is cancelled. The future thus will never complete successfully.

Parameters

task:Runnable: The task that should be scheduled to execute with fixed delays in this EventExecutorGroup.
initialDelay:long: The positive initial delay for the first task execution, in terms of the given time unit.
delay:long: The positive subsequent delay between task, to use after the first execution has completed, in terms of the given time unit.
unit:TimeUnit: The non-null time unit for the delays.

Returns:Future<Void>

A future that represents the recurring task, and which can be cancelled to stop future executions.

Annotations

@Override

shutdownGracefully back to summary

shutdownGracefully	back to summary
public Future<Void> shutdownGracefully() Overrides default io.netty5.util.concurrent.EventExecutorGroup.shutdownGracefully. Doc from io.netty5.util.concurrent.EventExecutorGroup.shutdownGracefully. Shortcut method for `shutdownGracefully(long, long, TimeUnit)` with sensible default values. Returns:Future<Void> the `terminationFuture()` Annotations @Override

public Future<Void> shutdownGracefully()

Overrides default io.netty5.util.concurrent.EventExecutorGroup.shutdownGracefully.

Doc from io.netty5.util.concurrent.EventExecutorGroup.shutdownGracefully.

Shortcut method for shutdownGracefully(long, long, TimeUnit) with sensible default values.

Returns:Future<Void>

the terminationFuture()

Annotations

@Override

shutdownGracefully back to summary

shutdownGracefully	back to summary
public Future<Void> shutdownGracefully(long quietPeriod, long timeout, TimeUnit unit) Implements io.netty5.util.concurrent.EventExecutorGroup.shutdownGracefully. Doc from io.netty5.util.concurrent.EventExecutorGroup.shutdownGracefully. Signals this executor that the caller wants the executor to be shut down. Once this method is called, `isShuttingDown()` starts to return `true`, and the executor prepares to shut itself down. This method ensures that no tasks are submitted for 'the quiet period' (usually a couple seconds) before it shuts itself down. If a task is submitted during the quiet period, it is guaranteed to be accepted and the quiet period will start over. Parameters quietPeriod:long the quiet period as described in the documentation timeout:long the maximum amount of time to wait until the executor is shutting down regardless if a task was submitted during the quiet period. unit:TimeUnit the unit of `quietPeriod` and `timeout` Returns:Future<Void> the `terminationFuture()` Annotations @Override

public Future<Void> shutdownGracefully(long quietPeriod, long timeout, TimeUnit unit)

Implements io.netty5.util.concurrent.EventExecutorGroup.shutdownGracefully.

Doc from io.netty5.util.concurrent.EventExecutorGroup.shutdownGracefully.

Signals this executor that the caller wants the executor to be shut down. Once this method is called, isShuttingDown() starts to return true, and the executor prepares to shut itself down. This method ensures that no tasks are submitted for 'the quiet period' (usually a couple seconds) before it shuts itself down. If a task is submitted during the quiet period, it is guaranteed to be accepted and the quiet period will start over.

Parameters

quietPeriod:long: the quiet period as described in the documentation
timeout:long: the maximum amount of time to wait until the executor is shutting down regardless if a task was submitted during the quiet period.
unit:TimeUnit: the unit of quietPeriod and timeout

Returns:Future<Void>

the terminationFuture()

Annotations

@Override

submit back to summary

submit	back to summary
public Future<Void> submit(Runnable task) Overrides default io.netty5.util.concurrent.EventExecutorGroup.submit. Doc from io.netty5.util.concurrent.EventExecutorGroup.submit. Submit the given task for execution in the next available `EventExecutor` in this group, and return a future that produces a `null` result when the task completes. Parameters task:Runnable The task that should be executed in this `EventExecutorGroup`. Returns:Future<Void> A future that represents the completion of the submitted task. Annotations @Override

public Future<Void> submit(Runnable task)

Overrides default io.netty5.util.concurrent.EventExecutorGroup.submit.

Doc from io.netty5.util.concurrent.EventExecutorGroup.submit.

Submit the given task for execution in the next available EventExecutor in this group, and return a future that produces a null result when the task completes.

Parameters

task:Runnable: The task that should be executed in this EventExecutorGroup.

Returns:Future<Void>

A future that represents the completion of the submitted task.

Annotations

@Override

submit back to summary

submit	back to summary
public <T> Future<T> submit(Runnable task, T result) Overrides default io.netty5.util.concurrent.EventExecutorGroup.submit. Doc from io.netty5.util.concurrent.EventExecutorGroup.submit. Submit the given task for execution in the next available `EventExecutor` in this group, and return a future that produces the given result when the task completes. Parameters <T> The type of the future result. task:Runnable The task that should be executed in this `EventExecutorGroup`. result:T The value that the returned future will complete with, if the task completes successfully. Returns:Future<T> A future that represents the completion of the submitted task. Annotations @Override

public <T> Future<T> submit(Runnable task, T result)

Overrides default io.netty5.util.concurrent.EventExecutorGroup.submit.

Doc from io.netty5.util.concurrent.EventExecutorGroup.submit.

Submit the given task for execution in the next available EventExecutor in this group, and return a future that produces the given result when the task completes.

Parameters

<T>: The type of the future result.
task:Runnable: The task that should be executed in this EventExecutorGroup.
result:T: The value that the returned future will complete with, if the task completes successfully.

Returns:Future<T>

A future that represents the completion of the submitted task.

Annotations

@Override

submit back to summary

submit	back to summary
public <T> Future<T> submit(Callable<T> task) Overrides default io.netty5.util.concurrent.EventExecutorGroup.submit. Doc from io.netty5.util.concurrent.EventExecutorGroup.submit. Submit the given task for execution in the next available `EventExecutor` in this group, and return a future that will return the result of the callable when the task completes. Parameters <T> The type of the future result. task:Callable<T> The task that should be executed in this `EventExecutorGroup`. Returns:Future<T> A future that represents the completion of the submitted task. Annotations @Override

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

Overrides default io.netty5.util.concurrent.EventExecutorGroup.submit.

Doc from io.netty5.util.concurrent.EventExecutorGroup.submit.

Submit the given task for execution in the next available EventExecutor in this group, and return a future that will return the result of the callable when the task completes.

Parameters

<T>: The type of the future result.
task:Callable<T>: The task that should be executed in this EventExecutorGroup.

Returns:Future<T>

A future that represents the completion of the submitted task.

Annotations

@Override

terminationFuture back to summary

terminationFuture	back to summary
public Future<Void> terminationFuture() Implements io.netty5.util.concurrent.EventExecutorGroup.terminationFuture. Doc from io.netty5.util.concurrent.EventExecutorGroup.terminationFuture. Returns the `Future` which is notified when all `EventExecutor`s managed by this `EventExecutorGroup` have been terminated. Returns:Future<Void> The `Future` representing the termination of this `EventExecutorGroup`. Annotations @Override

public Future<Void> terminationFuture()

Implements io.netty5.util.concurrent.EventExecutorGroup.terminationFuture.

Doc from io.netty5.util.concurrent.EventExecutorGroup.terminationFuture.

Returns the Future which is notified when all EventExecutors managed by this EventExecutorGroup have been terminated.

Returns:Future<Void>

The Future representing the termination of this EventExecutorGroup.

Annotations

@Override

verify	back to summary
private static EventExecutorGroup verify(EventExecutorGroup group)

io.netty5.util.concurrent back to summary

private final Class NonStickyEventExecutorGroup.NonStickyOrderedEventExecutor

Class Inheritance

extends AbstractEventExecutor
implements Runnable, OrderedEventExecutor

java.lang.Object
io.netty5.util.concurrent.AbstractEventExecutor
io.netty5.util.concurrent.NonStickyEventExecutorGroup.NonStickyOrderedEventExecutor

All Implemented Interfaces

io.netty5.util.concurrent.OrderedEventExecutor, io.netty5.util.concurrent.EventExecutor, io.netty5.util.concurrent.FuturePromiseFactory, io.netty5.util.concurrent.EventExecutorGroup, java.util.concurrent.Executor, java.lang.Iterable, java.lang.Runnable

Field Summary

Modifier and Type	Field and Description
private final EventExecutor	executor
private final int	maxTaskExecutePerRun
private static final int	NONE
private static final int	RUNNING
private final AtomicInteger	state
private static final int	SUBMITTED
private final Queue<Runnable>	tasks

Inherited from io.netty5.util.concurrent.AbstractEventExecutor:: DEFAULT_SHUTDOWN_QUIET_PERIOD DEFAULT_SHUTDOWN_TIMEOUT

Constructor Summary

Access	Constructor and Description
pack-priv	NonStickyOrderedEventExecutor(EventExecutor executor, int maxTaskExecutePerRun)

Method Summary

Modifier and Type	Method and Description
public boolean	awaitTermination(long The non-negative maximum amount of time to wait for the executor group to terminate. timeout, TimeUnit The non-null time unit of the timeout. unit) Overrides default io.netty5.util.concurrent.EventExecutorGroup.awaitTermination. Wait for this `EventExecutorGroup` to terminate, up to the given timeout.
public void	execute(Runnable the runnable task task) Implements io.netty5.util.concurrent.EventExecutor.execute. Executes the given command at some time in the future.
public boolean	inEventLoop(Thread thread) Implements io.netty5.util.concurrent.EventExecutor.inEventLoop. Return `true` if the given `Thread` is executed in the event loop, `false` otherwise.
public boolean	isShutdown() Implements io.netty5.util.concurrent.EventExecutorGroup.isShutdown. Returns `true` if all `EventExecutor`s managed by this `EventExecutorGroup` have been shut down gracefully and moved past the grace period so that they are no longer accepting any new tasks.
public boolean	isShuttingDown() Implements io.netty5.util.concurrent.EventExecutorGroup.isShuttingDown. Returns `true` if and only if all `EventExecutor`s managed by this `EventExecutorGroup` are being shut down gracefully or was shut down.
public boolean	isTerminated() Overrides default io.netty5.util.concurrent.EventExecutorGroup.isTerminated. Returns `true` if all `EventExecutor`s managed by this `EventExecutorGroup` are shut down, and all of their tasks have completed.
public void	run() Implements java.lang.Runnable.run. Runs this operation.
public Future<Void>	schedule(Runnable The task that should be executed in this `EventExecutorGroup` after the given delay. task, long A positive time delay, in the given time unit. delay, TimeUnit The non-null time unit for the delay. unit) Implements io.netty5.util.concurrent.EventExecutor.schedule. Schedule the given task for execution after the given delay, in the next available `EventExecutor` in this group, and return a future that produces a `null` result when the task completes.
public <V> Future<V>	schedule(Callable<V> The task that should be executed in this `EventExecutorGroup` after the given delay. task, long A positive time delay, in the given time unit. delay, TimeUnit The non-null time unit for the delay. unit) Implements io.netty5.util.concurrent.EventExecutor.schedule. Schedule the given task for execution after the given delay, in the next available `EventExecutor` in this group, and return a future that will return the result of the callable when the task completes.
public Future<Void>	scheduleAtFixedRate(Runnable The task that should be scheduled to execute at a fixed rate in this `EventExecutorGroup`. task, long The positive initial delay for the first task execution, in terms of the given time unit. initialDelay, long The positive period for the execution frequency to use after the first execution has started, in terms of the given time unit. period, TimeUnit The non-null time unit for the delay and period. unit) Implements io.netty5.util.concurrent.EventExecutor.scheduleAtFixedRate. Schedule the given task for periodic execution in the next available `EventExecutor`.
public Future<Void>	scheduleWithFixedDelay(Runnable The task that should be scheduled to execute with fixed delays in this `EventExecutorGroup`. task, long The positive initial delay for the first task execution, in terms of the given time unit. initialDelay, long The positive subsequent delay between task, to use after the first execution has completed, in terms of the given time unit. delay, TimeUnit The non-null time unit for the delays. unit) Implements io.netty5.util.concurrent.EventExecutor.scheduleWithFixedDelay. Schedule the given task for periodic execution in the next available `EventExecutor`.
public Future<Void>	shutdownGracefully(long the quiet period as described in the documentation quietPeriod, long the maximum amount of time to wait until the executor is shutting down regardless if a task was submitted during the quiet period. timeout, TimeUnit the unit of `quietPeriod` and `timeout` unit) Implements io.netty5.util.concurrent.EventExecutorGroup.shutdownGracefully. Signals this executor that the caller wants the executor to be shut down.
public Future<Void>	terminationFuture() Implements io.netty5.util.concurrent.EventExecutorGroup.terminationFuture. Returns the `Future` which is notified when all `EventExecutor`s managed by this `EventExecutorGroup` have been terminated.

Inherited from io.netty5.util.concurrent.AbstractEventExecutor:: newSucceededFuture newTaskFor newTaskFor safeExecute submit submit submit

Field Detail

executor	back to summary
private final EventExecutor executor

maxTaskExecutePerRun	back to summary
private final int maxTaskExecutePerRun

NONE	back to summary
private static final int NONE

RUNNING	back to summary
private static final int RUNNING

state	back to summary
private final AtomicInteger state

SUBMITTED	back to summary
private static final int SUBMITTED

tasks	back to summary
private final Queue<Runnable> tasks

Constructor Detail

NonStickyOrderedEventExecutor	back to summary
pack-priv NonStickyOrderedEventExecutor(EventExecutor executor, int maxTaskExecutePerRun)

Method Detail

awaitTermination back to summary

awaitTermination	back to summary
public boolean awaitTermination(long timeout, TimeUnit unit) throws InterruptedException Overrides default io.netty5.util.concurrent.EventExecutorGroup.awaitTermination. Doc from io.netty5.util.concurrent.EventExecutorGroup.awaitTermination. Wait for this `EventExecutorGroup` to terminate, up to the given timeout. Parameters timeout:long The non-negative maximum amount of time to wait for the executor group to terminate. unit:TimeUnit The non-null time unit of the timeout. Returns:boolean `true` if the executor group terminated within the specific timeout. Annotations @Override Exceptions InterruptedException: If this thread was interrupted while waiting for executor group to terminate.

public boolean awaitTermination(long timeout, TimeUnit unit) throws InterruptedException

Overrides default io.netty5.util.concurrent.EventExecutorGroup.awaitTermination.

Doc from io.netty5.util.concurrent.EventExecutorGroup.awaitTermination.

Wait for this EventExecutorGroup to terminate, up to the given timeout.

Parameters

timeout:long: The non-negative maximum amount of time to wait for the executor group to terminate.
unit:TimeUnit: The non-null time unit of the timeout.

Returns:boolean

true if the executor group terminated within the specific timeout.

Annotations

@Override

Exceptions

InterruptedException:: If this thread was interrupted while waiting for executor group to terminate.

execute back to summary

execute	back to summary
public void execute(Runnable task) Implements io.netty5.util.concurrent.EventExecutor.execute. Doc from java.util.concurrent.Executor.execute. Executes the given command at some time in the future. The command may execute in a new thread, in a pooled thread, or in the calling thread, at the discretion of the `Executor` implementation. Parameters task:Runnable the runnable task Annotations @Override

public void execute(Runnable task)

Implements io.netty5.util.concurrent.EventExecutor.execute.

Doc from java.util.concurrent.Executor.execute.

Executes the given command at some time in the future. The command may execute in a new thread, in a pooled thread, or in the calling thread, at the discretion of the Executor implementation.

Parameters

task:Runnable: the runnable task

Annotations

@Override

inEventLoop back to summary

inEventLoop	back to summary
public boolean inEventLoop(Thread thread) Implements io.netty5.util.concurrent.EventExecutor.inEventLoop. Doc from io.netty5.util.concurrent.EventExecutor.inEventLoop. Return `true` if the given `Thread` is executed in the event loop, `false` otherwise. Annotations @Override

public boolean inEventLoop(Thread thread)

Implements io.netty5.util.concurrent.EventExecutor.inEventLoop.

Doc from io.netty5.util.concurrent.EventExecutor.inEventLoop.

Return true if the given Thread is executed in the event loop, false otherwise.

Annotations

@Override

isShutdown back to summary

isShutdown	back to summary
public boolean isShutdown() Implements io.netty5.util.concurrent.EventExecutorGroup.isShutdown. Doc from io.netty5.util.concurrent.EventExecutorGroup.isShutdown. Returns `true` if all `EventExecutor`s managed by this `EventExecutorGroup` have been shut down gracefully and moved past the grace period so that they are no longer accepting any new tasks. An executor group that "is shut down" might still be executing tasks that it has queued up, but it will no longer be accepting any new tasks. Once all running and queued tasks have completed, the executor group will be terminated. Returns:boolean `true` if all executors in this group have shut down and are no longer accepting any new tasks. Annotations @Override

public boolean isShutdown()

Implements io.netty5.util.concurrent.EventExecutorGroup.isShutdown.

Doc from io.netty5.util.concurrent.EventExecutorGroup.isShutdown.

Returns true if all EventExecutors managed by this EventExecutorGroup have been shut down gracefully and moved past the grace period so that they are no longer accepting any new tasks.

Returns:boolean

true if all executors in this group have shut down and are no longer accepting any new tasks.

Annotations

@Override

isShuttingDown back to summary

isShuttingDown	back to summary
public boolean isShuttingDown() Implements io.netty5.util.concurrent.EventExecutorGroup.isShuttingDown. Doc from io.netty5.util.concurrent.EventExecutorGroup.isShuttingDown. Returns `true` if and only if all `EventExecutor`s managed by this `EventExecutorGroup` are being shut down gracefully or was shut down. An executor group that "is shutting down" can still accept new tasks for a little while (the grace period), but will eventually start rejecting new tasks. At that point, the executor group will be shut down. Returns:boolean `true` if all executors in this group have at least started shutting down, otherwise `false`. Annotations @Override

public boolean isShuttingDown()

Implements io.netty5.util.concurrent.EventExecutorGroup.isShuttingDown.

Doc from io.netty5.util.concurrent.EventExecutorGroup.isShuttingDown.

Returns true if and only if all EventExecutors managed by this EventExecutorGroup are being shut down gracefully or was shut down.

Returns:boolean

true if all executors in this group have at least started shutting down, otherwise false.

Annotations

@Override

isTerminated back to summary

isTerminated	back to summary
public boolean isTerminated() Overrides default io.netty5.util.concurrent.EventExecutorGroup.isTerminated. Doc from io.netty5.util.concurrent.EventExecutorGroup.isTerminated. Returns `true` if all `EventExecutor`s managed by this `EventExecutorGroup` are shut down, and all of their tasks have completed. Returns:boolean `true` if all executors in this group have terminated. Annotations @Override

public boolean isTerminated()

Overrides default io.netty5.util.concurrent.EventExecutorGroup.isTerminated.

Doc from io.netty5.util.concurrent.EventExecutorGroup.isTerminated.

Returns true if all EventExecutors managed by this EventExecutorGroup are shut down, and all of their tasks have completed.

Returns:boolean

true if all executors in this group have terminated.

Annotations

@Override

run	back to summary
public void run() Implements java.lang.Runnable.run. Doc from java.lang.Runnable.run. Runs this operation. Annotations @Override

run

back to summary

public void run()

Implements java.lang.Runnable.run.

Doc from java.lang.Runnable.run.

Runs this operation.

Annotations

@Override

schedule back to summary

schedule	back to summary
public Future<Void> schedule(Runnable task, long delay, TimeUnit unit) Implements io.netty5.util.concurrent.EventExecutor.schedule. Doc from io.netty5.util.concurrent.EventExecutorGroup.schedule. Schedule the given task for execution after the given delay, in the next available `EventExecutor` in this group, and return a future that produces a `null` result when the task completes. Parameters task:Runnable The task that should be executed in this `EventExecutorGroup` after the given delay. delay:long A positive time delay, in the given time unit. unit:TimeUnit The non-null time unit for the delay. Returns:Future<Void> A future that represents the completion of the scheduled task. Annotations @Override

public Future<Void> schedule(Runnable task, long delay, TimeUnit unit)

Implements io.netty5.util.concurrent.EventExecutor.schedule.

Doc from io.netty5.util.concurrent.EventExecutorGroup.schedule.

Schedule the given task for execution after the given delay, in the next available EventExecutor in this group, and return a future that produces a null result when the task completes.

Parameters

task:Runnable: The task that should be executed in this EventExecutorGroup after the given delay.
delay:long: A positive time delay, in the given time unit.
unit:TimeUnit: The non-null time unit for the delay.

Returns:Future<Void>

A future that represents the completion of the scheduled task.

Annotations

@Override

schedule back to summary

schedule	back to summary
public <V> Future<V> schedule(Callable<V> task, long delay, TimeUnit unit) Implements io.netty5.util.concurrent.EventExecutor.schedule. Doc from io.netty5.util.concurrent.EventExecutorGroup.schedule. Schedule the given task for execution after the given delay, in the next available `EventExecutor` in this group, and return a future that will return the result of the callable when the task completes. Parameters <V> The type of the future result. task:Callable<V> The task that should be executed in this `EventExecutorGroup` after the given delay. delay:long A positive time delay, in the given time unit. unit:TimeUnit The non-null time unit for the delay. Returns:Future<V> A future that represents the completion of the scheduled task. Annotations @Override

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

Implements io.netty5.util.concurrent.EventExecutor.schedule.

Doc from io.netty5.util.concurrent.EventExecutorGroup.schedule.

Parameters

<V>: The type of the future result.
task:Callable<V>: The task that should be executed in this EventExecutorGroup after the given delay.
delay:long: A positive time delay, in the given time unit.
unit:TimeUnit: The non-null time unit for the delay.

Returns:Future<V>

A future that represents the completion of the scheduled task.

Annotations

@Override

scheduleAtFixedRate back to summary

scheduleAtFixedRate	back to summary
public Future<Void> scheduleAtFixedRate(Runnable task, long initialDelay, long period, TimeUnit unit) Implements io.netty5.util.concurrent.EventExecutor.scheduleAtFixedRate. Doc from io.netty5.util.concurrent.EventExecutorGroup.scheduleAtFixedRate. Schedule the given task for periodic execution in the next available `EventExecutor`. The first execution will occur after the given initial delay, and the following repeated executions will occur with the given period of time between each execution is started. If the task takes longer to complete than the requested period, then the following executions will be delayed, rather than allowing multiple instances of the task to run concurrently. The task will be executed repeatedly until it either fails with an exception, or its future is cancelled. The future thus will never complete successfully. Parameters task:Runnable The task that should be scheduled to execute at a fixed rate in this `EventExecutorGroup`. initialDelay:long The positive initial delay for the first task execution, in terms of the given time unit. period:long The positive period for the execution frequency to use after the first execution has started, in terms of the given time unit. unit:TimeUnit The non-null time unit for the delay and period. Returns:Future<Void> A future that represents the recurring task, and which can be cancelled to stop future executions. Annotations @Override

public Future<Void> scheduleAtFixedRate(Runnable task, long initialDelay, long period, TimeUnit unit)

Implements io.netty5.util.concurrent.EventExecutor.scheduleAtFixedRate.

Doc from io.netty5.util.concurrent.EventExecutorGroup.scheduleAtFixedRate.

The task will be executed repeatedly until it either fails with an exception, or its future is cancelled. The future thus will never complete successfully.

Parameters

task:Runnable: The task that should be scheduled to execute at a fixed rate in this EventExecutorGroup.
initialDelay:long: The positive initial delay for the first task execution, in terms of the given time unit.
period:long: The positive period for the execution frequency to use after the first execution has started, in terms of the given time unit.
unit:TimeUnit: The non-null time unit for the delay and period.

Returns:Future<Void>

A future that represents the recurring task, and which can be cancelled to stop future executions.

Annotations

@Override

scheduleWithFixedDelay back to summary

scheduleWithFixedDelay	back to summary
public Future<Void> scheduleWithFixedDelay(Runnable task, long initialDelay, long delay, TimeUnit unit) Implements io.netty5.util.concurrent.EventExecutor.scheduleWithFixedDelay. Doc from io.netty5.util.concurrent.EventExecutorGroup.scheduleWithFixedDelay. Schedule the given task for periodic execution in the next available `EventExecutor`. The first execution will occur after the given initial delay, and the following repeated executions will occur with the given subsequent delay between one task completing and the next task starting. The delay from the completion of one task, to the start of the next, stays unchanged regardless of how long a task takes to complete. This is in contrast to `scheduleAtFixedRate(Runnable, long, long, TimeUnit)` which varies the delays between the tasks in order to hit a given frequency. The task will be executed repeatedly until it either fails with an exception, or its future is cancelled. The future thus will never complete successfully. Parameters task:Runnable The task that should be scheduled to execute with fixed delays in this `EventExecutorGroup`. initialDelay:long The positive initial delay for the first task execution, in terms of the given time unit. delay:long The positive subsequent delay between task, to use after the first execution has completed, in terms of the given time unit. unit:TimeUnit The non-null time unit for the delays. Returns:Future<Void> A future that represents the recurring task, and which can be cancelled to stop future executions. Annotations @Override

public Future<Void> scheduleWithFixedDelay(Runnable task, long initialDelay, long delay, TimeUnit unit)

Implements io.netty5.util.concurrent.EventExecutor.scheduleWithFixedDelay.

Doc from io.netty5.util.concurrent.EventExecutorGroup.scheduleWithFixedDelay.

Schedule the given task for periodic execution in the next available EventExecutor. The first execution will occur after the given initial delay, and the following repeated executions will occur with the given subsequent delay between one task completing and the next task starting. The delay from the completion of one task, to the start of the next, stays unchanged regardless of how long a task takes to complete.

This is in contrast to scheduleAtFixedRate(Runnable, long, long, TimeUnit) which varies the delays between the tasks in order to hit a given frequency.

The task will be executed repeatedly until it either fails with an exception, or its future is cancelled. The future thus will never complete successfully.

Parameters

task:Runnable: The task that should be scheduled to execute with fixed delays in this EventExecutorGroup.
initialDelay:long: The positive initial delay for the first task execution, in terms of the given time unit.
delay:long: The positive subsequent delay between task, to use after the first execution has completed, in terms of the given time unit.
unit:TimeUnit: The non-null time unit for the delays.

Returns:Future<Void>

A future that represents the recurring task, and which can be cancelled to stop future executions.

Annotations

@Override

shutdownGracefully back to summary

shutdownGracefully	back to summary
public Future<Void> shutdownGracefully(long quietPeriod, long timeout, TimeUnit unit) Implements io.netty5.util.concurrent.EventExecutorGroup.shutdownGracefully. Doc from io.netty5.util.concurrent.EventExecutorGroup.shutdownGracefully. Signals this executor that the caller wants the executor to be shut down. Once this method is called, `isShuttingDown()` starts to return `true`, and the executor prepares to shut itself down. This method ensures that no tasks are submitted for 'the quiet period' (usually a couple seconds) before it shuts itself down. If a task is submitted during the quiet period, it is guaranteed to be accepted and the quiet period will start over. Parameters quietPeriod:long the quiet period as described in the documentation timeout:long the maximum amount of time to wait until the executor is shutting down regardless if a task was submitted during the quiet period. unit:TimeUnit the unit of `quietPeriod` and `timeout` Returns:Future<Void> the `terminationFuture()` Annotations @Override

public Future<Void> shutdownGracefully(long quietPeriod, long timeout, TimeUnit unit)

Implements io.netty5.util.concurrent.EventExecutorGroup.shutdownGracefully.

Doc from io.netty5.util.concurrent.EventExecutorGroup.shutdownGracefully.

Parameters

quietPeriod:long: the quiet period as described in the documentation
timeout:long: the maximum amount of time to wait until the executor is shutting down regardless if a task was submitted during the quiet period.
unit:TimeUnit: the unit of quietPeriod and timeout

Returns:Future<Void>