MultithreadEventExecutorGroup (Netty API Reference (5.0.0.Alpha4))

Class MultithreadEventExecutorGroup

java.lang.Object
- io.netty5.util.concurrent.MultithreadEventExecutorGroup

All Implemented Interfaces:

EventExecutorGroup , Iterable<EventExecutor>, Executor

Direct Known Subclasses:

DefaultEventExecutorGroup , MultithreadEventLoopGroup
```
public class MultithreadEventExecutorGroup
extends Object
implements EventExecutorGroup 
```
EventExecutorGroup implementation that handles their tasks with multiple threads at the same time.

Constructor Summary

Constructors
Modifier	Constructor	Description
	`MultithreadEventExecutorGroup (int nThreads, Executor executor)`	Create a new instance.
	`MultithreadEventExecutorGroup (int nThreads, Executor executor, int maxPendingTasks, RejectedExecutionHandler rejectedHandler)`	Create a new instance.
`protected`	`MultithreadEventExecutorGroup (int nThreads, Executor executor, int maxPendingTasks, RejectedExecutionHandler rejectedHandler, Object... args)`	Create a new instance.
	`MultithreadEventExecutorGroup (int nThreads, ThreadFactory threadFactory)`	Create a new instance.
	`MultithreadEventExecutorGroup (int nThreads, ThreadFactory threadFactory, int maxPendingTasks, RejectedExecutionHandler rejectedHandler)`	Create a new instance.
`protected`	`MultithreadEventExecutorGroup (int nThreads, ThreadFactory threadFactory, int maxPendingTasks, RejectedExecutionHandler rejectedHandler, Object... args)`	Create a new instance.

Method Summary

All Methods
Modifier and Type	Method	Description
`boolean`	`awaitTermination (long timeout, TimeUnit unit)`	Wait for this `EventExecutorGroup` to terminate, up to the given timeout.
`int`	`executorCount ()`	Return the number of `EventExecutor` this implementation uses.
`protected List<EventExecutor>`	`executors ()`	The `EventExecutor`s that are used by this `MultithreadEventExecutorGroup`.
`boolean`	`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.
`boolean`	`isShuttingDown ()`	Returns `true` if and only if all `EventExecutor`s managed by this `EventExecutorGroup` are being shut down gracefully or was shut down.
`boolean`	`isTerminated ()`	Returns `true` if all `EventExecutor`s managed by this `EventExecutorGroup` are shut down, and all of their tasks have completed.
`Iterator<EventExecutor>`	`iterator ()`
`protected EventExecutor`	`newChild (Executor executor, int maxPendingTasks, RejectedExecutionHandler rejectedExecutionHandler, Object... args)`	Create a new EventExecutor which will later then accessible via the `next()` method.
`EventExecutor`	`next ()`	Returns the next `EventExecutor` to use.
`Future<Void>`	`shutdownGracefully (long quietPeriod, long timeout, TimeUnit unit)`	Signals this executor that the caller wants the executor to be shut down.
`Future<Void>`	`terminationFuture ()`	Returns the `Future` which is notified when all `EventExecutor`s managed by this `EventExecutorGroup` have been terminated.

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Methods inherited from interface io.netty5.util.concurrent.EventExecutorGroup
execute, schedule, schedule, scheduleAtFixedRate, scheduleWithFixedDelay, shutdownGracefully, submit, submit, submit

Methods inherited from interface java.lang.Iterable
forEach, spliterator

- Constructor Detail
  - MultithreadEventExecutorGroup
```
public MultithreadEventExecutorGroup(int nThreads,
 ThreadFactory threadFactory)
```
    Create a new instance.
    
    Parameters:
    
    nThreads - the number of threads that will be used by this instance.
    
    threadFactory - the ThreadFactory to use, or null if the default should be used.
  - MultithreadEventExecutorGroup
```
public MultithreadEventExecutorGroup(int nThreads,
 Executor executor)
```
    Create a new instance.
    
    Parameters:
    
    nThreads - the number of threads that will be used by this instance.
    
    executor - the Executor to use, or null if the default should be used.
  - MultithreadEventExecutorGroup
```
public MultithreadEventExecutorGroup(int nThreads,
 ThreadFactory threadFactory,
 int maxPendingTasks,
 RejectedExecutionHandler rejectedHandler)
```
    Create a new instance.
    
    Parameters:
    
    nThreads - the number of threads that will be used by this instance.
    
    threadFactory - the ThreadFactory to use, or null if the default should be used.
    
    maxPendingTasks - the maximum number of pending tasks before new tasks will be rejected.
    
    rejectedHandler - the RejectedExecutionHandler to use.
  - MultithreadEventExecutorGroup
```
public MultithreadEventExecutorGroup(int nThreads,
 Executor executor,
 int maxPendingTasks,
 RejectedExecutionHandler rejectedHandler)
```
    Create a new instance.
    
    Parameters:
    
    nThreads - the number of threads that will be used by this instance.
    
    executor - the Executor to use, or null if the default should be used.
    
    maxPendingTasks - the maximum number of pending tasks before new tasks will be rejected.
    
    rejectedHandler - the RejectedExecutionHandler to use.
  - MultithreadEventExecutorGroup
```
protected MultithreadEventExecutorGroup(int nThreads,
 ThreadFactory threadFactory,
 int maxPendingTasks,
 RejectedExecutionHandler rejectedHandler,
 Object... args)
