com.sun.grizzly
Class Controller

java.lang.Object
  com.sun.grizzly.Controller

All Implemented Interfaces:

ConnectorHandlerPool, Lifecycle, AttributeHolder, Copyable, SupportStateHolder<State>, java.lang.Runnable

Direct Known Subclasses:

ReadController

public class Controller
extends java.lang.Object
implements java.lang.Runnable, Lifecycle, Copyable, ConnectorHandlerPool, AttributeHolder, SupportStateHolder<State>

Main entry point when using the Grizzly Framework. A Controller is composed of Handlers, ProtocolChain and ExecutorService. All of those components are configurable by client using the Grizzly Framework.

A ProtocolChain implement the "Chain of Responsibility" pattern (for more info, take a look at the classic "Gang of Four" design patterns book). Towards that end, the Chain API models a computation as a series of "protocol filter" that can be combined into a "protocol chain".

An Handler is a interface that can be implemented by implemented by client of the Grizzly Framework to used to help handling NIO operations. The Grizzly Framework define three Handlers:

 (1) SelectorHandler: A SelectorHandler handles all java.nio.channels.Selector
                     operations. One or more instance of a Selector are
                     handled by SelectorHandler. The logic for processing of
                     SelectionKey interest (OP_ACCEPT,OP_READ, etc.) is usually
                     defined using an instance of SelectorHandler.
 (2) SelectionKeyHandler: A SelectionKeyHandler is used to handle the life
                          life cycle of a SelectionKey. Operations like canceling,
                          registering or closing are handled by SelectionKeyHandler.
 (3) ProtocolChainInstanceHandler: An ProtocolChainInstanceHandler is where one or several ProtocolChain
                      are created and cached. An ProtocolChainInstanceHandler decide if
                      a stateless or statefull ProtocolChain needs to be created.
 

By default, the Grizzly Framework bundles implementation for TCP and UPD transport. The TCPSelectorHandler is instanciated by default. As an example, supporting the HTTP protocol should only consist of adding the appropriate ProtocolFilter like:

       Controller sel = new Controller();
       sel.setProtocolChainInstanceHandler(new DefaultProtocolChainInstanceHandler(){
           public ProtocolChain poll() {
               ProtocolChain protocolChain = protocolChains.poll();
               if (protocolChain == null){
                   protocolChain = new DefaultProtocolChain();
                   protocolChain.addFilter(new ReadFilter());
                   protocolChain.addFilter(new HTTPParserFilter());
               }
               return protocolChain;
           }
       });

 

In the example above, a pool of ProtocolChain will be created, and all instance of ProtocolChain will have their instance of ProtocolFilter. Hence the above implementation can be called statefull. A stateless implementation would instead consist of sharing the ProtocolFilter among ProtocolChain:

       final Controller sel = new Controller();
       final ReadFilter readFilter = new ReadFilter();
       final LogFilter logFilter = new LogFilter();

       sel.setProtocolChainInstanceHandler(new DefaultProtocolChainInstanceHandler(){
           public ProtocolChain poll() {
               ProtocolChain protocolChain = protocolChains.poll();
               if (protocolChain == null){
                   protocolChain = new DefaultProtocolChain();
                   protocolChain.addFilter(readFilter);
                   protocolChain.addFilter(logFilter);
               }
               return protocolChain;
           }
       });
 

The Controller can be configure at runtime using System properties. For more information, take a look at ControllerConfig class.

Author:

Jeanfrancois Arcand

Nested Class Summary

static interface	Controller.KernelExecutorFactory
static class	Controller.Protocol

Field Summary

