org.snf4j.core

Class DTLSServerHandler

java.lang.Object

org.snf4j.core.handler.AbstractHandler

org.snf4j.core.handler.AbstractDatagramHandler

org.snf4j.core.DatagramServerHandler

org.snf4j.core.DTLSServerHandler

All Implemented Interfaces:

IDatagramHandler, IHandler, IDatagramReader

public class DTLSServerHandler
extends DatagramServerHandler

DTLS server handler providing functionality to handle multiple remote hosts via a single datagram-orinted session. The sessions created by this handler implement IEngineDatagramSession.

Limitations:: As the session objects created by this handler do not implement their own I/O functionalities calling to methods suspending read/write operations will also suspend all other sessions currently handled by this handler.

Author:

SNF4J.ORG

Field Summary

Fields inherited from class org.snf4j.core.DatagramServerHandler

sessions, timers

Constructor Summary

Constructors

Constructor and Description
DTLSServerHandler(IDatagramHandlerFactory handlerFactory) Constructs a DTLS server handler with the DefaultSessionConfig and the DefaultSessionStructureFactory.
DTLSServerHandler(IDatagramHandlerFactory handlerFactory, ISessionConfig config) Constructs a DTLS server handler with the DefaultSessionConfig.
DTLSServerHandler(IDatagramHandlerFactory handlerFactory, ISessionConfig config, ISessionStructureFactory factory) Constructs a DTLS server handler.

Method Summary

Modifier and Type	Method and Description
protected IEngine	createEngine(SocketAddress remoteAddress, ISessionConfig config) Determines if a newly created session should be a DTLS session driven by the SSLEngine created by the config.createSSLEngine() method.

Methods inherited from class org.snf4j.core.DatagramServerHandler

event, event, event, exception, getConfig, getFactory, getSessions, incident, read, read, read, read, read, read, timer

Methods inherited from class org.snf4j.core.handler.AbstractDatagramHandler

getSession, setSession

Methods inherited from class org.snf4j.core.handler.AbstractHandler

getName, timer

Methods inherited from class java.lang.Object

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

Methods inherited from interface org.snf4j.core.handler.IHandler

getName, timer

Constructor Detail

DTLSServerHandler

public DTLSServerHandler(IDatagramHandlerFactory handlerFactory)

Constructs a DTLS server handler with the DefaultSessionConfig and the DefaultSessionStructureFactory.

Parameters:

handlerFactory - the factory used to create datagram handlers the will be associated with newly created sessions for remote hosts

DTLSServerHandler

public DTLSServerHandler(IDatagramHandlerFactory handlerFactory,
                         ISessionConfig config)

Constructs a DTLS server handler with the DefaultSessionConfig.

Parameters:

handlerFactory - the factory used to create datagram handlers the will be associated with newly created sessions for remote hosts

config - the configuration for a session associated with this handler or null to use the default configuration

DTLSServerHandler

public DTLSServerHandler(IDatagramHandlerFactory handlerFactory,
                         ISessionConfig config,
                         ISessionStructureFactory factory)

Constructs a DTLS server handler.

Parameters:

handlerFactory - the factory used to create datagram handlers the will be associated with newly created sessions for remote hosts

config - the configuration for a session associated with this handler or null to use the default configuration

factory - the factory used to configure the internal structure of a session associated with this handler or null to use the default structure factory

Method Detail

createEngine

protected IEngine createEngine(SocketAddress remoteAddress,
                               ISessionConfig config)
                        throws Exception

Determines if a newly created session should be a DTLS session driven by the SSLEngine created by the config.createSSLEngine() method. If the config.createSSLEngine() method returns null the session being created will not be an engine-driven session.

Overrides:

createEngine in class DatagramServerHandler

Parameters:

remoteAddress - address of the remote peer for which the session is about to be created

config - the configuration for the session being created

Returns:

the engine implementation or null if the session being created should not be engine-driven

Throws:

Exception - if the engine could not be created