```
    Create a new instance.
    
    Parameters:
    
    nThreads - the number of threads that will be used by this instance.
    
    threadFactory - the ThreadFactory to use, or null if the default should be used.
    
    maxPendingTasks - the maximum number of pending tasks before new tasks will be rejected.
    
    rejectedHandler - the RejectedExecutionHandler to use.
    
    args - arguments which will passed to each newChild(Executor, int, RejectedExecutionHandler, Object...) call
  - MultithreadEventExecutorGroup
```
protected MultithreadEventExecutorGroup(int nThreads,
 Executor executor,
 int maxPendingTasks,
 RejectedExecutionHandler rejectedHandler,
 Object... args)
```
    Create a new instance.
    
    Parameters:
    
    nThreads - the number of threads that will be used by this instance.
    
    executor - the Executor to use, or null if the default should be used.
    
    maxPendingTasks - the maximum number of pending tasks before new tasks will be rejected.
    
    rejectedHandler - the RejectedExecutionHandler to use.
    
    args - arguments which will passed to each newChild(Executor, int, RejectedExecutionHandler, Object...) call
- Method Detail
  - executors
```
protected final List<EventExecutor> executors()
```
    The EventExecutors that are used by this MultithreadEventExecutorGroup.
  - next
```
public EventExecutor next()
```
    Returns the next EventExecutor to use. The default implementation will use round-robin, but you may override this to change the selection algorithm.
    
    Specified by:
    
    next in interface EventExecutorGroup
  - iterator
```
public Iterator<EventExecutor> iterator()
```
    Specified by:
    
    iterator in interface EventExecutorGroup
    
    Specified by:
    
    iterator in interface Iterable<EventExecutor>
  - 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.
  - newChild
```
protected EventExecutor newChild(Executor executor,
 int maxPendingTasks,
 RejectedExecutionHandler rejectedExecutionHandler,
 Object... args)
```
    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. As this method is called from within the constructor you can only use the parameters passed into the method when overriding this method.
  - shutdownGracefully
```
public final Future<Void> 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. 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.
    
    Specified by:
    
    shutdownGracefully in interface EventExecutorGroup
    
    Parameters:
    
    quietPeriod - the quiet period as described in the documentation
    
    timeout - the maximum amount of time to wait until the executor is shutting down regardless if a task was submitted during the quiet period.
    
    unit - the unit of quietPeriod and timeout
    
    Returns:
    
    the EventExecutorGroup.terminationFuture()
  - terminationFuture
```
public final Future<Void> terminationFuture()
```
    Description copied from interface: EventExecutorGroup
    
    Returns the Future which is notified when all EventExecutors managed by this EventExecutorGroup have been terminated.
    
    Specified by:
    
    terminationFuture in interface EventExecutorGroup
    
    Returns:
    
    The Future representing the termination of this EventExecutorGroup.
  - isShuttingDown
```
public final boolean isShuttingDown()
```
    Description copied from interface: EventExecutorGroup
    
    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.
    
    Specified by:
    
    isShuttingDown in interface EventExecutorGroup
    
    Returns:
    
    true if all executors in this group have at least started shutting down, otherwise false.
  - isShutdown
```
public final boolean isShutdown()
```
    Description copied from interface: EventExecutorGroup
    
    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.
    
    Specified by:
    
    isShutdown in interface EventExecutorGroup
    
    Returns:
    
    true if all executors in this group have shut down and are no longer accepting any new tasks.
  - isTerminated
```
public final boolean isTerminated()
```
    Description copied from interface: EventExecutorGroup
    
    Returns true if all EventExecutors managed by this EventExecutorGroup are shut down, and all of their tasks have completed.
    
    Specified by:
    
    isTerminated in interface EventExecutorGroup
    
    Returns:
    
    true if all executors in this group have terminated.
  - awaitTermination
```
public final boolean awaitTermination(long timeout,
 TimeUnit unit)
 throws InterruptedException 
```
    Description copied from interface: EventExecutorGroup
    
    Wait for this EventExecutorGroup to terminate, up to the given timeout.
    
    Specified by:
    
    awaitTermination in interface EventExecutorGroup
    
    Parameters:
    
    timeout - The non-negative maximum amount of time to wait for the executor group to terminate.
    
    unit - The non-null time unit of the timeout.
    
    Returns:
    
    true if the executor group terminated within the specific timeout.
    
    Throws:
    
    InterruptedException - If this thread was interrupted while waiting for executor group to terminate.

Class MultithreadEventExecutorGroup

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Methods inherited from interface io.netty5.util.concurrent.EventExecutorGroup

Methods inherited from interface java.lang.Iterable

Constructor Detail

MultithreadEventExecutorGroup

MultithreadEventExecutorGroup

MultithreadEventExecutorGroup

MultithreadEventExecutorGroup

MultithreadEventExecutorGroup

MultithreadEventExecutorGroup

Method Detail

executors

next

iterator

executorCount

newChild

shutdownGracefully

terminationFuture

isShuttingDown

isShutdown

isTerminated

awaitTermination