Package org.apache.mina.handler.multiton

Class SingleSessionIoHandlerDelegate

java.lang.Object

org.apache.mina.handler.multiton.SingleSessionIoHandlerDelegate

All Implemented Interfaces:

IoHandler

@Deprecated
public class SingleSessionIoHandlerDelegate
extends Object
implements IoHandler

Deprecated.

This class is deprecated

An IoHandler implementation which delegates all requests to SingleSessionIoHandlers. A SingleSessionIoHandlerFactory is used to create a new SingleSessionIoHandler for each newly created session. WARNING : This IoHandler implementation may be easier to understand and thus to use but the user should be aware that creating one handler by session will lower scalability if building an high performance server. This should only be used with very specific needs in mind.

Author:

Apache MINA Project

Field Summary

Fields

Modifier and Type	Field	Description
static AttributeKey	HANDLER	Deprecated. The key used to store the SingleSessionIoHandler as a session attribute.

Constructor Summary

Constructors

Constructor	Description
SingleSessionIoHandlerDelegate(SingleSessionIoHandlerFactory factory)	Deprecated. Creates a new instance that uses the passed in SingleSessionIoHandlerFactory to create new SingleSessionIoHandlers.

Method Summary

Modifier and Type	Method	Description
void	event(IoSession session, FilterEvent event)	Deprecated. Delegates the method call to the SingleSessionIoHandler.event(FilterEvent) method of the handler assigned to this session.
void	exceptionCaught(IoSession session, Throwable cause)	Deprecated. Delegates the method call to the SingleSessionIoHandler.exceptionCaught(Throwable) method of the handler assigned to this session.
SingleSessionIoHandlerFactory	getFactory()	Deprecated.
void	inputClosed(IoSession session)	Deprecated. Handle the closure of an half-duplex TCP channel
void	messageReceived(IoSession session, Object message)	Deprecated. Delegates the method call to the SingleSessionIoHandler.messageReceived(Object) method of the handler assigned to this session.
void	messageSent(IoSession session, Object message)	Deprecated. Delegates the method call to the SingleSessionIoHandler.messageSent(Object) method of the handler assigned to this session.
void	sessionClosed(IoSession session)	Deprecated. Delegates the method call to the SingleSessionIoHandler.sessionClosed() method of the handler assigned to this session.
void	sessionCreated(IoSession session)	Deprecated. Creates a new instance with the factory passed to the constructor of this class.
void	sessionIdle(IoSession session, IdleStatus status)	Deprecated. Delegates the method call to the SingleSessionIoHandler.sessionIdle(IdleStatus) method of the handler assigned to this session.
void	sessionOpened(IoSession session)	Deprecated. Delegates the method call to the SingleSessionIoHandler.sessionOpened() method of the handler assigned to this session.

Methods inherited from class java.lang.Object

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

Field Detail

HANDLER

public static final AttributeKey HANDLER

Deprecated.

The key used to store the SingleSessionIoHandler as a session attribute.

Constructor Detail

SingleSessionIoHandlerDelegate

public SingleSessionIoHandlerDelegate(SingleSessionIoHandlerFactory factory)

Deprecated.

Creates a new instance that uses the passed in SingleSessionIoHandlerFactory to create new SingleSessionIoHandlers.

Parameters:

factory - the factory for SingleSessionIoHandlers

Method Detail

getFactory

public SingleSessionIoHandlerFactory getFactory()

Deprecated.

Returns:

the SingleSessionIoHandlerFactory that is used to create a new SingleSessionIoHandler instance.

sessionCreated

public void sessionCreated(IoSession session)
                    throws Exception

Deprecated.

Creates a new instance with the factory passed to the constructor of this class. The created handler is stored as a session attribute named HANDLER.

Specified by:

sessionCreated in interface IoHandler

Parameters:

session - The session being created

Throws:

Exception - If we get an exception while processing the create event

See Also:

IoHandler.sessionCreated(org.apache.mina.core.session.IoSession)

sessionOpened

public void sessionOpened(IoSession session)
                   throws Exception

Deprecated.

Delegates the method call to the SingleSessionIoHandler.sessionOpened() method of the handler assigned to this session. Invoked when a connection has been opened. This method is invoked after IoHandler.sessionCreated(IoSession). The biggest difference from IoHandler.sessionCreated(IoSession) is that it's invoked from other thread than an I/O processor thread once thread model is configured properly.

Specified by:

sessionOpened in interface IoHandler

Parameters:

session - The session being opened

Throws:

Exception - If we get an exception while processing the open event

sessionClosed

public void sessionClosed(IoSession session)
                   throws Exception

Deprecated.

Delegates the method call to the SingleSessionIoHandler.sessionClosed() method of the handler assigned to this session. Invoked when a connection is closed.

Specified by:

sessionClosed in interface IoHandler

Parameters:

session - The session being closed

Throws:

Exception - If we get an exception while processing the close event

sessionIdle

public void sessionIdle(IoSession session,
                        IdleStatus status)
                 throws Exception

Deprecated.

Delegates the method call to the SingleSessionIoHandler.sessionIdle(IdleStatus) method of the handler assigned to this session. Invoked with the related IdleStatus when a connection becomes idle. This method is not invoked if the transport type is UDP; it's a known bug, and will be fixed in 2.0.

Specified by:

sessionIdle in interface IoHandler

Parameters:

session - The idling session

status - The session's status

Throws:

Exception - If we get an exception while processing the idle event

exceptionCaught

public void exceptionCaught(IoSession session,
                            Throwable cause)
                     throws Exception

Deprecated.

Delegates the method call to the SingleSessionIoHandler.exceptionCaught(Throwable) method of the handler assigned to this session. Invoked when any exception is thrown by user IoHandler implementation or by MINA. If cause is an instance of IOException, MINA will close the connection automatically.

Specified by:

exceptionCaught in interface IoHandler

Parameters:

session - The session for which we have got an exception

cause - The exception that has been caught

Throws:

Exception - If we get an exception while processing the caught exception

messageReceived

public void messageReceived(IoSession session,
                            Object message)
                     throws Exception

Deprecated.

Delegates the method call to the SingleSessionIoHandler.messageReceived(Object) method of the handler assigned to this session. Invoked when a message is received.

Specified by:

messageReceived in interface IoHandler

Parameters:

session - The session that is receiving a message

message - The received message

Throws:

Exception - If we get an exception while processing the received message

messageSent

public void messageSent(IoSession session,
                        Object message)
                 throws Exception

Deprecated.

Delegates the method call to the SingleSessionIoHandler.messageSent(Object) method of the handler assigned to this session. Invoked when a message written by IoSession.write(Object) is sent out.

Specified by:

messageSent in interface IoHandler

Parameters:

session - The session that has sent a full message

message - The sent message

Throws:

Exception - If we get an exception while processing the sent message

inputClosed

public void inputClosed(IoSession session)
                 throws Exception

Deprecated.

Handle the closure of an half-duplex TCP channel

Specified by:

inputClosed in interface IoHandler

Parameters:

session - The session which input is being closed

Throws:

Exception - If we get an exception while closing the input

event

public void event(IoSession session,
                  FilterEvent event)
           throws Exception

Deprecated.

Delegates the method call to the SingleSessionIoHandler.event(FilterEvent) method of the handler assigned to this session. Invoked when a filter event is fired. Each filter might sent a different event, this is very application specific.

Specified by:

event in interface IoHandler

Parameters:

session - The session for which we have an event to process

event - The event to process

Throws:

Exception - If we get an exception while processing the event