org.apache.mina.core.service

接口 IoHandler

所有已知实现类:

AbstractProxyIoHandler, AbstractProxyIoHandler, ChainedIoHandler, ChatProtocolHandler, ClientSessionHandler, ClientToProxyIoHandler, DemuxingIoHandler, EchoProtocolHandler, HaikuValidatorIoHandler, ImageClient, ImageServerIoHandler, ImageServerIoHandler, IoHandlerAdapter, MemMonClient, MemoryMonitorHandler, NetCatProtocolHandler, ReverseProtocolHandler, ServerSessionHandler, ServerToProxyIoHandler, SingleSessionIoHandlerDelegate, StreamIoHandler, SwingChatClientHandler, TcpClient, TcpServer, TennisPlayer, TimeServerHandler, UdpClient, UdpServer

public interface IoHandler

Handles all I/O events fired by MINA.

作者:

Apache MINA Project

另请参阅:

IoHandlerAdapter

方法概要

方法

限定符和类型	方法和说明
void	exceptionCaught(IoSession session, java.lang.Throwable cause) Invoked when any exception is thrown by user IoHandler implementation or by MINA.
void	inputClosed(IoSession session) Handle the closure of an half-duplex TCP channel
void	messageReceived(IoSession session, java.lang.Object message) Invoked when a message is received.
void	messageSent(IoSession session, java.lang.Object message) Invoked when a message written by IoSession.write(Object) is sent out.
void	sessionClosed(IoSession session) Invoked when a connection is closed.
void	sessionCreated(IoSession session) Invoked from an I/O processor thread when a new connection has been created.
void	sessionIdle(IoSession session, IdleStatus status) Invoked with the related IdleStatus when a connection becomes idle.
void	sessionOpened(IoSession session) Invoked when a connection has been opened.

方法详细资料

sessionCreated

void sessionCreated(IoSession session)
                    throws java.lang.Exception

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.

参数:

session - The session being created

抛出:

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

sessionOpened

void sessionOpened(IoSession session)
                   throws java.lang.Exception

Invoked when a connection has been opened. This method is invoked after sessionCreated(IoSession). The biggest difference from sessionCreated(IoSession) is that it's invoked from other thread than an I/O processor thread once thread model is configured properly.

参数:

session - The session being opened

抛出:

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

sessionClosed

void sessionClosed(IoSession session)
                   throws java.lang.Exception

Invoked when a connection is closed.

参数:

session - The session being closed

抛出:

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

sessionIdle

void sessionIdle(IoSession session,
               IdleStatus status)
                 throws java.lang.Exception

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.

参数:

session - The idling session

status - The session's status

抛出:

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

exceptionCaught

void exceptionCaught(IoSession session,
                   java.lang.Throwable cause)
                     throws java.lang.Exception

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.

参数:

session - The session for which we have got an exception

cause - The exception that has been caught

抛出:

java.lang.Exception - If we get an exception while processing the caught exception

messageReceived

void messageReceived(IoSession session,
                   java.lang.Object message)
                     throws java.lang.Exception

Invoked when a message is received.

参数:

session - The session that is receiving a message

message - The received message

抛出:

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

messageSent

void messageSent(IoSession session,
               java.lang.Object message)
                 throws java.lang.Exception

Invoked when a message written by IoSession.write(Object) is sent out.

参数:

session - The session that has sent a full message

message - The sent message

抛出:

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

inputClosed

void inputClosed(IoSession session)
                 throws java.lang.Exception

Handle the closure of an half-duplex TCP channel

参数:

session - The session which input is being closed

抛出:

java.lang.Exception - If we get an exception while closing the input