Class SingleThreadEventLoop

java.lang.Object

java.util.concurrent.AbstractExecutorService

io.netty.util.concurrent.AbstractEventExecutor

io.netty.util.concurrent.AbstractScheduledEventExecutor

io.netty.util.concurrent.SingleThreadEventExecutor

io.netty.channel.SingleThreadEventLoop

All Implemented Interfaces:

EventLoop, EventLoopGroup, EventExecutor, EventExecutorGroup, OrderedEventExecutor, ThreadAwareExecutor, java.lang.Iterable<EventExecutor>, java.util.concurrent.Executor, java.util.concurrent.ExecutorService, java.util.concurrent.ScheduledExecutorService

Direct Known Subclasses:

DefaultEventLoop, SingleThreadIoEventLoop, ThreadPerChannelEventLoop

public abstract class SingleThreadEventLoop
extends SingleThreadEventExecutor
implements EventLoop

Abstract base class for EventLoops that execute all its submitted tasks in a single thread.

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
protected static final class	SingleThreadEventLoop.ChannelsReadOnlyIterator<T extends Channel>

Nested classes/interfaces inherited from class SingleThreadEventExecutor

SingleThreadEventExecutor.NonWakeupRunnable

Nested classes/interfaces inherited from class AbstractEventExecutor

AbstractEventExecutor.LazyRunnable

Field Summary

Fields

Modifier and Type	Field	Description
protected static final int	DEFAULT_MAX_PENDING_TASKS
private final java.util.Queue<java.lang.Runnable>	tailTasks

Constructor Summary

Constructors

Modifier	Constructor	Description
protected	SingleThreadEventLoop(EventLoopGroup parent, java.util.concurrent.Executor executor, boolean addTaskWakesUp)
protected	SingleThreadEventLoop(EventLoopGroup parent, java.util.concurrent.Executor executor, boolean addTaskWakesUp, boolean supportSuspension)
protected	SingleThreadEventLoop(EventLoopGroup parent, java.util.concurrent.Executor executor, boolean addTaskWakesUp, boolean supportSuspension, int maxPendingTasks, RejectedExecutionHandler rejectedExecutionHandler)
protected	SingleThreadEventLoop(EventLoopGroup parent, java.util.concurrent.Executor executor, boolean addTaskWakesUp, boolean supportSuspension, java.util.Queue<java.lang.Runnable> taskQueue, java.util.Queue<java.lang.Runnable> tailTaskQueue, RejectedExecutionHandler rejectedExecutionHandler)
protected	SingleThreadEventLoop(EventLoopGroup parent, java.util.concurrent.Executor executor, boolean addTaskWakesUp, int maxPendingTasks, RejectedExecutionHandler rejectedExecutionHandler)
protected	SingleThreadEventLoop(EventLoopGroup parent, java.util.concurrent.Executor executor, boolean addTaskWakesUp, java.util.Queue<java.lang.Runnable> taskQueue, java.util.Queue<java.lang.Runnable> tailTaskQueue, RejectedExecutionHandler rejectedExecutionHandler)
protected	SingleThreadEventLoop(EventLoopGroup parent, java.util.concurrent.ThreadFactory threadFactory, boolean addTaskWakesUp)
protected	SingleThreadEventLoop(EventLoopGroup parent, java.util.concurrent.ThreadFactory threadFactory, boolean addTaskWakesUp, boolean supportSuspension)
protected	SingleThreadEventLoop(EventLoopGroup parent, java.util.concurrent.ThreadFactory threadFactory, boolean addTaskWakesUp, boolean supportSuspension, int maxPendingTasks, RejectedExecutionHandler rejectedExecutionHandler)
protected	SingleThreadEventLoop(EventLoopGroup parent, java.util.concurrent.ThreadFactory threadFactory, boolean addTaskWakesUp, int maxPendingTasks, RejectedExecutionHandler rejectedExecutionHandler)

Method Summary