protected java.util.Map<java.lang.String,java.lang.Object>	attributes Attributes, associated with the Controller instance
protected ConnectorHandlerPool	connectorHandlerPool The ConnectorHandlerPool, which is responsible for creating/caching ConnectorHandler instances.
protected ProtocolChainInstanceHandler	instanceHandler The ProtocolChainInstanceHandler used by this instance.
protected static java.util.logging.Logger	logger Default Logger.
protected ComplexSelectorHandler	multiReadThreadSelectorHandler The SelectorHandler, which will manage connection accept, if readThreadsCount > 0 and spread connection processing between different read threads
protected ReadController[]	readThreadControllers The array of Controllers to be used for reading
protected int	readThreadsCount The number of read threads
protected java.util.concurrent.atomic.AtomicInteger	readySelectorHandlerCounter Internal countdown counter of SelectorHandlers, which are ready to process
protected SelectionKeyHandler	selectionKeyHandler The SelectionKey Handler used by this instance.
protected java.util.Queue<SelectorHandler>	selectorHandlers The set of SelectorHandlers used by this instance.
protected StateHolder<State>	stateHolder Current Controller state
protected java.util.Collection<ControllerStateListener>	stateListeners Collection of Controller state listeners, which will are notified on Controller state change.
protected java.util.concurrent.atomic.AtomicInteger	stoppedSelectorHandlerCounter Internal countdown counter of SelectorHandlers, which stopped
protected java.util.concurrent.ExecutorService	threadPool Default Thread Pool (called ExecutorService).If not set, and instance of the DefaultThreadPool will be created.

Constructor Summary

Controller()
Controller constructor

Method Summary

