Class NioDatagramConnector

java.lang.Object

org.apache.mina.core.service.AbstractIoService

org.apache.mina.core.service.AbstractIoConnector

org.apache.mina.core.polling.AbstractPollingIoConnector<NioSession, DatagramChannel>

org.apache.mina.transport.socket.nio.NioDatagramConnector

All Implemented Interfaces:

IoConnector, IoService, DatagramConnector

public final class NioDatagramConnector
extends AbstractPollingIoConnector<NioSession, DatagramChannel>
implements DatagramConnector

IoConnector for datagram transport (UDP/IP).

Nested Class Summary

Nested classes/interfaces inherited from class AbstractPollingIoConnector

AbstractPollingIoConnector.ConnectionRequest

Nested classes/interfaces inherited from class AbstractIoService

AbstractIoService.ServiceOperationFuture

Field Summary

Fields inherited from class AbstractIoService

disposalLock, LOGGER, sessionConfig

Constructor Summary

Constructors

Constructor	Description
NioDatagramConnector()	Creates a new instance.
NioDatagramConnector(int processorCount)	Creates a new instance.
NioDatagramConnector(Class<? extends IoProcessor<NioSession>> processorClass)	Constructor for NioDatagramConnector with default configuration with default configuration which will use a built-in thread pool executor to manage the default number of processor instances.
NioDatagramConnector(Class<? extends IoProcessor<NioSession>> processorClass, int processorCount)	Constructor for NioDatagramConnector with default configuration which will use a built-in thread pool executor to manage the given number of processor instances.
NioDatagramConnector(IoProcessor<NioSession> processor)	Creates a new instance.

Method Summary

Modifier and Type	Method	Description
protected Iterator<DatagramChannel>	allHandles()	Iterator for all the client sockets polled for connection.
protected void	close(DatagramChannel handle)	Close a client socket.
protected boolean	connect(DatagramChannel handle, SocketAddress remoteAddress)	Connect a newly created client socket handle to a remote SocketAddress.
protected void	destroy()	Destroy the polling system, will be called when this IoConnector implementation will be disposed.
protected boolean	finishConnect(DatagramChannel handle)	Finish the connection process of a client socket after it was marked as ready to process by the AbstractPollingIoConnector.select(int) call.
protected AbstractPollingIoConnector<NioSession, DatagramChannel>.ConnectionRequest	getConnectionRequest(DatagramChannel handle)	get the AbstractPollingIoConnector<S extends AbstractIoSession, H>.ConnectionRequest for a given client socket handle
InetSocketAddress	getDefaultRemoteAddress()
DatagramSessionConfig	getSessionConfig()
TransportMetadata	getTransportMetadata()
protected void	init()	Initialize the polling system, will be called at construction time.
protected DatagramChannel	newHandle(SocketAddress localAddress)	Create a new client socket handle from a local SocketAddress
protected NioSession	newSession(IoProcessor<NioSession> processor, DatagramChannel handle)	Create a new IoSession from a connected socket client handle.
protected void	register(DatagramChannel handle, AbstractPollingIoConnector<NioSession, DatagramChannel>.ConnectionRequest request)	Register a new client socket for connection, add it to connection polling
protected int	select(int timeout)	Check for connected sockets, interrupt when at least a connection is processed (connected or failed to connect).
protected Iterator<DatagramChannel>	selectedHandles()	Iterator for the set of client sockets found connected or failed to connect during the last AbstractPollingIoConnector.select(int) call.
void	setDefaultRemoteAddress(InetSocketAddress defaultRemoteAddress)	Sets the default remote InetSocketAddress to connect to when no argument is specified in IoConnector.connect() method.
protected void	wakeup()	Interrupt the AbstractPollingIoConnector.select(int) method.

Methods inherited from class AbstractPollingIoConnector

connect0, dispose0

Methods inherited from class AbstractIoConnector

connect, connect, connect, connect, connect, connect, finishSessionInitialization0, getConnectTimeout, getConnectTimeoutCheckInterval, getConnectTimeoutMillis, getDefaultLocalAddress, setConnectTimeout, setConnectTimeoutCheckInterval, setConnectTimeoutMillis, setDefaultLocalAddress, setDefaultRemoteAddress, toString

Methods inherited from class AbstractIoService

