Package org.apache.mina.transport.socket.nio

Class NioProcessor

java.lang.Object

org.apache.mina.core.polling.AbstractPollingIoProcessor<NioSession>

org.apache.mina.transport.socket.nio.NioProcessor

All Implemented Interfaces:

IoProcessor<NioSession>

public class NioProcessor
extends AbstractPollingIoProcessor<NioSession>

A processor for incoming and outgoing data get and written on a TCP socket.

Author:

Apache MINA Project

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
protected static class	NioProcessor.IoSessionIterator<NioSession>	An encapsulating iterator around the Selector.selectedKeys() or the Selector.keys() iterator;

Field Summary

Fields

Modifier and Type	Field	Description
protected Selector	selector	The selector associated with this processor
protected ReadWriteLock	selectorLock	A lock used to protect concurent access to the selector
protected SelectorProvider	selectorProvider

Fields inherited from class org.apache.mina.core.polling.AbstractPollingIoProcessor

wakeupCalled

Constructor Summary

Constructors

Constructor	Description
NioProcessor(Executor executor)	Creates a new instance of NioProcessor.
NioProcessor(Executor executor, SelectorProvider selectorProvider)	Creates a new instance of NioProcessor.

Method Summary

Modifier and Type	Method	Description
protected Iterator<NioSession>	allSessions()	Get an Iterator for the list of IoSession polled by this IoProcessor
protected int	allSessionsCount()	Get the number of IoSession polled by this IoProcessor
protected void	destroy(NioSession session)	Destroy the underlying client socket handle
protected void	doDispose()	Dispose the resources used by this IoProcessor for polling the client connections.
protected SessionState	getState(NioSession session)	Get the state of a session (One of OPENING, OPEN, CLOSING)
protected void	init(NioSession session)	Initialize the polling of a session.
protected boolean	isBrokenConnection()	Check that the select() has not exited immediately just because of a broken connection.
protected boolean	isInterestedInRead(NioSession session)	Tells if this session is registered for reading
protected boolean	isInterestedInWrite(NioSession session)	Tells if this session is registered for writing
protected boolean	isReadable(NioSession session)	Tells if the session ready for reading
protected boolean	isSelectorEmpty()	Say if the list of IoSession polled by this IoProcessor is empty
protected boolean	isWritable(NioSession session)	Tells if the session ready for writing
protected int	read(NioSession session, IoBuffer buf)	Reads a sequence of bytes from a IoSession into the given IoBuffer.
protected void	registerNewSelector()	In the case we are using the java select() method, this method is used to trash the buggy selector and create a new one, registering all the sockets on it.
protected int	select()	poll those sessions forever
protected int	select(long timeout)	poll those sessions for the given timeout
protected Iterator<NioSession>	selectedSessions()	Get an Iterator for the list of IoSession found selected by the last call of AbstractPollingIoProcessor.select(long)
protected void	setInterestedInRead(NioSession session, boolean isInterested)	Set the session to be informed when a read event should be processed
protected void	setInterestedInWrite(NioSession session, boolean isInterested)	Set the session to be informed when a write event should be processed
protected int	transferFile(NioSession session, FileRegion region, int length)	Write a part of a file to a IoSession, if the underlying API isn't supporting system calls like sendfile(), you can throw a UnsupportedOperationException so the file will be send using usual AbstractPollingIoProcessor.write(AbstractIoSession, IoBuffer, int) call.
protected void	wakeup()	Interrupt the AbstractPollingIoProcessor.select(long) call.
protected int	write(NioSession session, IoBuffer buf, int length)	Write a sequence of bytes to a IoSession, means to be called when a session was found ready for writing.

Methods inherited from class org.apache.mina.core.polling.AbstractPollingIoProcessor

add, dispose, flush, isDisposed, isDisposing, remove, updateTrafficControl, updateTrafficMask, write

Methods inherited from class java.lang.Object

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

Field Detail

selector

protected Selector selector

The selector associated with this processor

selectorLock

protected ReadWriteLock selectorLock

A lock used to protect concurent access to the selector

selectorProvider

protected SelectorProvider selectorProvider

