io.netty.util.concurrent

Class SingleThreadEventExecutor

java.lang.Object

java.util.concurrent.AbstractExecutorService

io.netty.util.concurrent.AbstractEventExecutor

io.netty.util.concurrent.AbstractScheduledEventExecutor

io.netty.util.concurrent.SingleThreadEventExecutor

All Implemented Interfaces:

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

Direct Known Subclasses:

SingleThreadEventLoop

public abstract class SingleThreadEventExecutor
extends AbstractScheduledEventExecutor
implements OrderedEventExecutor

Abstract base class for OrderedEventExecutor's that execute all its submitted tasks in a single thread.

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	SingleThreadEventExecutor(EventExecutorGroup parent, java.util.concurrent.ThreadFactory threadFactory, boolean addTaskWakesUp) Create a new instance
protected	SingleThreadEventExecutor(EventExecutorGroup parent, java.util.concurrent.ThreadFactory threadFactory, boolean addTaskWakesUp, int maxPendingTasks, RejectedExecutionHandler rejectedHandler) Create a new instance

Method Summary

Modifier and Type	Method and Description
void	addShutdownHook(java.lang.Runnable task) Add a Runnable which will be executed on shutdown of this instance
protected void	addTask(java.lang.Runnable task) Add a task to the task queue, or throws a RejectedExecutionException if this instance was shutdown before.
boolean	awaitTermination(long timeout, java.util.concurrent.TimeUnit unit)
protected void	cleanup() Do nothing, sub-classes may override
protected boolean	confirmShutdown() Confirm that the shutdown if the instance should be done now!
protected long	delayNanos(long currentTimeNanos) Returns the amount of time left until the scheduled task with the closest dead line is executed.
void	execute(java.lang.Runnable task)
protected boolean	hasTasks()
boolean	inEventLoop(java.lang.Thread thread) Return true if the given Thread is executed in the event loop, false otherwise.
protected void	interruptThread() Interrupt the current running Thread.
<T> java.util.List<java.util.concurrent.Future<T>>	invokeAll(java.util.Collection<? extends java.util.concurrent.Callable<T>> tasks)
<T> java.util.List<java.util.concurrent.Future<T>>	invokeAll(java.util.Collection<? extends java.util.concurrent.Callable<T>> tasks, long timeout, java.util.concurrent.TimeUnit unit)
<T> T	invokeAny(java.util.Collection<? extends java.util.concurrent.Callable<T>> tasks)
<T> T	invokeAny(java.util.Collection<? extends java.util.concurrent.Callable<T>> tasks, long timeout, java.util.concurrent.TimeUnit unit)
boolean	isShutdown()
boolean	isShuttingDown() Returns true if and only if this executor was started to be shut down gracefuclly or was shut down.
boolean	isTerminated()
protected java.util.Queue<java.lang.Runnable>	newTaskQueue() Deprecated. Please use and override newTaskQueue(int).
protected java.util.Queue<java.lang.Runnable>	newTaskQueue(int maxPendingTasks) Create a new Queue which will holds the tasks to execute.
EventExecutorGroup	parent() Return the EventExecutorGroup which is the parent of this EventExecutor,
protected java.lang.Runnable	peekTask()
int	pendingTasks() Return the number of tasks that are pending for processing.
protected java.lang.Runnable	pollTask()
protected static void	reject()
void	removeShutdownHook(java.lang.Runnable task) Remove a previous added Runnable as a shutdown hook
protected boolean	removeTask(java.lang.Runnable task)
protected abstract void	run()
protected boolean	runAllTasks() Poll all tasks from the task queue and run them via Runnable.run() method.
protected boolean	runAllTasks(long timeoutNanos) Poll all tasks from the task queue and run them via Runnable.run() method.
void	shutdown() Deprecated.
Future<?>	shutdownGracefully(long quietPeriod, long timeout, java.util.concurrent.TimeUnit unit) Signals this executor that the caller wants the executor to be shut down.
protected java.lang.Runnable	takeTask() Take the next Runnable from the task queue and so will block if no task is currently present.
Future<?>	terminationFuture() Returns the Future which is notified when this executor has been terminated.
ThreadProperties	threadProperties() Returns the ThreadProperties of the Thread that powers the SingleThreadEventExecutor.
protected void	updateLastExecutionTime() Updates the internal timestamp that tells when a submitted task was executed most recently.
protected boolean	wakesUpForTask(java.lang.Runnable task)
protected void	wakeup(boolean inEventLoop)

