org.eclipse.jetty.io

Class SelectorManager

java.lang.Object

org.eclipse.jetty.util.component.AbstractLifeCycle

org.eclipse.jetty.util.component.ContainerLifeCycle

org.eclipse.jetty.io.SelectorManager

All Implemented Interfaces:

Container, Destroyable, Dumpable, LifeCycle

public abstract class SelectorManager
extends ContainerLifeCycle
implements Dumpable

SelectorManager manages a number of ManagedSelectors that simplify the non-blocking primitives provided by the JVM via the java.nio package.

SelectorManager subclasses implement methods to return protocol-specific EndPoints and Connections.

Nested Class Summary

Nested classes/interfaces inherited from class org.eclipse.jetty.util.component.AbstractLifeCycle

AbstractLifeCycle.AbstractLifeCycleListener

Nested classes/interfaces inherited from interface org.eclipse.jetty.util.component.Container

Container.InheritedListener, Container.Listener

Nested classes/interfaces inherited from interface org.eclipse.jetty.util.component.LifeCycle

LifeCycle.Listener

Field Summary

Fields

Modifier and Type	Field and Description
static int	DEFAULT_CONNECT_TIMEOUT
protected static Logger	LOG

Fields inherited from class org.eclipse.jetty.util.component.AbstractLifeCycle

FAILED, RUNNING, STARTED, STARTING, STOPPED, STOPPING

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	SelectorManager(Executor executor, Scheduler scheduler)
protected	SelectorManager(Executor executor, Scheduler scheduler, int selectors)

Method Summary

Modifier and Type	Method and Description
void	accept(SocketChannel channel)
void	accept(SocketChannel channel, Object attachment) Registers a channel to perform non-blocking read/write operations.
protected void	accepted(SocketChannel channel) Callback method when a channel is accepted from the ServerSocketChannel passed to acceptor(ServerSocketChannel).
void	acceptor(ServerSocketChannel server) Registers a server channel for accept operations.
void	connect(SocketChannel channel, Object attachment) Registers a channel to perform a non-blocking connect.
void	connectionClosed(Connection connection) Callback method invoked when a connection is closed.
protected void	connectionFailed(SocketChannel channel, Throwable ex, Object attachment) Callback method invoked when a non-blocking connect cannot be completed.
void	connectionOpened(Connection connection) Callback method invoked when a connection is opened.
protected void	doStart()
protected void	doStop()
protected void	endPointClosed(EndPoint endpoint) Callback method invoked when an endpoint is closed.
protected void	endPointOpened(EndPoint endpoint) Callback method invoked when an endpoint is opened.
protected void	execute(Runnable task) Executes the given task in a different thread.
protected boolean	finishConnect(SocketChannel channel)
long	getConnectTimeout() Get the connect timeout
ExecutionStrategy.Factory	getExecutionStrategyFactory()
Executor	getExecutor()
Scheduler	getScheduler()
int	getSelectorCount()
int	getSelectorPriorityDelta() Deprecated. not implemented
abstract Connection	newConnection(SocketChannel channel, EndPoint endpoint, Object attachment) Factory method to create Connection.
protected abstract EndPoint	newEndPoint(SocketChannel channel, ManagedSelector selector, SelectionKey selectionKey) Factory method to create EndPoint.
protected ManagedSelector	newSelector(int id) Factory method for ManagedSelector.
void	setConnectTimeout(long milliseconds) Set the connect timeout (in milliseconds)
void	setExecutionStrategyFactory(ExecutionStrategy.Factory _executionFactory)
void	setSelectorPriorityDelta(int selectorPriorityDelta) Deprecated. not implemented

Methods inherited from class org.eclipse.jetty.util.component.ContainerLifeCycle

addBean, addBean, addBean, addEventListener, addManaged, contains, destroy, dump, dump, dump, dump, dump, dumpBeans, dumpObject, dumpStdErr, dumpThis, getBean, getBeans, getBeans, isManaged, manage, removeBean, removeBeans, removeEventListener, setBeans, setStopTimeout, start, stop, unmanage, updateBean, updateBean, updateBeans

Methods inherited from class org.eclipse.jetty.util.component.AbstractLifeCycle

addLifeCycleListener, getState, getState, getStopTimeout, isFailed, isRunning, isStarted, isStarting, isStopped, isStopping, removeLifeCycleListener, start, stop

Methods inherited from class java.lang.Object

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

Methods inherited from interface org.eclipse.jetty.util.component.Dumpable

dump, dump

Field Detail

DEFAULT_CONNECT_TIMEOUT

public static final int DEFAULT_CONNECT_TIMEOUT

See Also:

Constant Field Values

LOG

protected static final Logger LOG

Constructor Detail

SelectorManager

protected SelectorManager(Executor executor,
                          Scheduler scheduler)

SelectorManager

protected SelectorManager(Executor executor,
                          Scheduler scheduler,
                          int selectors)

Method Detail

getExecutor

public Executor getExecutor()

getScheduler

public Scheduler getScheduler()

getConnectTimeout

public long getConnectTimeout()

Get the connect timeout

Returns:

the connect timeout (in milliseconds)

setConnectTimeout

public void setConnectTimeout(long milliseconds)