Modifier and Type	Method	Description
protected void	afterRunningAllTasks()	Invoked before returning from SingleThreadEventExecutor.runAllTasks() and SingleThreadEventExecutor.runAllTasks(long).
final void	executeAfterEventLoopIteration(java.lang.Runnable task)	Adds a task to be run once at the end of next (or current) eventloop iteration.
protected boolean	hasTasks()
EventLoop	next()	Returns one of the EventExecutors managed by this EventExecutorGroup.
EventLoopGroup	parent()	Return the EventExecutorGroup which is the parent of this EventExecutor,
int	pendingTasks()	Return the number of tasks that are pending for processing.
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.
int	registeredChannels()	Returns the number of Channels registered with this EventLoop or -1 if operation is not supported.
java.util.Iterator<Channel>	registeredChannelsIterator()
(package private) final boolean	removeAfterEventLoopIterationTask(java.lang.Runnable task)	Removes a task that was added previously via executeAfterEventLoopIteration(Runnable).

Methods inherited from class SingleThreadEventExecutor

addShutdownHook, addTask, awaitTermination, canSuspend, canSuspend, cleanup, confirmShutdown, deadlineNanos, delayNanos, execute, getAndIncrementBusyCycles, getAndIncrementIdleCycles, getAndResetAccumulatedActiveTimeNanos, getLastActivityTimeNanos, getNumOfRegisteredChannels, inEventLoop, interruptThread, invokeAll, invokeAll, invokeAny, invokeAny, isShutdown, isShuttingDown, isSuspended, isSuspensionSupported, isTerminated, lazyExecute, newTaskQueue, newTaskQueue, peekTask, pollTask, pollTaskFrom, reject, reject, removeShutdownHook, removeTask, reportActiveIoTime, resetBusyCycles, resetIdleCycles, run, runAllTasks, runAllTasks, runAllTasksFrom, runScheduledAndExecutorTasks, shutdown, shutdownGracefully, takeTask, terminationFuture, threadProperties, trySuspend, updateLastExecutionTime, wakesUpForTask, wakeup

Methods inherited from class AbstractScheduledEventExecutor

afterScheduledTaskSubmitted, beforeScheduledTaskSubmitted, cancelScheduledTasks, deadlineToDelayNanos, delayNanos, fetchFromScheduledTaskQueue, getCurrentTimeNanos, hasScheduledTasks, initialNanoTime, nanoTime, nextScheduledTaskDeadlineNanos, nextScheduledTaskNano, pollScheduledTask, pollScheduledTask, schedule, schedule, scheduleAtFixedRate, scheduleWithFixedDelay, ticker, validateScheduled

Methods inherited from class AbstractEventExecutor

iterator, newTaskFor, newTaskFor, runTask, safeExecute, 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 EventExecutor

inEventLoop, inEventLoop, isExecutorThread, isSuspended, newFailedFuture, newProgressivePromise, newPromise, newSucceededFuture, trySuspend

Methods inherited from interface EventExecutorGroup

isShuttingDown, iterator, schedule, schedule, scheduleAtFixedRate, scheduleWithFixedDelay, shutdown, shutdownGracefully, shutdownGracefully, shutdownNow, submit, submit, submit, terminationFuture, ticker

Methods inherited from interface java.util.concurrent.Executor

execute

Methods inherited from interface java.util.concurrent.ExecutorService

awaitTermination, invokeAll, invokeAll, invokeAny, invokeAny, isShutdown, isTerminated

Methods inherited from interface java.lang.Iterable

forEach, spliterator

Field Details

DEFAULT_MAX_PENDING_TASKS

protected static final int DEFAULT_MAX_PENDING_TASKS

tailTasks

private final java.util.Queue<java.lang.Runnable> tailTasks

Constructor Details

SingleThreadEventLoop

protected SingleThreadEventLoop(EventLoopGroup parent,
 java.util.concurrent.ThreadFactory threadFactory,
 boolean addTaskWakesUp)

SingleThreadEventLoop

protected SingleThreadEventLoop(EventLoopGroup parent,
 java.util.concurrent.ThreadFactory threadFactory,
 boolean addTaskWakesUp,
 boolean supportSuspension)

SingleThreadEventLoop