addListener, broadcast, dispose, dispose, executeWorker, executeWorker, getActivationTime, getFilterChain, getFilterChainBuilder, getHandler, getListeners, getManagedSessionCount, getManagedSessions, getScheduledWriteBytes, getScheduledWriteMessages, getSessionDataStructureFactory, getStatistics, initSession, isActive, isDisposed, isDisposing, removeListener, setFilterChainBuilder, setHandler, setSessionDataStructureFactory

Methods inherited from class Object

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

Methods inherited from interface IoConnector

connect, connect, connect, connect, connect, connect, getConnectTimeout, getConnectTimeoutMillis, getDefaultLocalAddress, setConnectTimeout, setConnectTimeoutMillis, setDefaultLocalAddress, setDefaultRemoteAddress

Methods inherited from interface IoService

addListener, broadcast, dispose, dispose, getActivationTime, getFilterChain, getFilterChainBuilder, getHandler, getManagedSessionCount, getManagedSessions, getScheduledWriteBytes, getScheduledWriteMessages, getSessionDataStructureFactory, getStatistics, isActive, isDisposed, isDisposing, removeListener, setFilterChainBuilder, setHandler, setSessionDataStructureFactory

Constructor Details

NioDatagramConnector

public NioDatagramConnector()

Creates a new instance.

NioDatagramConnector

public NioDatagramConnector(int processorCount)

Creates a new instance.

Parameters:

processorCount - The number of IoProcessor instance to create

NioDatagramConnector

public NioDatagramConnector(IoProcessor<NioSession> processor)

Creates a new instance.

Parameters:

processor - The IoProcessor instance to use

NioDatagramConnector

public NioDatagramConnector(Class<? extends IoProcessor<NioSession>> processorClass,
 int processorCount)

Constructor for NioDatagramConnector with default configuration which will use a built-in thread pool executor to manage the given number of processor instances. The processor class must have a constructor that accepts ExecutorService or Executor as its single argument, or, failing that, a no-arg constructor.

Parameters:

processorClass - the processor class.

processorCount - the number of processors to instantiate.

Since:

2.0.0-M4

See Also:

• SimpleIoProcessorPool(Class, Executor, int, java.nio.channels.spi.SelectorProvider)

NioDatagramConnector

public NioDatagramConnector(Class<? extends IoProcessor<NioSession>> processorClass)

Constructor for NioDatagramConnector with default configuration with default configuration which will use a built-in thread pool executor to manage the default number of processor instances. The processor class must have a constructor that accepts ExecutorService or Executor as its single argument, or, failing that, a no-arg constructor. The default number of instances is equal to the number of processor cores in the system, plus one.

Parameters:

processorClass - the processor class.

Since:

2.0.0-M4

See Also:

• SimpleIoProcessorPool(Class, Executor, int, java.nio.channels.spi.SelectorProvider)

Method Details

getTransportMetadata

public TransportMetadata getTransportMetadata()

Specified by:

getTransportMetadata in interface IoService

Returns:

the TransportMetadata that this service runs on.

getSessionConfig

public DatagramSessionConfig getSessionConfig()

Specified by:

getSessionConfig in interface DatagramConnector

Specified by:

getSessionConfig in interface IoService

Returns:

the default configuration of the new IoSessions created by this service.

getDefaultRemoteAddress

public InetSocketAddress getDefaultRemoteAddress()

Specified by:

getDefaultRemoteAddress in interface DatagramConnector

Specified by:

getDefaultRemoteAddress in interface IoConnector

Overrides:

getDefaultRemoteAddress in class AbstractIoConnector

Returns:

the default remote address to connect to when no argument is specified in IoConnector.connect() method.

setDefaultRemoteAddress

public void setDefaultRemoteAddress(InetSocketAddress defaultRemoteAddress)

Sets the default remote InetSocketAddress to connect to when no argument is specified in IoConnector.connect() method. This method overrides the IoConnector.setDefaultRemoteAddress(java.net.SocketAddress) method.

Specified by:

setDefaultRemoteAddress in interface DatagramConnector

Parameters:

defaultRemoteAddress - The remote address to set

init

protected void init()
             throws Exception

Initialize the polling system, will be called at construction time.

Specified by:

init in class AbstractPollingIoConnector<NioSession, DatagramChannel>

Throws:

Exception - any exception thrown by the underlying system calls

newHandle

protected DatagramChannel newHandle(SocketAddress localAddress)
                             throws Exception

Create a new client socket handle from a local SocketAddress

Specified by:

newHandle in class AbstractPollingIoConnector<NioSession, DatagramChannel>

Parameters:

