org.apache.mina.common

接口 IoAcceptor

所有超级接口:

IoService

所有已知实现类:

BaseIoAcceptor, DatagramAcceptor, DatagramAcceptorDelegate, DelegatedIoAcceptor, SocketAcceptor, VmPipeAcceptor

public interface IoAcceptor
extends IoService

Accepts incoming connection, communicates with clients, and fires events to IoHandlers.

Please refer to EchoServer example.

You should bind to the desired socket address to accept incoming connections, and then events for incoming connections will be sent to the specified default IoHandler.

Threads accept incoming connections start automatically when bind(SocketAddress, IoHandler) is invoked, and stop when all addresses are unbound.

版本:

$Rev: 555855 $, $Date: 2007-07-13 12:19:00 +0900 (Fri, 13 Jul 2007) $

作者:

The Apache Directory Project (mina-dev@directory.apache.org)

方法概要

方法

限定符和类型	方法和说明
void	bind(java.net.SocketAddress address, IoHandler handler) Binds to the specified address and handles incoming connections with the specified handler.
void	bind(java.net.SocketAddress address, IoHandler handler, IoServiceConfig config) Binds to the specified address and handles incoming connections with the specified handler.
IoSession	newSession(java.net.SocketAddress remoteAddress, java.net.SocketAddress localAddress) (Optional) Returns an IoSession that is bound to the specified localAddress and remoteAddress which reuses the localAddress that is already bound by IoAcceptor via bind(SocketAddress, IoHandler).
void	unbind(java.net.SocketAddress address) Unbinds from the specified address and disconnects all clients connected there.
void	unbindAll() Unbinds all addresses which were bound by this acceptor.

从接口继承的方法 org.apache.mina.common.IoService

addListener, getDefaultConfig, getFilterChain, getFilterChainBuilder, getManagedServiceAddresses, getManagedSessions, isManaged, removeListener, setFilterChainBuilder

方法详细资料

bind

void bind(java.net.SocketAddress address,
        IoHandler handler)
          throws java.io.IOException

Binds to the specified address and handles incoming connections with the specified handler.

抛出:

java.io.IOException - if failed to bind

bind

void bind(java.net.SocketAddress address,
        IoHandler handler,
        IoServiceConfig config)
          throws java.io.IOException

Binds to the specified address and handles incoming connections with the specified handler.

参数:

config - the configuration

抛出:

java.io.IOException - if failed to bind

unbind

void unbind(java.net.SocketAddress address)

Unbinds from the specified address and disconnects all clients connected there.

unbindAll

void unbindAll()

Unbinds all addresses which were bound by this acceptor.

newSession

IoSession newSession(java.net.SocketAddress remoteAddress,
                   java.net.SocketAddress localAddress)

(Optional) Returns an IoSession that is bound to the specified localAddress and remoteAddress which reuses the localAddress that is already bound by IoAcceptor via bind(SocketAddress, IoHandler).

This operation is optional. Please throw UnsupportedOperationException if the transport type doesn't support this operation. This operation is usually implemented for connectionless transport types.

抛出:

java.lang.UnsupportedOperationException - if this operation is not supported

java.lang.IllegalArgumentException - if the specified localAddress is not bound yet. (see bind(SocketAddress, IoHandler))