Constructor Detail

NioProcessor

public NioProcessor(Executor executor)

Creates a new instance of NioProcessor.

Parameters:

executor - The executor to use

NioProcessor

public NioProcessor(Executor executor,
                    SelectorProvider selectorProvider)

Creates a new instance of NioProcessor.

Parameters:

executor - The executor to use

selectorProvider - The Selector provider to use

Method Detail

doDispose

protected void doDispose()
                  throws Exception

Description copied from class: AbstractPollingIoProcessor

Dispose the resources used by this IoProcessor for polling the client connections. The implementing class doDispose method will be called.

Specified by:

doDispose in class AbstractPollingIoProcessor<NioSession>

Throws:

Exception - if some low level IO error occurs

select

protected int select(long timeout)
              throws Exception

Description copied from class: AbstractPollingIoProcessor

poll those sessions for the given timeout

Specified by:

select in class AbstractPollingIoProcessor<NioSession>

Parameters:

timeout - milliseconds before the call timeout if no event appear

Returns:

The number of session ready for read or for write

Throws:

Exception - if some low level IO error occurs

select

protected int select()
              throws Exception

Description copied from class: AbstractPollingIoProcessor

poll those sessions forever

Specified by:

select in class AbstractPollingIoProcessor<NioSession>

Returns:

The number of session ready for read or for write

Throws:

Exception - if some low level IO error occurs

isSelectorEmpty

protected boolean isSelectorEmpty()

Description copied from class: AbstractPollingIoProcessor

Say if the list of IoSession polled by this IoProcessor is empty

Specified by:

isSelectorEmpty in class AbstractPollingIoProcessor<NioSession>

Returns:

true if at least a session is managed by this IoProcessor

wakeup

protected void wakeup()

Description copied from class: AbstractPollingIoProcessor

Interrupt the AbstractPollingIoProcessor.select(long) call.

Specified by:

wakeup in class AbstractPollingIoProcessor<NioSession>

allSessions

protected Iterator<NioSession> allSessions()

Description copied from class: AbstractPollingIoProcessor

Get an Iterator for the list of IoSession polled by this IoProcessor

Specified by:

allSessions in class AbstractPollingIoProcessor<NioSession>

Returns:

Iterator of IoSession

allSessionsCount

protected int allSessionsCount()

Description copied from class: AbstractPollingIoProcessor

Get the number of IoSession polled by this IoProcessor

Specified by:

allSessionsCount in class AbstractPollingIoProcessor<NioSession>

Returns:

the number of sessions attached to this IoProcessor

selectedSessions

protected Iterator<NioSession> selectedSessions()

Description copied from class: AbstractPollingIoProcessor

Get an Iterator for the list of IoSession found selected by the last call of AbstractPollingIoProcessor.select(long)

Specified by:

selectedSessions in class AbstractPollingIoProcessor<NioSession>

Returns:

Iterator of IoSession read for I/Os operation

init

protected void init(NioSession session)
             throws Exception

Description copied from class: AbstractPollingIoProcessor

Initialize the polling of a session. Add it to the polling process.

Specified by:

init in class AbstractPollingIoProcessor<NioSession>

Parameters:

session - the IoSession to add to the polling

Throws:

Exception - any exception thrown by the underlying system calls

destroy

protected void destroy(NioSession session)
                throws Exception

Description copied from class: AbstractPollingIoProcessor

Destroy the underlying client socket handle

Specified by:

destroy in class AbstractPollingIoProcessor<NioSession>

Parameters:

session - the IoSession

Throws:

Exception - any exception thrown by the underlying system calls

registerNewSelector

protected void registerNewSelector()
                            throws IOException

In the case we are using the java select() method, this method is used to trash the buggy selector and create a new one, registering all the sockets on it.

Specified by:

registerNewSelector in class AbstractPollingIoProcessor<NioSession>

Throws:

IOException - If we got an exception

isBrokenConnection

protected boolean isBrokenConnection()
                              throws IOException

Check that the select() has not exited immediately just because of a broken connection. In this case, this is a standard case, and we just have to loop.

Specified by:

isBrokenConnection in class AbstractPollingIoProcessor<NioSession>

Returns:

true if a connection has been brutally closed.

Throws:

IOException - If we got an exception

getState

protected SessionState getState(NioSession session)

Get the state of a session (One of OPENING, OPEN, CLOSING)

Specified by:

getState in class AbstractPollingIoProcessor<NioSession>

Parameters:

session - the IoSession to inspect

Returns:

the state of the session

isReadable

protected boolean isReadable(NioSession session)

Description copied from class: AbstractPollingIoProcessor

Tells if the session ready for reading

Specified by:

isReadable in class AbstractPollingIoProcessor<NioSession>

Parameters:

session - the queried session

Returns:

true is ready, false if not ready

isWritable

protected boolean isWritable(NioSession session)

Description copied from class: AbstractPollingIoProcessor

Tells if the session ready for writing

Specified by:

isWritable in class AbstractPollingIoProcessor<NioSession>

Parameters:

session - the queried session

Returns:

true is ready, false if not ready

isInterestedInRead

protected boolean isInterestedInRead(NioSession session)

Description copied from class: AbstractPollingIoProcessor

Tells if this session is registered for reading

Specified by:

isInterestedInRead in class AbstractPollingIoProcessor<NioSession>

Parameters:

session - the queried session

Returns:

true is registered for reading

isInterestedInWrite

protected boolean isInterestedInWrite(NioSession session)

Description copied from class: AbstractPollingIoProcessor

Tells if this session is registered for writing

Specified by:

isInterestedInWrite in class AbstractPollingIoProcessor<NioSession>

Parameters:

session - the queried session

Returns:

true is registered for writing

setInterestedInRead

protected void setInterestedInRead(NioSession session,
                                   boolean isInterested)
                            throws Exception

Set the session to be informed when a read event should be processed

Specified by:

setInterestedInRead in class AbstractPollingIoProcessor<NioSession>

Parameters:

session - the session for which we want to be interested in read events

isInterested - true for registering, false for removing

Throws:

Exception - If there was a problem while registering the session

setInterestedInWrite

protected void setInterestedInWrite(NioSession session,
                                    boolean isInterested)
                             throws Exception

Set the session to be informed when a write event should be processed

Specified by:

setInterestedInWrite in class AbstractPollingIoProcessor<NioSession>

Parameters:

session - the session for which we want to be interested in write events

isInterested - true for registering, false for removing

Throws:

Exception - If there was a problem while registering the session

read

protected int read(NioSession session,
                   IoBuffer buf)
            throws Exception

Description copied from class: AbstractPollingIoProcessor

Reads a sequence of bytes from a IoSession into the given IoBuffer. Is called when the session was found ready for reading.

Specified by:

read in class AbstractPollingIoProcessor<NioSession>

Parameters:

session - the session to read

buf - the buffer to fill

Returns:

the number of bytes read

Throws:

Exception - any exception thrown by the underlying system calls

write

protected int write(NioSession session,
                    IoBuffer buf,
                    int length)
             throws IOException

Description copied from class: AbstractPollingIoProcessor

Write a sequence of bytes to a IoSession, means to be called when a session was found ready for writing.

Specified by:

write in class AbstractPollingIoProcessor<NioSession>

Parameters:

session - the session to write

buf - the buffer to write

length - the number of bytes to write can be superior to the number of bytes remaining in the buffer

Returns:

the number of byte written

Throws:

IOException - any exception thrown by the underlying system calls

transferFile

protected int transferFile(NioSession session,
                           FileRegion region,
                           int length)
                    throws Exception

Description copied from class: AbstractPollingIoProcessor

Write a part of a file to a IoSession, if the underlying API isn't supporting system calls like sendfile(), you can throw a UnsupportedOperationException so the file will be send using usual AbstractPollingIoProcessor.write(AbstractIoSession, IoBuffer, int) call.

Specified by:

transferFile in class AbstractPollingIoProcessor<NioSession>

Parameters:

session - the session to write

region - the file region to write

length - the length of the portion to send

Returns:

the number of written bytes

Throws:

Exception - any exception thrown by the underlying system calls