Class AbstractEventExecutor

java.lang.Object

java.util.concurrent.AbstractExecutorService

io.netty.util.concurrent.AbstractEventExecutor

All Implemented Interfaces:

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

Direct Known Subclasses:

AbstractEventLoop, AbstractScheduledEventExecutor, ImmediateEventExecutor, NonStickyEventExecutorGroup.NonStickyOrderedEventExecutor

public abstract class AbstractEventExecutor
extends java.util.concurrent.AbstractExecutorService
implements EventExecutor

Abstract base class for EventExecutor implementations.

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static interface	AbstractEventExecutor.LazyRunnable	Deprecated. override SingleThreadEventExecutor.wakesUpForTask(Runnable) to re-create this behaviour

Field Summary

Fields

Modifier and Type	Field	Description
(package private) static final long	DEFAULT_SHUTDOWN_QUIET_PERIOD
(package private) static final long	DEFAULT_SHUTDOWN_TIMEOUT
private static final InternalLogger	logger
private final EventExecutorGroup	parent
private final java.util.Collection<EventExecutor>	selfCollection

Constructor Summary

Constructors

Modifier	Constructor	Description
protected	AbstractEventExecutor()
protected	AbstractEventExecutor(EventExecutorGroup parent)

Method Summary

Modifier and Type	Method	Description
java.util.Iterator<EventExecutor>	iterator()
void	lazyExecute(java.lang.Runnable task)	Like Executor.execute(Runnable) but does not guarantee the task will be run until either a non-lazy task is executed or the executor is shut down.
protected final <T> java.util.concurrent.RunnableFuture<T>	newTaskFor(java.lang.Runnable runnable, T value)
protected final <T> java.util.concurrent.RunnableFuture<T>	newTaskFor(java.util.concurrent.Callable<T> callable)
EventExecutor	next()	Returns one of the EventExecutors managed by this EventExecutorGroup.
EventExecutorGroup	parent()	Return the EventExecutorGroup which is the parent of this EventExecutor,
protected static void	runTask(java.lang.Runnable task)
protected static void	safeExecute(java.lang.Runnable task)	Try to execute the given Runnable and just log if it throws a Throwable.
ScheduledFuture<?>	schedule(java.lang.Runnable command, long delay, java.util.concurrent.TimeUnit unit)
<V> ScheduledFuture<V>	schedule(java.util.concurrent.Callable<V> callable, long delay, java.util.concurrent.TimeUnit unit)
ScheduledFuture<?>	scheduleAtFixedRate(java.lang.Runnable command, long initialDelay, long period, java.util.concurrent.TimeUnit unit)
ScheduledFuture<?>	scheduleWithFixedDelay(java.lang.Runnable command, long initialDelay, long delay, java.util.concurrent.TimeUnit unit)
abstract void	shutdown()	Deprecated. EventExecutorGroup.shutdownGracefully(long, long, TimeUnit) or shutdownGracefully() instead.
Future<?>	shutdownGracefully()	Shortcut method for EventExecutorGroup.shutdownGracefully(long, long, TimeUnit) with sensible default values.
java.util.List<java.lang.Runnable>	shutdownNow()	Deprecated. EventExecutorGroup.shutdownGracefully(long, long, TimeUnit) or shutdownGracefully() instead.
Future<?>	submit(java.lang.Runnable task)
<T> Future<T>	submit(java.lang.Runnable task, T result)
<T> Future<T>	submit(java.util.concurrent.Callable<T> task)

Methods inherited from class java.util.concurrent.AbstractExecutorService

invokeAll, invokeAll, invokeAny, invokeAny

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, shutdownGracefully, 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

logger

private static final InternalLogger logger

DEFAULT_SHUTDOWN_QUIET_PERIOD

static final long DEFAULT_SHUTDOWN_QUIET_PERIOD

See Also:

• Constant Field Values

DEFAULT_SHUTDOWN_TIMEOUT

static final long DEFAULT_SHUTDOWN_TIMEOUT

See Also:

• Constant Field Values

parent

private final EventExecutorGroup parent

selfCollection

private final java.util.Collection<EventExecutor> selfCollection

Constructor Details

AbstractEventExecutor

protected AbstractEventExecutor()

AbstractEventExecutor

protected AbstractEventExecutor(EventExecutorGroup parent)

Method Details

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

next

public EventExecutor next()

Description copied from interface: EventExecutorGroup

