io.netty.channel.nio

Class NioEventLoopGroup

java.lang.Object

io.netty.util.concurrent.AbstractEventExecutorGroup

io.netty.util.concurrent.MultithreadEventExecutorGroup

io.netty.channel.MultithreadEventLoopGroup

io.netty.channel.nio.NioEventLoopGroup

All Implemented Interfaces:

EventLoopGroup, EventExecutorGroup, Iterable<EventExecutor>, Executor, ExecutorService, ScheduledExecutorService

public class NioEventLoopGroup
extends MultithreadEventLoopGroup

MultithreadEventLoopGroup implementations which is used for NIO Selector based Channels.

Constructor Summary

Constructors

Constructor and Description
NioEventLoopGroup() Create a new instance using the default number of threads, the default ThreadFactory and the SelectorProvider which is returned by SelectorProvider.provider().
NioEventLoopGroup(int nThreads) Create a new instance using the specified number of threads, ThreadFactory and the SelectorProvider which is returned by SelectorProvider.provider().
NioEventLoopGroup(int nThreads, Executor executor)
NioEventLoopGroup(int nThreads, Executor executor, EventExecutorChooserFactory chooserFactory, SelectorProvider selectorProvider, SelectStrategyFactory selectStrategyFactory)
NioEventLoopGroup(int nThreads, Executor executor, EventExecutorChooserFactory chooserFactory, SelectorProvider selectorProvider, SelectStrategyFactory selectStrategyFactory, RejectedExecutionHandler rejectedExecutionHandler)
NioEventLoopGroup(int nThreads, Executor executor, EventExecutorChooserFactory chooserFactory, SelectorProvider selectorProvider, SelectStrategyFactory selectStrategyFactory, RejectedExecutionHandler rejectedExecutionHandler, EventLoopTaskQueueFactory taskQueueFactory)
NioEventLoopGroup(int nThreads, Executor executor, EventExecutorChooserFactory chooserFactory, SelectorProvider selectorProvider, SelectStrategyFactory selectStrategyFactory, RejectedExecutionHandler rejectedExecutionHandler, EventLoopTaskQueueFactory taskQueueFactory, EventLoopTaskQueueFactory tailTaskQueueFactory)
NioEventLoopGroup(int nThreads, Executor executor, SelectorProvider selectorProvider)
NioEventLoopGroup(int nThreads, Executor executor, SelectorProvider selectorProvider, SelectStrategyFactory selectStrategyFactory)
NioEventLoopGroup(int nThreads, ThreadFactory threadFactory) Create a new instance using the specified number of threads, the given ThreadFactory and the SelectorProvider which is returned by SelectorProvider.provider().
NioEventLoopGroup(int nThreads, ThreadFactory threadFactory, SelectorProvider selectorProvider) Create a new instance using the specified number of threads, the given ThreadFactory and the given SelectorProvider.
NioEventLoopGroup(int nThreads, ThreadFactory threadFactory, SelectorProvider selectorProvider, SelectStrategyFactory selectStrategyFactory)
NioEventLoopGroup(ThreadFactory threadFactory) Create a new instance using the default number of threads, the given ThreadFactory and the SelectorProvider which is returned by SelectorProvider.provider().

Method Summary

Modifier and Type	Method and Description
protected EventLoop	newChild(Executor executor, Object... args) Create a new EventExecutor which will later then accessible via the MultithreadEventExecutorGroup.next() method.
void	rebuildSelectors() Replaces the current Selectors of the child event loops with newly created Selectors to work around the infamous epoll 100% CPU bug.
void	setIoRatio(int ioRatio) Sets the percentage of the desired amount of time spent for I/O in the child event loops.

Methods inherited from class io.netty.channel.MultithreadEventLoopGroup

newDefaultThreadFactory, next, register, register, register

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

awaitTermination, executorCount, isShutdown, isShuttingDown, isTerminated, iterator, shutdown, shutdownGracefully, terminationFuture

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

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

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

isShuttingDown, iterator, schedule, schedule, scheduleAtFixedRate, scheduleWithFixedDelay, shutdown, shutdownGracefully, shutdownGracefully, shutdownNow, submit, submit, submit, terminationFuture

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

Constructor Detail

NioEventLoopGroup

public NioEventLoopGroup()