ConnectorHandler	acquireConnectorHandler(Controller.Protocol protocol) Return an instance of a ConnectorHandler based on the Protocol requested.
void	addSelectorHandler(SelectorHandler selectorHandler) Add a SelectorHandler
void	addStateListener(ControllerStateListener stateListener) Add controller state listener
void	cancelKey(java.nio.channels.SelectionKey key) Deprecated.
void	configureContext(java.nio.channels.SelectionKey key, Context.OpType opType, NIOContext ctx, SelectorHandler selectorHandler) Configure the Context
void	copyTo(Copyable copy) Copy this Controller state to another instance of a Controller.
protected java.util.concurrent.ExecutorService	createKernelExecutor() Create the ExecutorService used to execute kernel like operations.
protected void	executeUsingKernelExecutor() Execute the run() using the internal/kernel Executors
void	executeUsingKernelExecutor(java.lang.Runnable r) Execute the Runnable using the internal kernel Executors.
java.lang.Object	getAttribute(java.lang.String key) Return an object based on a key.
java.util.Map<java.lang.String,java.lang.Object>	getAttributes() Return a Map of attribute name/value pairs.
ConnectorHandlerPool	getConnectorHandlerPool() Return the ConnectorHandlerPool used.
static Controller	getHandlerController(Handler handler) Return the Controller which is handling the Handler
Controller.KernelExecutorFactory	getKernelExecutorFactory() Get the factory, responsible for creating kernel ExecutorServices.
ProtocolChainInstanceHandler	getProtocolChainInstanceHandler() Return the ProtocolChainInstanceHandler
int	getReadThreadsCount() Return the number of Reader threads count.
SelectionKeyHandler	getSelectionKeyHandler() Deprecated. Return the SelectionKeyHandler Method is deprecated. Use SelectorHandler.getSelectionKeyHandler() instead
SelectorHandler	getSelectorHandler(Controller.Protocol protocol) Return the SelectorHandler associated with the protocol.
SelectorHandler	getSelectorHandler(java.nio.channels.Selector selector) Return the SelectorHandler associated with the Selector.
java.util.Queue	getSelectorHandlers() Return the list SelectorHandler
StateHolder<State>	getStateHolder() Gets this Controller's StateHolder
java.util.concurrent.ExecutorService	getThreadPool() Return the ExecutorService (Thread Pool) used by this Controller.
boolean	isAllowContextCaching() Are Context instance cached/pooled or a new instance gets created for every transaction?
boolean	isAutoConfigure() Return true if the Controller is auto configuring the number of ReadController and its associated thread pool size.
boolean	isExecutePendingIOUsingSelectorThread() Return true, if selector thread has to be applied to execute I/O operation, or false (by default), meaning that I/O operation could be executed in the current thread.
boolean	isHandleReadWriteConcurrently() true if OP_ERAD and OP_WRITE can be handled concurrently.
boolean	isStarted() Is this Controller started?
static java.util.logging.Logger	logger() Return the current Logger used by this Controller.
void	logVersion() Log the current Grizzly version.
void	notifyException(java.lang.Throwable e) Notify exception occured
void	notifyReady() Notify controller is ready
void	notifyStarted() Notify controller started
void	notifyStopped() Notify controller stopped
void	pause() Pause this Controller and associated SelectorHandlers
Context	pollContext() Get an instance of a NIOContext
void	registerKey(java.nio.channels.SelectionKey key) Register a SelectionKey.
void	registerKey(java.nio.channels.SelectionKey key, int ops) Register a SelectionKey on the first SelectorHandler that was added using the addSelectorHandler().
void	registerKey(java.nio.channels.SelectionKey key, int ops, Controller.Protocol protocol) Register a SelectionKey.
void	releaseConnectorHandler(ConnectorHandler connectorHandler) Return a ConnectorHandler to the pool of ConnectorHandler.
java.lang.Object	removeAttribute(java.lang.String key) Remove a key/value object.
void	removeSelectorHandler(SelectorHandler selectorHandler) Shuts down SelectorHandler and removes it from this Controller list
void	removeStateListener(ControllerStateListener stateListener) Remove controller state listener
void	resume() Resume this Controller and associated SelectorHandlers
void	returnContext(Context ctx) Return a Context to its pool if it is not shared.
void	run() Execute this Controller.
void	setAllowContextCaching(boolean allowContextCaching) Set to true for enabling caching of Context.
void	setAttribute(java.lang.String key, java.lang.Object value) Set a key/value object.
void	setAttributes(java.util.Map<java.lang.String,java.lang.Object> attributes) Set a Map of attribute name/value pairs.
void	setAutoConfigure(boolean autoConfigure) Set to true true if the Controller is auto configuring the number of ReadController and its associated thread pool size.
void	setConnectorHandlerPool(ConnectorHandlerPool connectorHandlerPool) Set the ConnectorHandlerPool used.
void	setDisplayConfiguration(boolean displayConfiguration) Display the internal configuration of this instance.
void	setExecutePendingIOUsingSelectorThread(boolean executePendingIOUsingSelectorThread) Set true, if selector thread has to be applied to execute I/O operation, or false (by default), meaning that I/O operation could be executed in the current thread.
void	setHandleReadWriteConcurrently(boolean handleReadWriteConcurrently) true if OP_ERAD and OP_WRITE can be handled concurrently.
void	setKernelExecutorFactory(Controller.KernelExecutorFactory kernelExecutorFactory) Set the factory, responsible for creating kernel ExecutorServices.
static void	setLogger(java.util.logging.Logger l) Set the Logger single instance to use.
void	setMaxAcceptRetries(int maxAcceptRetries) Max number of accept() failures before abording.
void	setProtocolChainInstanceHandler(ProtocolChainInstanceHandler instanceHandler) Set the ProtocolChainInstanceHandler to use for creating instance of ProtocolChain.
void	setReadThreadsCount(int readThreadsCount) Set the number of Reader threads count.
void	setSelectionKeyHandler(SelectionKeyHandler selectionKeyHandler) Deprecated. Set the SelectionKeyHandler to use for managing the life cycle of SelectionKey. Method is deprecated. Use SelectorHandler.setSelectionKeyHandler() instead
void	setSelectorHandler(SelectorHandler selectorHandler) Set the first SelectorHandler
void	setThreadPool(java.util.concurrent.ExecutorService threadPool) Set the ExecutorService (Thread Pool).
void	start() Start the Controller.
protected void	startSelectorHandlerRunner(SelectorHandler selectorHandler) Starts SelectorHandlerRunner
void	stop() Stop the Controller by canceling all the registered keys.
void	stop(boolean isAsync) Stop the Controller by canceling all the registered keys.
boolean	useLeaderFollowerStrategy() Is Leader/Follower strategy used?
void	useLeaderFollowerStrategy(boolean useLeaderFollowerStrategy) Set, if Leader/Follower strategy should be used.
protected void	waitUntilSelectorHandlersStop() Method waits until all initialized SelectorHandlers will not get stopped