Returns one of the EventExecutors managed by this EventExecutorGroup.

Specified by:

next in interface EventExecutorGroup

iterator

public java.util.Iterator<EventExecutor> iterator()

Specified by:

iterator in interface EventExecutorGroup

Specified by:

iterator in interface java.lang.Iterable<EventExecutor>

shutdownGracefully

public Future<?> shutdownGracefully()

Description copied from interface: EventExecutorGroup

Shortcut method for EventExecutorGroup.shutdownGracefully(long, long, TimeUnit) with sensible default values.

Specified by:

shutdownGracefully in interface EventExecutorGroup

Returns:

the EventExecutorGroup.terminationFuture()

shutdown

@Deprecated
public abstract void shutdown()

Deprecated.

EventExecutorGroup.shutdownGracefully(long, long, TimeUnit) or shutdownGracefully() instead.

Specified by:

shutdown in interface EventExecutorGroup

Specified by:

shutdown in interface java.util.concurrent.ExecutorService

shutdownNow

@Deprecated
public java.util.List<java.lang.Runnable> shutdownNow()

Deprecated.

EventExecutorGroup.shutdownGracefully(long, long, TimeUnit) or shutdownGracefully() instead.

Specified by:

shutdownNow in interface EventExecutorGroup

Specified by:

shutdownNow in interface java.util.concurrent.ExecutorService

submit

public Future<?> submit(java.lang.Runnable task)

Specified by:

submit in interface EventExecutorGroup

Specified by:

submit in interface java.util.concurrent.ExecutorService

Overrides:

submit in class java.util.concurrent.AbstractExecutorService

submit

public <T> Future<T> submit(java.lang.Runnable task,
 T result)

Specified by:

submit in interface EventExecutorGroup

Specified by:

submit in interface java.util.concurrent.ExecutorService

Overrides:

submit in class java.util.concurrent.AbstractExecutorService

submit

public <T> Future<T> submit(java.util.concurrent.Callable<T> task)

Specified by:

submit in interface EventExecutorGroup

Specified by:

submit in interface java.util.concurrent.ExecutorService

Overrides:

submit in class java.util.concurrent.AbstractExecutorService

newTaskFor

protected final <T>
java.util.concurrent.RunnableFuture<T> newTaskFor(java.lang.Runnable runnable,
 T value)

Overrides:

newTaskFor in class java.util.concurrent.AbstractExecutorService

newTaskFor

protected final <T>
java.util.concurrent.RunnableFuture<T> newTaskFor(java.util.concurrent.Callable<T> callable)

Overrides:

newTaskFor in class java.util.concurrent.AbstractExecutorService

schedule

public ScheduledFuture<?> schedule(java.lang.Runnable command,
 long delay,
 java.util.concurrent.TimeUnit unit)

Specified by:

schedule in interface EventExecutorGroup

Specified by:

schedule in interface java.util.concurrent.ScheduledExecutorService

schedule

public <V> ScheduledFuture<V> schedule(java.util.concurrent.Callable<V> callable,
 long delay,
 java.util.concurrent.TimeUnit unit)

Specified by:

schedule in interface EventExecutorGroup

Specified by:

schedule in interface java.util.concurrent.ScheduledExecutorService

scheduleAtFixedRate

public ScheduledFuture<?> scheduleAtFixedRate(java.lang.Runnable command,
 long initialDelay,
 long period,
 java.util.concurrent.TimeUnit unit)

Specified by:

scheduleAtFixedRate in interface EventExecutorGroup

Specified by:

scheduleAtFixedRate in interface java.util.concurrent.ScheduledExecutorService

scheduleWithFixedDelay

public ScheduledFuture<?> scheduleWithFixedDelay(java.lang.Runnable command,
 long initialDelay,
 long delay,
 java.util.concurrent.TimeUnit unit)

Specified by:

scheduleWithFixedDelay in interface EventExecutorGroup

Specified by:

scheduleWithFixedDelay in interface java.util.concurrent.ScheduledExecutorService

safeExecute

protected static void safeExecute(java.lang.Runnable task)

Try to execute the given Runnable and just log if it throws a Throwable.

runTask

protected static void runTask(java.lang.Runnable task)

lazyExecute

@UnstableApi
public void lazyExecute(java.lang.Runnable task)

Like Executor.execute(Runnable) but does not guarantee the task will be run until either a non-lazy task is executed or the executor is shut down.

The default implementation just delegates to Executor.execute(Runnable).