protected SingleThreadEventLoop(EventLoopGroup parent,
 java.util.concurrent.Executor executor,
 boolean addTaskWakesUp)

SingleThreadEventLoop

protected SingleThreadEventLoop(EventLoopGroup parent,
 java.util.concurrent.Executor executor,
 boolean addTaskWakesUp,
 boolean supportSuspension)

SingleThreadEventLoop

protected SingleThreadEventLoop(EventLoopGroup parent,
 java.util.concurrent.ThreadFactory threadFactory,
 boolean addTaskWakesUp,
 int maxPendingTasks,
 RejectedExecutionHandler rejectedExecutionHandler)

SingleThreadEventLoop

protected SingleThreadEventLoop(EventLoopGroup parent,
 java.util.concurrent.ThreadFactory threadFactory,
 boolean addTaskWakesUp,
 boolean supportSuspension,
 int maxPendingTasks,
 RejectedExecutionHandler rejectedExecutionHandler)

SingleThreadEventLoop

protected SingleThreadEventLoop(EventLoopGroup parent,
 java.util.concurrent.Executor executor,
 boolean addTaskWakesUp,
 int maxPendingTasks,
 RejectedExecutionHandler rejectedExecutionHandler)

SingleThreadEventLoop

protected SingleThreadEventLoop(EventLoopGroup parent,
 java.util.concurrent.Executor executor,
 boolean addTaskWakesUp,
 boolean supportSuspension,
 int maxPendingTasks,
 RejectedExecutionHandler rejectedExecutionHandler)

SingleThreadEventLoop

protected SingleThreadEventLoop(EventLoopGroup parent,
 java.util.concurrent.Executor executor,
 boolean addTaskWakesUp,
 java.util.Queue<java.lang.Runnable> taskQueue,
 java.util.Queue<java.lang.Runnable> tailTaskQueue,
 RejectedExecutionHandler rejectedExecutionHandler)

SingleThreadEventLoop

protected SingleThreadEventLoop(EventLoopGroup parent,
 java.util.concurrent.Executor executor,
 boolean addTaskWakesUp,
 boolean supportSuspension,
 java.util.Queue<java.lang.Runnable> taskQueue,
 java.util.Queue<java.lang.Runnable> tailTaskQueue,
 RejectedExecutionHandler rejectedExecutionHandler)

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: 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 AbstractEventExecutor

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

executeAfterEventLoopIteration

public final void executeAfterEventLoopIteration(java.lang.Runnable task)

Adds a task to be run once at the end of next (or current) eventloop iteration.

Parameters:

task - to be added.

removeAfterEventLoopIterationTask

final boolean removeAfterEventLoopIterationTask(java.lang.Runnable task)

Removes a task that was added previously via executeAfterEventLoopIteration(Runnable).

Parameters:

task - to be removed.

Returns:

true if the task was removed as a result of this call.

afterRunningAllTasks

protected void afterRunningAllTasks()

Description copied from class: SingleThreadEventExecutor

Invoked before returning from SingleThreadEventExecutor.runAllTasks() and SingleThreadEventExecutor.runAllTasks(long).

Overrides:

afterRunningAllTasks in class SingleThreadEventExecutor

hasTasks

protected boolean hasTasks()

Overrides:

hasTasks in class SingleThreadEventExecutor

See Also:

• Collection.isEmpty()

pendingTasks

public int pendingTasks()

Description copied from class: SingleThreadEventExecutor

Return the number of tasks that are pending for processing.

Overrides:

pendingTasks in class SingleThreadEventExecutor

registeredChannels

@UnstableApi
public int registeredChannels()

Returns the number of Channels registered with this EventLoop or -1 if operation is not supported. The returned value is not guaranteed to be exact accurate and should be viewed as a best effort.

registeredChannelsIterator

@UnstableApi
public java.util.Iterator<Channel> registeredChannelsIterator()

Returns:

read-only iterator of active Channels registered with this EventLoop. The returned value is not guaranteed to be exact accurate and should be viewed as a best effort. This method is expected to be called from within event loop.

Throws:

java.lang.UnsupportedOperationException - if operation is not supported by implementation.