Methods inherited from class io.netty.util.concurrent.AbstractScheduledEventExecutor

cancelScheduledTasks, hasScheduledTasks, nanoTime, nextScheduledTaskNano, pollScheduledTask, pollScheduledTask, schedule, schedule, scheduleAtFixedRate, scheduleWithFixedDelay

Methods inherited from class io.netty.util.concurrent.AbstractEventExecutor

inEventLoop, iterator, newFailedFuture, newProgressivePromise, newPromise, newSucceededFuture, newTaskFor, newTaskFor, next, 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.EventExecutor

inEventLoop, newFailedFuture, newProgressivePromise, newPromise, newSucceededFuture, next

Methods inherited from interface io.netty.util.concurrent.EventExecutorGroup

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

Methods inherited from interface java.lang.Iterable

forEach, spliterator

Constructor Detail

SingleThreadEventExecutor

protected SingleThreadEventExecutor(EventExecutorGroup parent,
                                    java.util.concurrent.ThreadFactory threadFactory,
                                    boolean addTaskWakesUp)

Create a new instance

Parameters:

parent - the EventExecutorGroup which is the parent of this instance and belongs to it

threadFactory - the ThreadFactory which will be used for the used Thread

addTaskWakesUp - true if and only if invocation of addTask(Runnable) will wake up the executor thread

SingleThreadEventExecutor

protected SingleThreadEventExecutor(EventExecutorGroup parent,
                                    java.util.concurrent.ThreadFactory threadFactory,
                                    boolean addTaskWakesUp,
                                    int maxPendingTasks,
                                    RejectedExecutionHandler rejectedHandler)

Create a new instance

Parameters:

parent - the EventExecutorGroup which is the parent of this instance and belongs to it

threadFactory - the ThreadFactory which will be used for the used Thread

addTaskWakesUp - true if and only if invocation of addTask(Runnable) will wake up the executor thread

maxPendingTasks - the maximum number of pending tasks before new tasks will be rejected.

rejectedHandler - the RejectedExecutionHandler to use.

Method Detail

newTaskQueue

@Deprecated
protected java.util.Queue<java.lang.Runnable> newTaskQueue()

Deprecated. Please use and override newTaskQueue(int).

newTaskQueue

protected java.util.Queue<java.lang.Runnable> newTaskQueue(int maxPendingTasks)

Create a new Queue which will holds the tasks to execute. This default implementation will return a LinkedBlockingQueue but if your sub-class of SingleThreadEventExecutor will not do any blocking calls on the this Queue it may make sense to @Override this and return some more performant implementation that does not support blocking operations at all.

parent

public EventExecutorGroup parent()

Description copied from interface: EventExecutor

Return the EventExecutorGroup which is the parent of this EventExecutor,

Specified by:

parent in interface EventExecutor

interruptThread

protected void interruptThread()

Interrupt the current running Thread.

pollTask

protected java.lang.Runnable pollTask()

See Also:

Queue.poll()

takeTask

protected java.lang.Runnable takeTask()

Take the next Runnable from the task queue and so will block if no task is currently present.

Be aware that this method will throw an UnsupportedOperationException if the task queue, which was created via newTaskQueue(), does not implement BlockingQueue.

Returns:

null if the executor thread has been interrupted or waken up.

peekTask

protected java.lang.Runnable peekTask()

See Also:

Queue.peek()

hasTasks

protected boolean hasTasks()

See Also:

Collection.isEmpty()

pendingTasks

public int pendingTasks()

Return the number of tasks that are pending for processing. Be aware that this operation may be expensive as it depends on the internal implementation of the SingleThreadEventExecutor. So use it was care!

addTask

protected void addTask(java.lang.Runnable task)

Add a task to the task queue, or throws a RejectedExecutionException if this instance was shutdown before.

removeTask

protected boolean removeTask(java.lang.Runnable task)

See Also:

Collection.remove(Object)

runAllTasks

protected boolean runAllTasks()

Poll all tasks from the task queue and run them via Runnable.run() method.

Returns:

true if and only if at least one task was run

runAllTasks

protected boolean runAllTasks(long timeoutNanos)

Poll all tasks from the task queue and run them via Runnable.run() method. This method stops running the tasks in the task queue and returns if it ran longer than timeoutNanos.

delayNanos

protected long delayNanos(long currentTimeNanos)