Create a new instance using the default number of threads, the default ThreadFactory and the SelectorProvider which is returned by SelectorProvider.provider().

NioEventLoopGroup

public NioEventLoopGroup(int nThreads)

Create a new instance using the specified number of threads, ThreadFactory and the SelectorProvider which is returned by SelectorProvider.provider().

NioEventLoopGroup

public NioEventLoopGroup(ThreadFactory threadFactory)

Create a new instance using the default number of threads, the given ThreadFactory and the SelectorProvider which is returned by SelectorProvider.provider().

NioEventLoopGroup

public NioEventLoopGroup(int nThreads,
                         ThreadFactory threadFactory)

Create a new instance using the specified number of threads, the given ThreadFactory and the SelectorProvider which is returned by SelectorProvider.provider().

NioEventLoopGroup

public NioEventLoopGroup(int nThreads,
                         Executor executor)

NioEventLoopGroup

public NioEventLoopGroup(int nThreads,
                         ThreadFactory threadFactory,
                         SelectorProvider selectorProvider)

Create a new instance using the specified number of threads, the given ThreadFactory and the given SelectorProvider.

NioEventLoopGroup

public NioEventLoopGroup(int nThreads,
                         ThreadFactory threadFactory,
                         SelectorProvider selectorProvider,
                         SelectStrategyFactory selectStrategyFactory)

NioEventLoopGroup

public NioEventLoopGroup(int nThreads,
                         Executor executor,
                         SelectorProvider selectorProvider)

NioEventLoopGroup

public NioEventLoopGroup(int nThreads,
                         Executor executor,
                         SelectorProvider selectorProvider,
                         SelectStrategyFactory selectStrategyFactory)

NioEventLoopGroup

public NioEventLoopGroup(int nThreads,
                         Executor executor,
                         EventExecutorChooserFactory chooserFactory,
                         SelectorProvider selectorProvider,
                         SelectStrategyFactory selectStrategyFactory)

NioEventLoopGroup

public NioEventLoopGroup(int nThreads,
                         Executor executor,
                         EventExecutorChooserFactory chooserFactory,
                         SelectorProvider selectorProvider,
                         SelectStrategyFactory selectStrategyFactory,
                         RejectedExecutionHandler rejectedExecutionHandler)

NioEventLoopGroup

public NioEventLoopGroup(int nThreads,
                         Executor executor,
                         EventExecutorChooserFactory chooserFactory,
                         SelectorProvider selectorProvider,
                         SelectStrategyFactory selectStrategyFactory,
                         RejectedExecutionHandler rejectedExecutionHandler,
                         EventLoopTaskQueueFactory taskQueueFactory)

NioEventLoopGroup

public NioEventLoopGroup(int nThreads,
                         Executor executor,
                         EventExecutorChooserFactory chooserFactory,
                         SelectorProvider selectorProvider,
                         SelectStrategyFactory selectStrategyFactory,
                         RejectedExecutionHandler rejectedExecutionHandler,
                         EventLoopTaskQueueFactory taskQueueFactory,
                         EventLoopTaskQueueFactory tailTaskQueueFactory)

Parameters:

nThreads - the number of threads that will be used by this instance.

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

chooserFactory - the EventExecutorChooserFactory to use.

selectorProvider - the SelectorProvider to use.

selectStrategyFactory - the SelectStrategyFactory to use.

rejectedExecutionHandler - the RejectedExecutionHandler to use.

taskQueueFactory - the EventLoopTaskQueueFactory to use for SingleThreadEventExecutor.execute(Runnable), or null if default one should be used.

tailTaskQueueFactory - the EventLoopTaskQueueFactory to use for SingleThreadEventLoop.executeAfterEventLoopIteration(Runnable), or null if default one should be used.

Method Detail

setIoRatio

public void setIoRatio(int ioRatio)

Sets the percentage of the desired amount of time spent for I/O in the child event loops. The default value is 50, which means the event loop will try to spend the same amount of time for I/O as for non-I/O tasks.

rebuildSelectors

public void rebuildSelectors()

Replaces the current Selectors of the child event loops with newly created Selectors to work around the infamous epoll 100% CPU bug.

newChild

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

Description copied from class: MultithreadEventExecutorGroup

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

Specified by:

newChild in class MultithreadEventLoopGroup

Throws:

Exception