Package org.apache.mina.common
Interface IoHandler
- All Known Implementing Classes:
ChainedIoHandler,DemuxingIoHandler,IoHandlerAdapter,SingleSessionIoHandlerDelegate,StreamIoHandler
public interface IoHandler
Handles all I/O events fired by MINA.
- See Also:
-
Method Summary
Modifier and TypeMethodDescriptionvoidexceptionCaught(IoSession session, Throwable cause) Invoked when any exception is thrown by userIoHandlerimplementation or by MINA.voidmessageReceived(IoSession session, Object message) Invoked when a message is received.voidmessageSent(IoSession session, Object message) Invoked when a message written byIoSession.write(Object)is sent out.voidsessionClosed(IoSession session) Invoked when a connection is closed.voidsessionCreated(IoSession session) Invoked from an I/O processor thread when a new connection has been created.voidsessionIdle(IoSession session, IdleStatus status) Invoked with the relatedIdleStatuswhen a connection becomes idle.voidsessionOpened(IoSession session) Invoked when a connection has been opened.
-
Method Details
-
sessionCreated
Invoked from an I/O processor thread when a new connection has been created. Because this method is supposed to be called from the same thread that handles I/O of multiple sessions, please implement this method to perform tasks that consumes minimal amount of time such as socket parameter and user-defined session attribute initialization.- Throws:
Exception
-
sessionOpened
Invoked when a connection has been opened. This method is invoked aftersessionCreated(IoSession). The biggest difference fromsessionCreated(IoSession)is that it's invoked from other thread than an I/O processor thread once thread modesl is configured properly.- Throws:
Exception
-
sessionClosed
Invoked when a connection is closed.- Throws:
Exception
-
sessionIdle
Invoked with the relatedIdleStatuswhen 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.- Throws:
Exception
-
exceptionCaught
Invoked when any exception is thrown by userIoHandlerimplementation or by MINA. Ifcauseis instanceofIOException, MINA will close the connection automatically.- Throws:
Exception
-
messageReceived
Invoked when a message is received.- Throws:
Exception
-
messageSent
Invoked when a message written byIoSession.write(Object)is sent out.- Throws:
Exception
-