localAddress - the socket address for binding the new client socket

Returns:

a new client socket handle

Throws:

Exception - any exception thrown by the underlying systems calls

connect

protected boolean connect(DatagramChannel handle,
 SocketAddress remoteAddress)
                   throws Exception

Connect a newly created client socket handle to a remote SocketAddress. This operation is non-blocking, so at end of the call the socket can be still in connection process.

Specified by:

connect in class AbstractPollingIoConnector<NioSession, DatagramChannel>

Parameters:

handle - the client socket handle

remoteAddress - the remote address where to connect

Returns:

true if a connection was established, false if this client socket is in non-blocking mode and the connection operation is in progress

Throws:

Exception - If the connect failed

newSession

protected NioSession newSession(IoProcessor<NioSession> processor,
 DatagramChannel handle)

Create a new IoSession from a connected socket client handle. Will assign the created IoSession to the given IoProcessor for managing future I/O events.

Specified by:

newSession in class AbstractPollingIoConnector<NioSession, DatagramChannel>

Parameters:

processor - the processor in charge of this session

handle - the newly connected client socket handle

Returns:

a new IoSession

close

protected void close(DatagramChannel handle)
              throws Exception

Close a client socket.

Specified by:

close in class AbstractPollingIoConnector<NioSession, DatagramChannel>

Parameters:

handle - the client socket

Throws:

Exception - any exception thrown by the underlying systems calls

allHandles

protected Iterator<DatagramChannel> allHandles()

Iterator for all the client sockets polled for connection.

Specified by:

allHandles in class AbstractPollingIoConnector<NioSession, DatagramChannel>

Returns:

the list of client sockets currently polled for connection

getConnectionRequest

protected AbstractPollingIoConnector<NioSession, DatagramChannel>.ConnectionRequest getConnectionRequest(DatagramChannel handle)

get the AbstractPollingIoConnector<S extends AbstractIoSession, H>.ConnectionRequest for a given client socket handle

Specified by:

getConnectionRequest in class AbstractPollingIoConnector<NioSession, DatagramChannel>

Parameters:

handle - the socket client handle

Returns:

the connection request if the socket is connecting otherwise null

destroy

protected void destroy()
                throws Exception

Destroy the polling system, will be called when this IoConnector implementation will be disposed.

Specified by:

destroy in class AbstractPollingIoConnector<NioSession, DatagramChannel>

Throws:

Exception - any exception thrown by the underlying systems calls

finishConnect

protected boolean finishConnect(DatagramChannel handle)
                         throws Exception

Finish the connection process of a client socket after it was marked as ready to process by the AbstractPollingIoConnector.select(int) call. The socket will be connected or reported as connection failed.

Specified by:

finishConnect in class AbstractPollingIoConnector<NioSession, DatagramChannel>

Parameters:

handle - the client socket handle to finish to connect

Returns:

true if the socket is connected

Throws:

Exception - any exception thrown by the underlying systems calls

register

protected void register(DatagramChannel handle,
 AbstractPollingIoConnector<NioSession, DatagramChannel>.ConnectionRequest request)
                 throws Exception

Register a new client socket for connection, add it to connection polling

Specified by:

register in class AbstractPollingIoConnector<NioSession, DatagramChannel>

Parameters:

handle - client socket handle

request - the associated AbstractPollingIoConnector<S extends AbstractIoSession, H>.ConnectionRequest

Throws:

Exception - any exception thrown by the underlying systems calls

select

protected int select(int timeout)
              throws Exception

Check for connected sockets, interrupt when at least a connection is processed (connected or failed to connect). All the client socket descriptors processed need to be returned by AbstractPollingIoConnector.selectedHandles()

Specified by:

select in class AbstractPollingIoConnector<NioSession, DatagramChannel>

Parameters:

timeout - The timeout for the select() method

Returns:

The number of socket having received some data

Throws:

Exception - any exception thrown by the underlying systems calls

selectedHandles

protected Iterator<DatagramChannel> selectedHandles()

Iterator for the set of client sockets found connected or failed to connect during the last AbstractPollingIoConnector.select(int) call.

Specified by:

selectedHandles in class AbstractPollingIoConnector<NioSession, DatagramChannel>

Returns:

the list of client socket handles to process

wakeup

protected void wakeup()

Interrupt the AbstractPollingIoConnector.select(int) method. Used when the poll set need to be modified.

Specified by:

wakeup in class AbstractPollingIoConnector<NioSession, DatagramChannel>