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, AutoCloseable, Executor, ExecutorService, ScheduledExecutorService

public class NioEventLoopGroup
extends MultithreadEventLoopGroup

A MultithreadEventLoopGroup implementation which is used for NIO Selector based Channels.

Constructor Summary

Constructors

Constructor and Description
NioEventLoopGroup() Create a new instance that uses twice as many EventLoops as there processors/cores available, as well as the default Executor and the SelectorProvider which is returned by SelectorProvider.provider().
NioEventLoopGroup(int nEventLoops) Create a new instance that uses the default Executor and the SelectorProvider which is returned by SelectorProvider.provider().
NioEventLoopGroup(int nEventLoops, Executor executor) Create a new instance that uses the the SelectorProvider which is returned by SelectorProvider.provider().
NioEventLoopGroup(int nEventLoops, Executor executor, SelectorProvider selectorProvider)
NioEventLoopGroup(int nEventLoops, ExecutorServiceFactory executorServiceFactory) Create a new instance that uses the the SelectorProvider which is returned by SelectorProvider.provider().
NioEventLoopGroup(int nEventLoops, ExecutorServiceFactory executorServiceFactory, SelectorProvider selectorProvider)

Method Summary

Methods

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

next, register, register

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

awaitTermination, children, executorCount, isShutdown, isShuttingDown, isTerminated, newDefaultExecutorService, shutdown, shutdownGracefully, terminationFuture

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

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

children, isShuttingDown, 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.AutoCloseable

close

Constructor Detail

NioEventLoopGroup

public NioEventLoopGroup()

Create a new instance that uses twice as many EventLoops as there processors/cores available, as well as the default Executor and the SelectorProvider which is returned by SelectorProvider.provider().

See Also:

DefaultExecutorServiceFactory

NioEventLoopGroup

public NioEventLoopGroup(int nEventLoops)

Create a new instance that uses the default Executor and the SelectorProvider which is returned by SelectorProvider.provider().

Parameters:

nEventLoops - the number of EventLoops 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 EventLoops and the number of Threads used by the

See Also:

DefaultExecutorServiceFactory

NioEventLoopGroup

public NioEventLoopGroup(int nEventLoops,
                 Executor executor)

Create a new instance that uses the the SelectorProvider which is returned by SelectorProvider.provider().

Parameters:

nEventLoops - the number of EventLoops 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 EventLoops 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.

NioEventLoopGroup

public NioEventLoopGroup(int nEventLoops,
                 ExecutorServiceFactory executorServiceFactory)

Create a new instance that uses the the SelectorProvider which is returned by SelectorProvider.provider().

Parameters:

nEventLoops - the number of EventLoops 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 EventLoops 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.

NioEventLoopGroup

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

Parameters:

nEventLoops - the number of EventLoops 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 EventLoops 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.

selectorProvider - the SelectorProvider to use. This value must not be null.

NioEventLoopGroup

public NioEventLoopGroup(int nEventLoops,
                 ExecutorServiceFactory executorServiceFactory,
                 SelectorProvider selectorProvider)

Parameters:

nEventLoops - the number of EventLoops 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 EventLoops 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.

selectorProvider - the SelectorProvider to use. This value must not be null.

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