io.netty.channel

Class SingleThreadIoEventLoop

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

io.netty.channel.SingleThreadIoEventLoop

All Implemented Interfaces:

EventLoop, EventLoopGroup, IoEventLoop, IoEventLoopGroup, io.netty.util.concurrent.EventExecutor, io.netty.util.concurrent.EventExecutorGroup, io.netty.util.concurrent.OrderedEventExecutor, Iterable<io.netty.util.concurrent.EventExecutor>, Executor, ExecutorService, ScheduledExecutorService

Direct Known Subclasses:

NioEventLoop

public class SingleThreadIoEventLoop
extends SingleThreadEventLoop
implements IoEventLoop

IoEventLoop implementation that execute all its submitted tasks in a single thread using the provided IoHandler.

Nested Class Summary

Nested classes/interfaces inherited from class io.netty.channel.SingleThreadEventLoop

SingleThreadEventLoop.ChannelsReadOnlyIterator<T extends Channel>

Nested classes/interfaces inherited from class io.netty.util.concurrent.SingleThreadEventExecutor

io.netty.util.concurrent.SingleThreadEventExecutor.NonWakeupRunnable

Nested classes/interfaces inherited from class io.netty.util.concurrent.AbstractEventExecutor

io.netty.util.concurrent.AbstractEventExecutor.LazyRunnable

Field Summary

Fields inherited from class io.netty.channel.SingleThreadEventLoop

DEFAULT_MAX_PENDING_TASKS

Constructor Summary

Constructors

Modifier	Constructor and Description
	SingleThreadIoEventLoop(IoEventLoopGroup parent, Executor executor, IoHandler ioHandler) Creates a new instance
	SingleThreadIoEventLoop(IoEventLoopGroup parent, Executor executor, IoHandler ioHandler, int maxPendingTasks, io.netty.util.concurrent.RejectedExecutionHandler rejectedExecutionHandler, long maxTaskProcessingQuantumMs) Creates a new instance
protected	SingleThreadIoEventLoop(IoEventLoopGroup parent, Executor executor, IoHandler ioHandler, Queue<Runnable> taskQueue, Queue<Runnable> tailTaskQueue, io.netty.util.concurrent.RejectedExecutionHandler rejectedExecutionHandler) Creates a new instance
	SingleThreadIoEventLoop(IoEventLoopGroup parent, ThreadFactory threadFactory, IoHandler ioHandler) Creates a new instance
	SingleThreadIoEventLoop(IoEventLoopGroup parent, ThreadFactory threadFactory, IoHandler ioHandler, int maxPendingTasks, io.netty.util.concurrent.RejectedExecutionHandler rejectedExecutionHandler, long maxTaskProcessingQuantumMs) Creates a new instance

Method Summary

Modifier and Type	Method and Description
protected boolean	canSuspend(int state)
protected void	cleanup()
protected IoHandler	ioHandler()
boolean	isCompatible(Class<? extends IoHandle> handleType) Returns true if the given type is compatible with this IoEventLoopGroup and so can be registered to the contained IoEventLoops, false otherwise.
boolean	isIoType(Class<? extends IoHandler> handlerType) Returns true if the given IoHandler type is used by this IoEventLoopGroup, false otherwise.
IoEventLoop	next() Return the next EventLoop to use
io.netty.util.concurrent.Future<IoRegistration>	register(IoHandle handle) Register the IoHandle to the EventLoop for I/O processing.
protected void	run()
protected int	runIo() Called when IO will be processed for all the IoHandles on this SingleThreadIoEventLoop.
protected void	wakeup(boolean inEventLoop)

Methods inherited from class io.netty.channel.SingleThreadEventLoop

afterRunningAllTasks, executeAfterEventLoopIteration, hasTasks, parent, pendingTasks, register, register, register, registeredChannels, registeredChannelsIterator

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

addShutdownHook, addTask, awaitTermination, canSuspend, confirmShutdown, deadlineNanos, delayNanos, execute, inEventLoop, interruptThread, invokeAll, invokeAll, invokeAny, invokeAny, isShutdown, isShuttingDown, isSuspended, isTerminated, lazyExecute, newTaskQueue, newTaskQueue, peekTask, pollTask, pollTaskFrom, reject, reject, removeShutdownHook, removeTask, runAllTasks, runAllTasks, runAllTasksFrom, runScheduledAndExecutorTasks, shutdown, shutdownGracefully, takeTask, terminationFuture, threadProperties, trySuspend, updateLastExecutionTime, wakesUpForTask

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

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

Methods inherited from class io.netty.util.concurrent.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 io.netty.channel.IoEventLoop

parent, register, register

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

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

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

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

Methods inherited from interface java.util.concurrent.ExecutorService

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

Methods inherited from interface java.util.concurrent.Executor

execute

Methods inherited from interface java.lang.Iterable

forEach, spliterator

Methods inherited from interface io.netty.channel.EventLoopGroup

register

Constructor Detail

SingleThreadIoEventLoop

public SingleThreadIoEventLoop(IoEventLoopGroup parent,
                               ThreadFactory threadFactory,
                               IoHandler ioHandler)

Creates a new instance

Parameters:

parent - the parent that holds this IoEventLoop.

ioHandler - the IoHandler used to run all IO.

threadFactory - the ThreadFactory that is used to create the underlying Thread.

SingleThreadIoEventLoop