Methods inherited from class java.lang.Object

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

Field Detail

instanceHandler

protected ProtocolChainInstanceHandler instanceHandler

The ProtocolChainInstanceHandler used by this instance. If not set, and instance of the DefaultInstanceHandler will be created.

selectionKeyHandler

protected SelectionKeyHandler selectionKeyHandler

The SelectionKey Handler used by this instance. If not set, and instance of the DefaultSelectionKeyHandler will be created.

multiReadThreadSelectorHandler

protected ComplexSelectorHandler multiReadThreadSelectorHandler

The SelectorHandler, which will manage connection accept, if readThreadsCount > 0 and spread connection processing between different read threads

connectorHandlerPool

protected ConnectorHandlerPool connectorHandlerPool

The ConnectorHandlerPool, which is responsible for creating/caching ConnectorHandler instances.

selectorHandlers

protected final java.util.Queue<SelectorHandler> selectorHandlers

The set of SelectorHandlers used by this instance. If not set, the instance of the TCPSelectorHandler will be added by default.

stateHolder

protected StateHolder<State> stateHolder

Current Controller state

readThreadsCount

protected int readThreadsCount

The number of read threads

readThreadControllers

protected ReadController[] readThreadControllers

The array of Controllers to be used for reading

logger

protected static java.util.logging.Logger logger

Default Logger.

threadPool

protected java.util.concurrent.ExecutorService threadPool

Default Thread Pool (called ExecutorService).If not set, and instance of the DefaultThreadPool will be created.

stateListeners

protected final java.util.Collection<ControllerStateListener> stateListeners

Collection of Controller state listeners, which will are notified on Controller state change.

readySelectorHandlerCounter

protected java.util.concurrent.atomic.AtomicInteger readySelectorHandlerCounter

Internal countdown counter of SelectorHandlers, which are ready to process

stoppedSelectorHandlerCounter

protected java.util.concurrent.atomic.AtomicInteger stoppedSelectorHandlerCounter

Internal countdown counter of SelectorHandlers, which stopped

attributes

protected java.util.Map<java.lang.String,java.lang.Object> attributes

Attributes, associated with the Controller instance

Constructor Detail

Controller

public Controller()

Controller constructor

Method Detail

registerKey

public void registerKey(java.nio.channels.SelectionKey key)

Register a SelectionKey.

Parameters:

key - SelectionKey to register

registerKey

public void registerKey(java.nio.channels.SelectionKey key,
                        int ops)

Register a SelectionKey on the first SelectorHandler that was added using the addSelectorHandler().

Parameters:

key - SelectionKey to register

ops - - the interest op to register

registerKey

public void registerKey(java.nio.channels.SelectionKey key,
                        int ops,
                        Controller.Protocol protocol)

Register a SelectionKey.

Parameters:

key - SelectionKey to register

ops - - the interest op to register

protocol - specified protocol SelectorHandler key should be registered on

cancelKey

public void cancelKey(java.nio.channels.SelectionKey key)

Deprecated.

Cancel a SelectionKey

Parameters:

key - SelectionKey to cancel

pollContext

public Context pollContext()

Get an instance of a NIOContext

Returns:

Context

configureContext

public void configureContext(java.nio.channels.SelectionKey key,
                             Context.OpType opType,
                             NIOContext ctx,
                             SelectorHandler selectorHandler)

Configure the Context

Parameters:

key - SelectionKey

opType - the current SelectionKey op.

ctx -

selectorHandler -

returnContext

public void returnContext(Context ctx)

