Class EmbeddedEventLoop

java.lang.Object

java.util.concurrent.AbstractExecutorService

io.netty.util.concurrent.AbstractEventExecutor

io.netty.util.concurrent.AbstractScheduledEventExecutor

io.netty.channel.embedded.EmbeddedEventLoop

All Implemented Interfaces:

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

final class EmbeddedEventLoop
extends AbstractScheduledEventExecutor
implements EventLoop

Nested Class Summary

Nested classes/interfaces inherited from class AbstractEventExecutor

AbstractEventExecutor.LazyRunnable

Field Summary

Fields

Modifier and Type	Field	Description
private long	frozenTimestamp	When time is frozen, the timestamp returned by getCurrentTimeNanos().
private long	startTime	When time is not frozen, the base time to subtract from System.nanoTime().
private final Queue<Runnable>	tasks
private boolean	timeFrozen	Whether time is currently frozen.

Constructor Summary

Constructors

Constructor	Description
EmbeddedEventLoop()

Method Summary

Modifier and Type	Method	Description
(package private) void	advanceTimeBy(long nanos)
boolean	awaitTermination(long timeout, TimeUnit unit)
protected void	cancelScheduledTasks()	Cancel all scheduled tasks.
void	execute(Runnable command)
(package private) void	freezeTime()
protected long	getCurrentTimeNanos()	Get the current time in nanoseconds by this executor's clock.
(package private) boolean	hasPendingNormalTasks()
boolean	inEventLoop()	Calls EventExecutor.inEventLoop(Thread) with Thread.currentThread() as argument
boolean	inEventLoop(Thread thread)	Return true if the given Thread is executed in the event loop, false otherwise.
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()
EventLoop	next()	Returns a reference to itself.
(package private) long	nextScheduledTask()
EventLoopGroup	parent()	Return the EventExecutorGroup which is the parent of this EventExecutor,
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.
(package private) long	runScheduledTasks()
(package private) void	runTasks()
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.
(package private) void	unfreezeTime()

Methods inherited from class AbstractScheduledEventExecutor

afterScheduledTaskSubmitted, beforeScheduledTaskSubmitted, deadlineToDelayNanos, hasScheduledTasks, initialNanoTime, nanoTime, nextScheduledTaskDeadlineNanos, nextScheduledTaskNano, pollScheduledTask, pollScheduledTask, schedule, schedule, scheduleAtFixedRate, scheduleWithFixedDelay, validateScheduled

Methods inherited from class AbstractEventExecutor

iterator, lazyExecute, newFailedFuture, newProgressivePromise, newPromise, newSucceededFuture, newTaskFor, newTaskFor, runTask, safeExecute, shutdownGracefully, shutdownNow, submit, submit, submit

Methods inherited from class AbstractExecutorService

invokeAll, invokeAll, invokeAny, invokeAny

Methods inherited from class Object

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

Methods inherited from interface EventExecutor

newFailedFuture, newProgressivePromise, newPromise, newSucceededFuture

Methods inherited from interface EventExecutorGroup

iterator, schedule, schedule, scheduleAtFixedRate, scheduleWithFixedDelay, shutdownGracefully, shutdownNow, submit, submit, submit

Methods inherited from interface ExecutorService

invokeAll, invokeAll, invokeAny, invokeAny

Methods inherited from interface Iterable

forEach, spliterator

Field Details

startTime

private long startTime

When time is not frozen, the base time to subtract from System.nanoTime(). When time is frozen, this variable is unused. Initialized to AbstractScheduledEventExecutor.initialNanoTime() so that until one of the time mutator methods is called, getCurrentTimeNanos() matches the default behavior.

frozenTimestamp

private long frozenTimestamp

When time is frozen, the timestamp returned by getCurrentTimeNanos(). When unfrozen, this is unused.

timeFrozen

private boolean timeFrozen

Whether time is currently frozen.

tasks

private final Queue<Runnable> tasks

Constructor Details

EmbeddedEventLoop

EmbeddedEventLoop()

Method Details

parent

public EventLoopGroup parent()

Description copied from interface: EventExecutor

Return the EventExecutorGroup which is the parent of this EventExecutor,

Specified by:

parent in interface EventExecutor

Specified by:

parent in interface EventLoop

Overrides:

parent in class AbstractEventExecutor

next

public EventLoop next()

Description copied from interface: EventExecutor

Returns a reference to itself.

Specified by:

next in interface EventExecutor

Specified by:

next in interface EventExecutorGroup

Specified by:

next in interface EventLoopGroup

Overrides:

next in class AbstractEventExecutor

execute

public void execute(Runnable command)

Specified by:

execute in interface Executor

runTasks

void runTasks()

hasPendingNormalTasks

boolean hasPendingNormalTasks()

runScheduledTasks

long runScheduledTasks()

nextScheduledTask

long nextScheduledTask()

getCurrentTimeNanos

protected long getCurrentTimeNanos()

Description copied from class: AbstractScheduledEventExecutor

Get the current time in nanoseconds by this executor's clock. This is not the same as System.nanoTime() for two reasons:

• We apply a fixed offset to the nanoTime
• Implementations (in particular EmbeddedEventLoop) may use their own time source so they can control time for testing purposes.

Overrides:

getCurrentTimeNanos in class AbstractScheduledEventExecutor

advanceTimeBy

void advanceTimeBy(long nanos)

freezeTime

void freezeTime()

unfreezeTime

void unfreezeTime()

cancelScheduledTasks

protected void cancelScheduledTasks()

Description copied from class: AbstractScheduledEventExecutor

Cancel all scheduled tasks. This method MUST be called only when AbstractEventExecutor.inEventLoop() is true.

Overrides:

cancelScheduledTasks in class AbstractScheduledEventExecutor

shutdownGracefully

public Future<?> shutdownGracefully(long quietPeriod,
 long timeout,
 TimeUnit unit)

Description copied from interface: EventExecutorGroup

Signals this executor that the caller wants the executor to be shut down. Once this method is called, EventExecutorGroup.isShuttingDown() starts to return true, and the executor prepares to shut itself down. Unlike EventExecutorGroup.shutdown(), graceful shutdown ensures that no tasks are submitted for 'the quiet period' (usually a couple seconds) before it shuts itself down. If a task is submitted during the quiet period, it is guaranteed to be accepted and the quiet period will start over.

Specified by:

shutdownGracefully in interface EventExecutorGroup

Parameters:

quietPeriod - the quiet period as described in the documentation

timeout - the maximum amount of time to wait until the executor is EventExecutorGroup.shutdown() regardless if a task was submitted during the quiet period

unit - the unit of quietPeriod and timeout

Returns:

the EventExecutorGroup.terminationFuture()

terminationFuture

public Future<?> terminationFuture()

Description copied from interface: EventExecutorGroup

Returns the Future which is notified when all EventExecutors managed by this EventExecutorGroup have been terminated.

Specified by:

terminationFuture in interface EventExecutorGroup

shutdown

@Deprecated
public void shutdown()

Deprecated.

Specified by:

shutdown in interface EventExecutorGroup

Specified by:

shutdown in interface ExecutorService

Specified by:

shutdown in class AbstractEventExecutor

isShuttingDown

public boolean isShuttingDown()

Description copied from interface: EventExecutorGroup

Returns true if and only if all EventExecutors managed by this EventExecutorGroup are being shut down gracefully or was shut down.

Specified by:

isShuttingDown in interface EventExecutorGroup

isShutdown

public boolean isShutdown()

Specified by:

isShutdown in interface ExecutorService

isTerminated

public boolean isTerminated()

Specified by:

isTerminated in interface ExecutorService

awaitTermination

public boolean awaitTermination(long timeout,
 TimeUnit unit)

Specified by:

awaitTermination in interface ExecutorService

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

inEventLoop

public boolean inEventLoop()

Description copied from interface: EventExecutor

Calls EventExecutor.inEventLoop(Thread) with Thread.currentThread() as argument

Specified by:

inEventLoop in interface EventExecutor

Overrides:

inEventLoop in class AbstractEventExecutor

inEventLoop

public boolean inEventLoop(Thread thread)

Description copied from interface: EventExecutor

Return true if the given Thread is executed in the event loop, false otherwise.

Specified by:

inEventLoop in interface EventExecutor