public SingleThreadIoEventLoop(IoEventLoopGroup parent,
                               Executor executor,
                               IoHandler ioHandler)

Creates a new instance

Parameters:

parent - the parent that holds this IoEventLoop.

executor - the Executor that is used for dispatching the work.

ioHandler - the IoHandler used to run all IO.

SingleThreadIoEventLoop

public SingleThreadIoEventLoop(IoEventLoopGroup parent,
                               ThreadFactory threadFactory,
                               IoHandler ioHandler,
                               int maxPendingTasks,
                               io.netty.util.concurrent.RejectedExecutionHandler rejectedExecutionHandler,
                               long maxTaskProcessingQuantumMs)

Creates a new instance

Parameters:

parent - the parent that holds this IoEventLoop.

threadFactory - the ThreadFactory that is used to create the underlying Thread.

ioHandler - the IoHandler used to run all IO.

maxPendingTasks - the maximum pending tasks that are allowed before RejectedExecutionHandler.rejected(Runnable, SingleThreadEventExecutor) is called to handle it.

rejectedExecutionHandler - the RejectedExecutionHandler that handles when more tasks are added then allowed per maxPendingTasks.

maxTaskProcessingQuantumMs - the maximum number of milliseconds that will be spent to run tasks before trying to run IO again.

SingleThreadIoEventLoop

public SingleThreadIoEventLoop(IoEventLoopGroup parent,
                               Executor executor,
                               IoHandler ioHandler,
                               int maxPendingTasks,
                               io.netty.util.concurrent.RejectedExecutionHandler rejectedExecutionHandler,
                               long maxTaskProcessingQuantumMs)

Creates a new instance

Parameters:

parent - the parent that holds this IoEventLoop.

ioHandler - the IoHandler used to run all IO.

executor - the Executor that is used for dispatching the work.

maxPendingTasks - the maximum pending tasks that are allowed before RejectedExecutionHandler.rejected(Runnable, SingleThreadEventExecutor) is called to handle it.

rejectedExecutionHandler - the RejectedExecutionHandler that handles when more tasks are added then allowed per maxPendingTasks.

maxTaskProcessingQuantumMs - the maximum number of milliseconds that will be spent to run tasks before trying to run IO again.

SingleThreadIoEventLoop

protected SingleThreadIoEventLoop(IoEventLoopGroup parent,
                                  Executor executor,
                                  IoHandler ioHandler,
                                  Queue<Runnable> taskQueue,
                                  Queue<Runnable> tailTaskQueue,
                                  io.netty.util.concurrent.RejectedExecutionHandler rejectedExecutionHandler)

Creates a new instance

Parameters:

parent - the parent that holds this IoEventLoop.

executor - the Executor that is used for dispatching the work.

ioHandler - the IoHandler used to run all IO.

taskQueue - the Queue used for storing pending tasks.

tailTaskQueue - the Queue used for storing tail pending tasks.

rejectedExecutionHandler - the RejectedExecutionHandler that handles when more tasks are added then allowed.

Method Detail

run

protected void run()

Specified by:

run in class io.netty.util.concurrent.SingleThreadEventExecutor

ioHandler

protected final IoHandler ioHandler()

canSuspend

protected boolean canSuspend(int state)

Overrides:

canSuspend in class io.netty.util.concurrent.SingleThreadEventExecutor

runIo

protected int runIo()

Called when IO will be processed for all the IoHandles on this SingleThreadIoEventLoop. This method returns the number of IoHandles for which IO was processed. This method must be called from the EventLoop thread.

next

public IoEventLoop next()

Description copied from interface: EventLoopGroup

Return the next EventLoop to use

Specified by:

next in interface EventLoopGroup

Specified by:

next in interface IoEventLoopGroup

Specified by:

next in interface io.netty.util.concurrent.EventExecutorGroup

Overrides:

next in class SingleThreadEventLoop

register

public final io.netty.util.concurrent.Future<IoRegistration> register(IoHandle handle)

Description copied from interface: IoEventLoop

Register the IoHandle to the EventLoop for I/O processing.

Specified by:

register in interface IoEventLoop

Parameters:

handle - the IoHandle to register.

Returns:

the Future that is notified once the operations completes.

wakeup

protected final void wakeup(boolean inEventLoop)

Overrides:

wakeup in class io.netty.util.concurrent.SingleThreadEventExecutor

cleanup

protected final void cleanup()

Overrides:

cleanup in class io.netty.util.concurrent.SingleThreadEventExecutor

isCompatible

public boolean isCompatible(Class<? extends IoHandle> handleType)

Description copied from interface: IoEventLoopGroup

Returns true if the given type is compatible with this IoEventLoopGroup and so can be registered to the contained IoEventLoops, false otherwise.

Specified by:

isCompatible in interface IoEventLoop

Specified by:

isCompatible in interface IoEventLoopGroup

Parameters:

handleType - the type of the IoHandle.

Returns:

if compatible of not.

isIoType

public boolean isIoType(Class<? extends IoHandler> handlerType)

Description copied from interface: IoEventLoopGroup

Returns true if the given IoHandler type is used by this IoEventLoopGroup, false otherwise.

Specified by:

isIoType in interface IoEventLoop

Specified by:

isIoType in interface IoEventLoopGroup

Parameters:

handlerType - the type of the IoHandler.

Returns:

if used or not.