io.netty.channel

Interface EventLoopGroup

All Superinterfaces:

AutoCloseable, EventExecutorGroup, Executor, ExecutorService, ScheduledExecutorService

All Known Subinterfaces:

EventLoop

All Known Implementing Classes:

AbstractEventLoop, AbstractEventLoopGroup, DefaultEventLoop, DefaultEventLoopGroup, EpollEventLoopGroup, MultithreadEventLoopGroup, NioEventLoop, NioEventLoopGroup, OioEventLoopGroup, SingleThreadEventLoop, ThreadPerChannelEventLoop, ThreadPerChannelEventLoopGroup

public interface EventLoopGroup
extends EventExecutorGroup

Special EventExecutorGroup which allows registering Channels that get processed for later selection during the event loop.

Method Summary

Methods

Modifier and Type	Method and Description
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 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

Method Detail

next

EventLoop next()

Description copied from interface: EventExecutorGroup

Returns one of the EventExecutors managed by this EventExecutorGroup.

Specified by:

next in interface EventExecutorGroup

register

ChannelFuture register(Channel channel)

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.

register

ChannelFuture register(Channel channel,
                     ChannelPromise promise)

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.