io.netty.channel

Class MultithreadEventLoopGroup

java.lang.Object

io.netty.util.concurrent.AbstractEventExecutorGroup

io.netty.util.concurrent.MultithreadEventExecutorGroup

io.netty.channel.MultithreadEventLoopGroup

All Implemented Interfaces:

EventLoopGroup, EventExecutorGroup, AutoCloseable, Executor, ExecutorService, ScheduledExecutorService

Direct Known Subclasses:

DefaultEventLoopGroup, EpollEventLoopGroup, NioEventLoopGroup

public abstract class MultithreadEventLoopGroup
extends MultithreadEventExecutorGroup
implements EventLoopGroup

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

Constructor Summary

Constructors

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

Method Summary

Methods

Modifier and Type	Method and Description
protected abstract EventLoop	newChild(Executor executor, Object... args) Create a new EventExecutor which will later then accessible via the MultithreadEventExecutorGroup.next() method.
EventLoop	next() Returns one of the EventExecutors managed by this EventExecutorGroup.
ChannelFuture	register(Channel channel) Register a Channel with an EventLoop from this EventLoopGroup.
ChannelFuture	register(Channel channel, ChannelPromise promise) Register a Channel with an EventLoop from this EventLoopGroup.

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

MultithreadEventLoopGroup

protected MultithreadEventLoopGroup(int nEventLoops,
                         Executor executor,
                         Object... args)

See Also:

MultithreadEventExecutorGroup#MultithreadEventExecutorGroup(int, Executor, Object...)}

MultithreadEventLoopGroup

protected MultithreadEventLoopGroup(int nEventLoops,
                         ExecutorServiceFactory executorServiceFactory,
                         Object... args)

See Also:

MultithreadEventExecutorGroup#MultithreadEventExecutorGroup(int, ExecutorServiceFactory, Object...)}

Method Detail

next

public EventLoop next()

Description copied from interface: EventExecutorGroup

Returns one of the EventExecutors managed by this EventExecutorGroup.

Specified by:

next in interface EventLoopGroup

Specified by:

next in interface EventExecutorGroup

Overrides:

next in class MultithreadEventExecutorGroup

newChild

protected abstract 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 MultithreadEventExecutorGroup

Throws:

Exception

register

public ChannelFuture register(Channel channel)

Description copied from interface: EventLoopGroup

Register a Channel with an EventLoop from this EventLoopGroup. The returned ChannelFuture will get notified once the registration is completed.

It's only safe to submit a new task to the EventLoop from within a ChannelHandler once the ChannelPromise succeeded. Otherwise the task may or may not be rejected.

Specified by:

register in interface EventLoopGroup

register

public ChannelFuture register(Channel channel,
                     ChannelPromise promise)

Description copied from interface: EventLoopGroup

Register a Channel with an EventLoop from this EventLoopGroup. The provided ChannelPromise will get notified once the registration is completed. The returned ChannelFuture is the same ChannelPromise that was passed to the method.

It's only safe to submit a new task to the EventLoop from within a ChannelHandler once the ChannelPromise succeeded. Otherwise the task may or may not be rejected.

Specified by:

register in interface EventLoopGroup