Return a Context to its pool if it is not shared. if allowContextCaching is false, the instance is not cached.

Parameters:

ctx - - the Context

logger

public static java.util.logging.Logger logger()

Return the current Logger used by this Controller.

setLogger

public static void setLogger(java.util.logging.Logger l)

Set the Logger single instance to use.

setProtocolChainInstanceHandler

public void setProtocolChainInstanceHandler(ProtocolChainInstanceHandler instanceHandler)

Set the ProtocolChainInstanceHandler to use for creating instance of ProtocolChain.

getProtocolChainInstanceHandler

public ProtocolChainInstanceHandler getProtocolChainInstanceHandler()

Return the ProtocolChainInstanceHandler

setSelectionKeyHandler

public void setSelectionKeyHandler(SelectionKeyHandler selectionKeyHandler)

Deprecated. Set the SelectionKeyHandler to use for managing the life cycle of SelectionKey. Method is deprecated. Use SelectorHandler.setSelectionKeyHandler() instead

getSelectionKeyHandler

public SelectionKeyHandler getSelectionKeyHandler()

Deprecated. Return the SelectionKeyHandler Method is deprecated. Use SelectorHandler.getSelectionKeyHandler() instead

addSelectorHandler

public void addSelectorHandler(SelectorHandler selectorHandler)

Add a SelectorHandler

Parameters:

selectorHandler - - the SelectorHandler

setSelectorHandler

public void setSelectorHandler(SelectorHandler selectorHandler)

Set the first SelectorHandler

Parameters:

selectorHandler - - the SelectorHandler

getSelectorHandler

public SelectorHandler getSelectorHandler(Controller.Protocol protocol)

Return the SelectorHandler associated with the protocol.

Parameters:

protocol - - the Controller.Protocol

Returns:

SelectorHandler

getSelectorHandler

public SelectorHandler getSelectorHandler(java.nio.channels.Selector selector)

Return the SelectorHandler associated with the Selector.

Parameters:

selector - - the Selector

Returns:

SelectorHandler

getSelectorHandlers

public java.util.Queue getSelectorHandlers()

Return the list SelectorHandler

Returns:

Queue

removeSelectorHandler

public void removeSelectorHandler(SelectorHandler selectorHandler)

Shuts down SelectorHandler and removes it from this Controller list

Parameters:

{@link - SelectorHandler} to remove

getThreadPool

public java.util.concurrent.ExecutorService getThreadPool()

Return the ExecutorService (Thread Pool) used by this Controller.

setThreadPool

public void setThreadPool(java.util.concurrent.ExecutorService threadPool)

Set the ExecutorService (Thread Pool).

getReadThreadsCount

public int getReadThreadsCount()

Return the number of Reader threads count.

setReadThreadsCount

public void setReadThreadsCount(int readThreadsCount)

Set the number of Reader threads count.

getConnectorHandlerPool

public ConnectorHandlerPool getConnectorHandlerPool()

Return the ConnectorHandlerPool used.

setConnectorHandlerPool

public void setConnectorHandlerPool(ConnectorHandlerPool connectorHandlerPool)

Set the ConnectorHandlerPool used.

run

public void run()

Execute this Controller.

Specified by:

run in interface java.lang.Runnable

copyTo

public void copyTo(Copyable copy)

Copy this Controller state to another instance of a Controller.

Specified by:

copyTo in interface Copyable

addStateListener

public void addStateListener(ControllerStateListener stateListener)

Add controller state listener

removeStateListener

public void removeStateListener(ControllerStateListener stateListener)

Remove controller state listener

notifyStarted

public void notifyStarted()

Notify controller started

notifyReady

public void notifyReady()

Notify controller is ready

notifyStopped

public void notifyStopped()

Notify controller stopped

notifyException

public void notifyException(java.lang.Throwable e)

Notify exception occured

logVersion

public void logVersion()

Log the current Grizzly version.

start

public void start()
           throws java.io.IOException

