io.netty.util.concurrent

Interface EventExecutorGroup

All Superinterfaces:

java.util.concurrent.Executor, java.util.concurrent.ExecutorService, java.lang.Iterable<EventExecutor>, java.util.concurrent.ScheduledExecutorService

All Known Subinterfaces:

EventExecutor, EventLoop, EventLoopGroup, OrderedEventExecutor

All Known Implementing Classes:

AbstractEventExecutor, AbstractEventExecutorGroup, AbstractScheduledEventExecutor, DefaultEventExecutorGroup, EpollEventLoopGroup, GlobalEventExecutor, ImmediateEventExecutor, LocalEventLoopGroup, MultithreadEventExecutorGroup, MultithreadEventLoopGroup, NioEventLoop, NioEventLoopGroup, OioEventLoopGroup, SingleThreadEventExecutor, SingleThreadEventLoop, ThreadPerChannelEventLoop, ThreadPerChannelEventLoopGroup, UnorderedThreadPoolEventExecutor

public interface EventExecutorGroup
extends java.util.concurrent.ScheduledExecutorService, java.lang.Iterable<EventExecutor>

The EventExecutorGroup is responsible for providing the EventExecutor's to use via its next() method. Besides this, it is also responsible for handling their life-cycle and allows shutting them down in a global fashion.

Method Summary

Modifier and Type	Method and Description
boolean	isShuttingDown() Returns true if and only if this executor was started to be shut down gracefuclly or was shut down.
java.util.Iterator<EventExecutor>	iterator() Returns a read-only Iterator over all EventExecutor, which are handled by this EventExecutorGroup at the time of invoke this method.
EventExecutor	next() Returns one of the EventExecutors that belong to this group.
<V> ScheduledFuture<V>	schedule(java.util.concurrent.Callable<V> callable, long delay, java.util.concurrent.TimeUnit unit)
ScheduledFuture<?>	schedule(java.lang.Runnable command, long delay, java.util.concurrent.TimeUnit unit)
ScheduledFuture<?>	scheduleAtFixedRate(java.lang.Runnable command, long initialDelay, long period, java.util.concurrent.TimeUnit unit)
ScheduledFuture<?>	scheduleWithFixedDelay(java.lang.Runnable command, long initialDelay, long delay, java.util.concurrent.TimeUnit unit)
void	shutdown() Deprecated. shutdownGracefully(long, long, TimeUnit) or shutdownGracefully() instead.
Future<?>	shutdownGracefully() Shortcut method for shutdownGracefully(long, long, TimeUnit) with sensible default values.
Future<?>	shutdownGracefully(long quietPeriod, long timeout, java.util.concurrent.TimeUnit unit) Signals this executor that the caller wants the executor to be shut down.
java.util.List<java.lang.Runnable>	shutdownNow() Deprecated. shutdownGracefully(long, long, TimeUnit) or shutdownGracefully() instead.
<T> Future<T>	submit(java.util.concurrent.Callable<T> task)
Future<?>	submit(java.lang.Runnable task)
<T> Future<T>	submit(java.lang.Runnable task, T result)
Future<?>	terminationFuture() Returns the Future which is notified when this executor has been terminated.

Methods inherited from interface java.util.concurrent.ExecutorService

awaitTermination, invokeAll, invokeAll, invokeAny, invokeAny, isShutdown, isTerminated

Methods inherited from interface java.util.concurrent.Executor

execute

Methods inherited from interface java.lang.Iterable

forEach, spliterator

Method Detail

isShuttingDown

boolean isShuttingDown()

Returns true if and only if this executor was started to be shut down gracefuclly or was shut down.

shutdownGracefully

Future<?> shutdownGracefully()

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

Returns:

the terminationFuture()

shutdownGracefully

Future<?> shutdownGracefully(long quietPeriod,
                             long timeout,
                             java.util.concurrent.TimeUnit unit)

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. Unlike shutdown(), graceful shutdown 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 - the quiet period as described in the documentation

timeout - the maximum amount of time to wait until the executor is shutdown() regardless if a task was submitted during the quiet period

unit - the unit of quietPeriod and timeout

Returns:

the terminationFuture()

terminationFuture

Future<?> terminationFuture()

Returns the Future which is notified when this executor has been terminated.

shutdown

@Deprecated
void shutdown()

Deprecated. shutdownGracefully(long, long, TimeUnit) or shutdownGracefully() instead.

Specified by:

shutdown in interface java.util.concurrent.ExecutorService

shutdownNow

@Deprecated
java.util.List<java.lang.Runnable> shutdownNow()

Deprecated. shutdownGracefully(long, long, TimeUnit) or shutdownGracefully() instead.

Specified by:

shutdownNow in interface java.util.concurrent.ExecutorService

next

EventExecutor next()

Returns one of the EventExecutors that belong to this group.

iterator

java.util.Iterator<EventExecutor> iterator()

Returns a read-only Iterator over all EventExecutor, which are handled by this EventExecutorGroup at the time of invoke this method.

Specified by:

iterator in interface java.lang.Iterable<EventExecutor>

submit

Future<?> submit(java.lang.Runnable task)

Specified by:

submit in interface java.util.concurrent.ExecutorService

submit

<T> Future<T> submit(java.lang.Runnable task,
                     T result)

Specified by:

submit in interface java.util.concurrent.ExecutorService

submit

<T> Future<T> submit(java.util.concurrent.Callable<T> task)

Specified by:

submit in interface java.util.concurrent.ExecutorService

schedule

ScheduledFuture<?> schedule(java.lang.Runnable command,
                            long delay,
                            java.util.concurrent.TimeUnit unit)

Specified by:

schedule in interface java.util.concurrent.ScheduledExecutorService

schedule

<V> ScheduledFuture<V> schedule(java.util.concurrent.Callable<V> callable,
                                long delay,
                                java.util.concurrent.TimeUnit unit)

Specified by:

schedule in interface java.util.concurrent.ScheduledExecutorService

scheduleAtFixedRate

ScheduledFuture<?> scheduleAtFixedRate(java.lang.Runnable command,
                                       long initialDelay,
                                       long period,
                                       java.util.concurrent.TimeUnit unit)

Specified by:

scheduleAtFixedRate in interface java.util.concurrent.ScheduledExecutorService

scheduleWithFixedDelay

ScheduledFuture<?> scheduleWithFixedDelay(java.lang.Runnable command,
                                          long initialDelay,
                                          long delay,
                                          java.util.concurrent.TimeUnit unit)

Specified by:

scheduleWithFixedDelay in interface java.util.concurrent.ScheduledExecutorService