io.netty.util.concurrent

Class MultithreadEventExecutorGroup

java.lang.Object

io.netty.util.concurrent.AbstractEventExecutorGroup

io.netty.util.concurrent.MultithreadEventExecutorGroup

All Implemented Interfaces:

EventExecutorGroup, AutoCloseable, Executor, ExecutorService, ScheduledExecutorService

Direct Known Subclasses:

DefaultEventExecutorGroup, MultithreadEventLoopGroup

public abstract class MultithreadEventExecutorGroup
extends AbstractEventExecutorGroup

Abstract base class for EventExecutorGroup implementations that handles their tasks with multiple threads at the same time.

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	MultithreadEventExecutorGroup(int nEventExecutors, Executor executor, Object... args)
protected	MultithreadEventExecutorGroup(int nEventExecutors, ExecutorServiceFactory executorServiceFactory, Object... args)

Method Summary

Methods

Modifier and Type	Method and Description
boolean	awaitTermination(long timeout, TimeUnit unit)
<E extends EventExecutor> Set<E>	children() Returns the unmodifiable set of EventExecutors managed by this EventExecutorGroup.
int	executorCount() Return the number of EventExecutor this implementation uses.
boolean	isShutdown()
boolean	isShuttingDown() Returns true if and only if all EventExecutors managed by this EventExecutorGroup are being shut down gracefuclly or was shut down.
boolean	isTerminated()
protected abstract EventExecutor	newChild(Executor executor, Object... args) Create a new EventExecutor which will later then accessible via the next() method.
protected ExecutorService	newDefaultExecutorService(int nEventExecutors)
EventExecutor	next() Returns one of the EventExecutors managed by this EventExecutorGroup.
void	shutdown() Deprecated.
Future<?>	shutdownGracefully(long quietPeriod, long timeout, TimeUnit unit) Signals this executor that the caller wants the executor to be shut down.
Future<?>	terminationFuture() Returns the Future which is notified when all EventExecutors managed by this EventExecutorGroup have been terminated.

Methods inherited from class io.netty.util.concurrent.AbstractEventExecutorGroup

close, execute, invokeAll, invokeAll, invokeAny, invokeAny, schedule, schedule, scheduleAtFixedRate, scheduleWithFixedDelay, shutdownGracefully, shutdownNow, submit, submit, submit

Methods inherited from class java.lang.Object

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

Constructor Detail

MultithreadEventExecutorGroup

protected MultithreadEventExecutorGroup(int nEventExecutors,
                             ExecutorServiceFactory executorServiceFactory,
                             Object... args)

Parameters:

nEventExecutors - the number of EventExecutors that will be used by this instance. If executor is null this number will also be the parallelism requested from the default executor. It is generally advised for the number of EventExecutors and the number of Threads used by the executor to lie very close together.

executorServiceFactory - the ExecutorServiceFactory to use, or null if the default should be used.

args - arguments which will passed to each newChild(Executor, Object...) call.

MultithreadEventExecutorGroup

protected MultithreadEventExecutorGroup(int nEventExecutors,
                             Executor executor,
                             Object... args)

Parameters:

nEventExecutors - the number of EventExecutors that will be used by this instance. If executor is null this number will also be the parallelism requested from the default executor. It is generally advised for the number of EventExecutors and the number of Threads used by the executor to lie very close together.

executor - the Executor to use, or null if the default should be used.

args - arguments which will passed to each newChild(Executor, Object...) call

Method Detail

newDefaultExecutorService

protected ExecutorService newDefaultExecutorService(int nEventExecutors)

next

public EventExecutor next()

Description copied from interface: EventExecutorGroup

Returns one of the EventExecutors managed by this EventExecutorGroup.

executorCount

public final int executorCount()

Return the number of EventExecutor this implementation uses. This number is the maps 1:1 to the threads it use.

children

public final <E extends EventExecutor> Set<E> children()

Description copied from interface: EventExecutorGroup

Returns the unmodifiable set of EventExecutors managed by this EventExecutorGroup.

newChild

protected abstract EventExecutor newChild(Executor executor,
                     Object... args)
                                   throws Exception

Create a new EventExecutor which will later then accessible via the next() method. This method will be called for each thread that will serve this MultithreadEventExecutorGroup.

Throws:

Exception

shutdownGracefully

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

Description copied from interface: EventExecutorGroup

Signals this executor that the caller wants the executor to be shut down. Once this method is called, EventExecutorGroup.isShuttingDown() starts to return true, and the executor prepares to shut itself down. Unlike EventExecutorGroup.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 EventExecutorGroup.shutdown() regardless if a task was submitted during the quiet period

unit - the unit of quietPeriod and timeout

Returns:

the EventExecutorGroup.terminationFuture()

terminationFuture

public Future<?> terminationFuture()

Description copied from interface: EventExecutorGroup

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

shutdown

@Deprecated
public void shutdown()

Deprecated.

Specified by:

shutdown in interface EventExecutorGroup

Specified by:

shutdown in interface ExecutorService

Specified by:

shutdown in class AbstractEventExecutorGroup

isShuttingDown

public boolean isShuttingDown()

Description copied from interface: EventExecutorGroup

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

isShutdown

public boolean isShutdown()

isTerminated

public boolean isTerminated()

awaitTermination

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

Throws:

InterruptedException