Start the Controller. If the thread pool and/or Handler has not been defined, the default will be used.

Specified by:

start in interface Lifecycle

Throws:

java.io.IOException

stop

public void stop()
          throws java.io.IOException

Stop the Controller by canceling all the registered keys.

Specified by:

stop in interface Lifecycle

Throws:

java.io.IOException

stop

public void stop(boolean isAsync)
          throws java.io.IOException

Stop the Controller by canceling all the registered keys.

Parameters:

isAsync, - true if controller should be stopped asynchronously and control returned immediately. If false - control will be returned after Controller will be completely stopped.

Throws:

java.io.IOException

pause

public void pause()
           throws java.io.IOException

Pause this Controller and associated SelectorHandlers

Specified by:

pause in interface Lifecycle

Throws:

java.io.IOException

resume

public void resume()
            throws java.io.IOException

Resume this Controller and associated SelectorHandlers

Specified by:

resume in interface Lifecycle

Throws:

java.io.IOException

getStateHolder

public StateHolder<State> getStateHolder()

Gets this Controller's StateHolder

Specified by:

getStateHolder in interface SupportStateHolder<State>

Returns:

StateHolder

startSelectorHandlerRunner

protected void startSelectorHandlerRunner(SelectorHandler selectorHandler)

Starts SelectorHandlerRunner

Parameters:

selectorHandler -

isStarted

public boolean isStarted()

Is this Controller started?

Returns:

boolean true / false

acquireConnectorHandler

public ConnectorHandler acquireConnectorHandler(Controller.Protocol protocol)

Return an instance of a ConnectorHandler based on the Protocol requested.

Specified by:

acquireConnectorHandler in interface ConnectorHandlerPool

Parameters:

protocol - a Controller.Protocol

Returns:

ConnectorHandler

releaseConnectorHandler

public void releaseConnectorHandler(ConnectorHandler connectorHandler)

Return a ConnectorHandler to the pool of ConnectorHandler. Any reference to the returned must not be re-used as that instance can always be acquired again, causing unexpected results.

Specified by:

releaseConnectorHandler in interface ConnectorHandlerPool

Parameters:

connectorHandler - - a ConnectorHandler

isHandleReadWriteConcurrently

public boolean isHandleReadWriteConcurrently()

true if OP_ERAD and OP_WRITE can be handled concurrently. If false, the Controller will first invoke the OP_READ handler and then invoke the OP_WRITE during the next Selector.select() invocation.

setHandleReadWriteConcurrently

public void setHandleReadWriteConcurrently(boolean handleReadWriteConcurrently)

true if OP_ERAD and OP_WRITE can be handled concurrently. If false, the Controller will first invoke the OP_READ handler and then invoke the OP_WRITE during the next Selector.select() invocation.

waitUntilSelectorHandlersStop

protected void waitUntilSelectorHandlersStop()

Method waits until all initialized SelectorHandlers will not get stopped

removeAttribute

public java.lang.Object removeAttribute(java.lang.String key)

Remove a key/value object. Method is not thread safe

Specified by:

removeAttribute in interface AttributeHolder

Parameters:

key - - name of an attribute

Returns:

attribute which has been removed

setAttribute

public void setAttribute(java.lang.String key,
                         java.lang.Object value)

Set a key/value object. Method is not thread safe

Specified by:

setAttribute in interface AttributeHolder

Parameters:

key - - name of an attribute

value - - value of named attribute

getAttribute

public java.lang.Object getAttribute(java.lang.String key)

Return an object based on a key. Method is not thread safe

Specified by:

getAttribute in interface AttributeHolder

Parameters:

key - - name of an attribute

Returns:

- attribute value for the key, null if key does not exist in attributes

setAttributes

public void setAttributes(java.util.Map<java.lang.String,java.lang.Object> attributes)

Set a Map of attribute name/value pairs. Old AttributeHolder values will not be available. Later changes of this Map will lead to changes to the current AttributeHolder.