Returns the amount of time left until the scheduled task with the closest dead line is executed.

updateLastExecutionTime

protected void updateLastExecutionTime()

Updates the internal timestamp that tells when a submitted task was executed most recently. runAllTasks() and runAllTasks(long) updates this timestamp automatically, and thus there's usually no need to call this method. However, if you take the tasks manually using takeTask() or pollTask(), you have to call this method at the end of task execution loop for accurate quiet period checks.

run

protected abstract void run()

cleanup

protected void cleanup()

Do nothing, sub-classes may override

wakeup

protected void wakeup(boolean inEventLoop)

inEventLoop

public boolean inEventLoop(java.lang.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

addShutdownHook

public void addShutdownHook(java.lang.Runnable task)

Add a Runnable which will be executed on shutdown of this instance

removeShutdownHook

public void removeShutdownHook(java.lang.Runnable task)

Remove a previous added Runnable as a shutdown hook

shutdownGracefully

public Future<?> shutdownGracefully(long quietPeriod,
                                    long timeout,
                                    java.util.concurrent.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 this executor has 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 java.util.concurrent.ExecutorService

Specified by:

shutdown in class AbstractEventExecutor

isShuttingDown

public boolean isShuttingDown()

Description copied from interface: EventExecutorGroup

Returns true if and only if this executor was started to be shut down gracefuclly or was shut down.

Specified by:

isShuttingDown in interface EventExecutorGroup

isShutdown

public boolean isShutdown()

Specified by:

isShutdown in interface java.util.concurrent.ExecutorService

isTerminated

public boolean isTerminated()

Specified by:

isTerminated in interface java.util.concurrent.ExecutorService

confirmShutdown

protected boolean confirmShutdown()

Confirm that the shutdown if the instance should be done now!

awaitTermination

public boolean awaitTermination(long timeout,
                                java.util.concurrent.TimeUnit unit)
                         throws java.lang.InterruptedException

Specified by:

awaitTermination in interface java.util.concurrent.ExecutorService

Throws:

java.lang.InterruptedException

execute

public void execute(java.lang.Runnable task)

Specified by:

execute in interface java.util.concurrent.Executor

invokeAny

public <T> T invokeAny(java.util.Collection<? extends java.util.concurrent.Callable<T>> tasks)
                throws java.lang.InterruptedException,
                       java.util.concurrent.ExecutionException

Specified by:

invokeAny in interface java.util.concurrent.ExecutorService

Overrides:

invokeAny in class java.util.concurrent.AbstractExecutorService

Throws:

java.lang.InterruptedException

java.util.concurrent.ExecutionException

invokeAny

public <T> T invokeAny(java.util.Collection<? extends java.util.concurrent.Callable<T>> tasks,
                       long timeout,
                       java.util.concurrent.TimeUnit unit)
                throws java.lang.InterruptedException,
                       java.util.concurrent.ExecutionException,
                       java.util.concurrent.TimeoutException

Specified by:

invokeAny in interface java.util.concurrent.ExecutorService

Overrides:

invokeAny in class java.util.concurrent.AbstractExecutorService

Throws:

java.lang.InterruptedException

java.util.concurrent.ExecutionException

java.util.concurrent.TimeoutException

invokeAll

public <T> java.util.List<java.util.concurrent.Future<T>> invokeAll(java.util.Collection<? extends java.util.concurrent.Callable<T>> tasks)
                                                             throws java.lang.InterruptedException

Specified by:

invokeAll in interface java.util.concurrent.ExecutorService

Overrides:

invokeAll in class java.util.concurrent.AbstractExecutorService

Throws:

java.lang.InterruptedException

invokeAll

public <T> java.util.List<java.util.concurrent.Future<T>> invokeAll(java.util.Collection<? extends java.util.concurrent.Callable<T>> tasks,
                                                                    long timeout,
                                                                    java.util.concurrent.TimeUnit unit)
                                                             throws java.lang.InterruptedException

Specified by:

invokeAll in interface java.util.concurrent.ExecutorService

Overrides:

invokeAll in class java.util.concurrent.AbstractExecutorService

Throws:

java.lang.InterruptedException

threadProperties

public final ThreadProperties threadProperties()

Returns the ThreadProperties of the Thread that powers the SingleThreadEventExecutor.

wakesUpForTask

protected boolean wakesUpForTask(java.lang.Runnable task)

reject

protected static void reject()