Set the connect timeout (in milliseconds)

Parameters:

milliseconds - the number of milliseconds for the timeout

getExecutionStrategyFactory

public ExecutionStrategy.Factory getExecutionStrategyFactory()

Returns:

the ExecutionStrategy.Factory used by ManagedSelector

setExecutionStrategyFactory

public void setExecutionStrategyFactory(ExecutionStrategy.Factory _executionFactory)

Parameters:

_executionFactory - the ExecutionStrategy.Factory used by ManagedSelector

getSelectorPriorityDelta

@Deprecated
public int getSelectorPriorityDelta()

Deprecated. not implemented

Returns:

the selector priority delta

setSelectorPriorityDelta

@Deprecated
public void setSelectorPriorityDelta(int selectorPriorityDelta)

Deprecated. not implemented

Parameters:

selectorPriorityDelta - the selector priority delta

execute

protected void execute(Runnable task)

Executes the given task in a different thread.

Parameters:

task - the task to execute

getSelectorCount

public int getSelectorCount()

Returns:

the number of selectors in use

connect

public void connect(SocketChannel channel,
                    Object attachment)

Registers a channel to perform a non-blocking connect.

The channel must be set in non-blocking mode, SocketChannel.connect(SocketAddress) must be called prior to calling this method, and the connect operation must not be completed (the return value of SocketChannel.connect(SocketAddress) must be false).

Parameters:

channel - the channel to register

attachment - the attachment object

See Also:

accept(SocketChannel, Object)

accept

public void accept(SocketChannel channel)

Parameters:

channel - the channel to accept

See Also:

accept(SocketChannel, Object)

accept

public void accept(SocketChannel channel,
                   Object attachment)

Registers a channel to perform non-blocking read/write operations.

This method is called just after a channel has been accepted by ServerSocketChannel.accept(), or just after having performed a blocking connect via Socket.connect(SocketAddress, int), or just after a non-blocking connect via SocketChannel.connect(SocketAddress) that completed successfully.

Parameters:

channel - the channel to register

attachment - the attachment object

acceptor

public void acceptor(ServerSocketChannel server)

Registers a server channel for accept operations. When a SocketChannel is accepted from the given ServerSocketChannel then the accepted(SocketChannel) method is called, which must be overridden by a derivation of this class to handle the accepted channel

Parameters:

server - the server channel to register

accepted

protected void accepted(SocketChannel channel)
                 throws IOException

Callback method when a channel is accepted from the ServerSocketChannel passed to acceptor(ServerSocketChannel). The default impl throws an UnsupportedOperationException, so it must be overridden by subclasses if a server channel is provided.

Parameters:

channel - the

Throws:

IOException - if unable to accept channel

doStart

protected void doStart()
                throws Exception

Overrides:

doStart in class ContainerLifeCycle

Throws:

Exception

newSelector

protected ManagedSelector newSelector(int id)

Factory method for ManagedSelector.

Parameters:

id - an identifier for the to create

Returns:

a new ManagedSelector

doStop

protected void doStop()
               throws Exception

Overrides:

doStop in class ContainerLifeCycle

Throws:

Exception

endPointOpened

protected void endPointOpened(EndPoint endpoint)

Callback method invoked when an endpoint is opened.

Parameters:

endpoint - the endpoint being opened

endPointClosed

protected void endPointClosed(EndPoint endpoint)

Callback method invoked when an endpoint is closed.

Parameters:

endpoint - the endpoint being closed

connectionOpened

public void connectionOpened(Connection connection)

Callback method invoked when a connection is opened.

Parameters:

connection - the connection just opened

connectionClosed

public void connectionClosed(Connection connection)

Callback method invoked when a connection is closed.

Parameters:

connection - the connection just closed

finishConnect

protected boolean finishConnect(SocketChannel channel)
                         throws IOException

Throws:

IOException

connectionFailed

protected void connectionFailed(SocketChannel channel,
                                Throwable ex,
                                Object attachment)

Callback method invoked when a non-blocking connect cannot be completed.

By default it just logs with level warning.

Parameters:

channel - the channel that attempted the connect

ex - the exception that caused the connect to fail

attachment - the attachment object associated at registration

newEndPoint

protected abstract EndPoint newEndPoint(SocketChannel channel,
                                        ManagedSelector selector,
                                        SelectionKey selectionKey)
                                 throws IOException

Factory method to create EndPoint.

This method is invoked as a result of the registration of a channel via connect(SocketChannel, Object) or accept(SocketChannel).

Parameters:

channel - the channel associated to the endpoint

selector - the selector the channel is registered to

selectionKey - the selection key

Returns:

a new endpoint

Throws:

IOException - if the endPoint cannot be created

See Also:

newConnection(SocketChannel, EndPoint, Object)

newConnection

public abstract Connection newConnection(SocketChannel channel,
                                         EndPoint endpoint,
                                         Object attachment)
                                  throws IOException

Factory method to create Connection.

Parameters:

channel - the channel associated to the connection

endpoint - the endpoint

attachment - the attachment

Returns:

a new connection

Throws:

IOException - if unable to create new connection

See Also:

newEndPoint(SocketChannel, ManagedSelector, SelectionKey)