Specified by:

setAttributes in interface AttributeHolder

Parameters:

attributes - - map of name/value pairs

getAttributes

public java.util.Map<java.lang.String,java.lang.Object> getAttributes()

Return a Map of attribute name/value pairs. Updates, performed on the returned Map will be reflected in this AttributeHolder

Specified by:

getAttributes in interface AttributeHolder

Returns:

- Map of attribute name/value pairs

getHandlerController

public static Controller getHandlerController(Handler handler)

Return the Controller which is handling the Handler

Parameters:

handler - The handler (like SelectorHandler)

Returns:

The Controller associated with the Handler, or null if not associated.

executeUsingKernelExecutor

protected void executeUsingKernelExecutor()

Execute the run() using the internal/kernel Executors

executeUsingKernelExecutor

public void executeUsingKernelExecutor(java.lang.Runnable r)

Execute the Runnable using the internal kernel Executors. Do not invoke that method for application's task as this is the ExecutorService used internally to spawn Thread.

Parameters:

r - a Runnable

createKernelExecutor

protected java.util.concurrent.ExecutorService createKernelExecutor()

Create the ExecutorService used to execute kernel like operations.

isAllowContextCaching

public boolean isAllowContextCaching()

Are Context instance cached/pooled or a new instance gets created for every transaction?

Returns:

true if Context get cached. Default is false

setAllowContextCaching

public void setAllowContextCaching(boolean allowContextCaching)

Set to true for enabling caching of Context.

Parameters:

allowContextCaching - true for enabling caching of Context.

useLeaderFollowerStrategy

public boolean useLeaderFollowerStrategy()

Is Leader/Follower strategy used?

Returns:

true, if Leader/follower strategy is used, or false otherwise.

useLeaderFollowerStrategy

public void useLeaderFollowerStrategy(boolean useLeaderFollowerStrategy)

Set, if Leader/Follower strategy should be used.

Parameters:

useLeaderFollowerStrategy - true, if Leader/follower strategy should be used, or false otherwise.

isAutoConfigure

public boolean isAutoConfigure()

Return true if the Controller is auto configuring the number of ReadController and its associated thread pool size.

Returns:

the autoConfigure

setAutoConfigure

public void setAutoConfigure(boolean autoConfigure)

Set to true true if the Controller is auto configuring the number of ReadController and its associated thread pool size.

Parameters:

autoConfigure - the autoConfigure to set

isExecutePendingIOUsingSelectorThread

public boolean isExecutePendingIOUsingSelectorThread()

Return true, if selector thread has to be applied to execute I/O operation, or false (by default), meaning that I/O operation could be executed in the current thread.

Returns:

the executePendingIOUsingSelectorThread

setExecutePendingIOUsingSelectorThread

public void setExecutePendingIOUsingSelectorThread(boolean executePendingIOUsingSelectorThread)

Set true, if selector thread has to be applied to execute I/O operation, or false (by default), meaning that I/O operation could be executed in the current thread. It's not safe to change this value, when TCPSelectorHandler has been already started.

Parameters:

executePendingIOUsingSelectorThread - the executePendingIOUsingSelectorThread to set

getKernelExecutorFactory

public Controller.KernelExecutorFactory getKernelExecutorFactory()

Get the factory, responsible for creating kernel ExecutorServices.

Returns:

the factory, responsible for creating kernel ExecutorServices.

setKernelExecutorFactory

public void setKernelExecutorFactory(Controller.KernelExecutorFactory kernelExecutorFactory)

Set the factory, responsible for creating kernel ExecutorServices.

Parameters:

kernelExecutorFactory - the factory, responsible for creating kernel ExecutorServices.

setMaxAcceptRetries

public void setMaxAcceptRetries(int maxAcceptRetries)

Max number of accept() failures before abording.

Parameters:

maxAcceptRetries -

setDisplayConfiguration

public void setDisplayConfiguration(boolean displayConfiguration)

Display the internal configuration of this instance.