Class MultithreadEventLoopGroup

java.lang.Object

io.netty.util.concurrent.AbstractEventExecutorGroup

io.netty.util.concurrent.MultithreadEventExecutorGroup

io.netty.channel.MultithreadEventLoopGroup

All Implemented Interfaces:

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

Direct Known Subclasses:

DefaultEventLoopGroup, MultiThreadIoEventLoopGroup

public abstract class MultithreadEventLoopGroup
extends MultithreadEventExecutorGroup
implements EventLoopGroup

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

Constructor Summary

Constructors

Modifier	Constructor	Description
protected	MultithreadEventLoopGroup(int nThreads, Executor executor, EventExecutorChooserFactory chooserFactory, Object... args)
protected	MultithreadEventLoopGroup(int nThreads, Executor executor, Object... args)
protected	MultithreadEventLoopGroup(int nThreads, ThreadFactory threadFactory, Object... args)

Method Summary

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

Methods inherited from class MultithreadEventExecutorGroup

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

Modifier and Type	Method	Description
int	activeExecutorCount()	Returns the number of currently active threads if the group is using an EventExecutorChooserFactory.ObservableEventExecutorChooser.
boolean	awaitTermination(long timeout, TimeUnit unit)
final int	executorCount()	Return the number of EventExecutor this implementation uses.
List<AutoScalingEventExecutorChooserFactory.AutoScalingUtilizationMetric>	executorUtilizations()	Returns a list of real-time utilization metrics if the group was configured with a compatible EventExecutorChooserFactory, otherwise an empty list.
boolean	isShutdown()
boolean	isShuttingDown()	Returns true if and only if all EventExecutors managed by this EventExecutorGroup are being shut down gracefully or was shut down.
boolean	isTerminated()
Iterator<EventExecutor>	iterator()
void	shutdown()	Deprecated.
Future<?>	shutdownGracefully(long quietPeriod, long timeout, TimeUnit unit)	Signals this executor that the caller wants the executor to be shut down.
Future<?>	terminationFuture()	Returns the Future which is notified when all EventExecutors managed by this EventExecutorGroup have been terminated.

Methods inherited from class AbstractEventExecutorGroup

execute, invokeAll, invokeAll, invokeAny, invokeAny, schedule, schedule, scheduleAtFixedRate, scheduleWithFixedDelay, shutdownGracefully, shutdownNow, submit, submit, submit

Modifier and Type	Method	Description
void	execute(Runnable command)
<T> List<Future<T>>	invokeAll(Collection<? extends Callable<T>> tasks)
<T> List<Future<T>>	invokeAll(Collection<? extends Callable<T>> tasks, long timeout, TimeUnit unit)
<T> T	invokeAny(Collection<? extends Callable<T>> tasks)
<T> T	invokeAny(Collection<? extends Callable<T>> tasks, long timeout, TimeUnit unit)
ScheduledFuture<?>	schedule(Runnable command, long delay, TimeUnit unit)
<V> ScheduledFuture<V>	schedule(Callable<V> callable, long delay, TimeUnit unit)
ScheduledFuture<?>	scheduleAtFixedRate(Runnable command, long initialDelay, long period, TimeUnit unit)
ScheduledFuture<?>	scheduleWithFixedDelay(Runnable command, long initialDelay, long delay, TimeUnit unit)
Future<?>	shutdownGracefully()	Shortcut method for EventExecutorGroup.shutdownGracefully(long, long, TimeUnit) with sensible default values.
List<Runnable>	shutdownNow()	Deprecated. EventExecutorGroup.shutdownGracefully(long, long, TimeUnit) or AbstractEventExecutorGroup.shutdownGracefully() instead.
Future<?>	submit(Runnable task)
<T> Future<T>	submit(Runnable task, T result)
<T> Future<T>	submit(Callable<T> task)

Methods inherited from class Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Methods inherited from interface EventExecutorGroup

ticker

Modifier and Type	Method	Description
default Ticker	ticker()	The ticker for this executor.

Methods inherited from interface Iterable

forEach, spliterator

Constructor Details

MultithreadEventLoopGroup

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

See Also:

• MultithreadEventExecutorGroup(int, Executor, Object...)

MultithreadEventLoopGroup

protected MultithreadEventLoopGroup(int nThreads,
 ThreadFactory threadFactory,
 Object... args)

See Also:

• MultithreadEventExecutorGroup(int, ThreadFactory, Object...)

MultithreadEventLoopGroup

protected MultithreadEventLoopGroup(int nThreads,
 Executor executor,
 EventExecutorChooserFactory chooserFactory,
 Object... args)

See Also:

• MultithreadEventExecutorGroup(int, Executor, EventExecutorChooserFactory, Object...)

Method Details

newDefaultThreadFactory

protected ThreadFactory newDefaultThreadFactory()

Overrides:

newDefaultThreadFactory in class MultithreadEventExecutorGroup

next

public EventLoop next()

Description copied from interface: EventExecutorGroup

Returns one of the EventExecutors managed by this EventExecutorGroup.

Specified by:

next in interface EventExecutorGroup

Specified by:

next in interface EventLoopGroup

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 this EventLoop. The returned ChannelFuture will get notified once the registration was complete.

Specified by:

register in interface EventLoopGroup

register

public ChannelFuture register(ChannelPromise promise)

Description copied from interface: EventLoopGroup

Register a Channel with this EventLoop using a ChannelFuture. The passed ChannelFuture will get notified once the registration was complete and also will get returned.

Specified by:

register in interface EventLoopGroup

register

@Deprecated
public ChannelFuture register(Channel channel,
 ChannelPromise promise)

Deprecated.

Description copied from interface: EventLoopGroup

Register a Channel with this EventLoop. The passed ChannelFuture will get notified once the registration was complete and also will get returned.

Specified by:

register in interface EventLoopGroup