org.snf4j.core.factory

Class AbstractSessionFactory

java.lang.Object

org.snf4j.core.factory.AbstractSessionFactory

All Implemented Interfaces:

IStreamSessionFactory

public abstract class AbstractSessionFactory
extends Object
implements IStreamSessionFactory

Base implementation of the IStreamSessionFactory interface.

Author:

SNF4J.ORG

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	AbstractSessionFactory() Constructs a factory that creates the basic stream-oriented sessions.
protected	AbstractSessionFactory(boolean ssl) Constructs a factory that creates sessions of the given type (basic or SSL/TLS).

Method Summary

Modifier and Type	Method and Description
void	closed(ServerSocketChannel channel) Notifies about closing and unregistering of a listening channel.
StreamSession	create(SocketChannel channel) Creates a stream-oriented session for a newly accepted connection.
protected abstract IStreamHandler	createHandler(SocketChannel channel) Creates a stream-oriented handler for a newly accepted connection.
void	exception(ServerSocketChannel channel, Throwable exception) Notifies about an exception caught during processing of a listening channel.
void	registered(ServerSocketChannel channel) Notifies about registration of a listening channel.

Methods inherited from class java.lang.Object

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

Constructor Detail

AbstractSessionFactory

protected AbstractSessionFactory()

Constructs a factory that creates the basic stream-oriented sessions.

AbstractSessionFactory

protected AbstractSessionFactory(boolean ssl)

Constructs a factory that creates sessions of the given type (basic or SSL/TLS).

Parameters:

ssl - the type of created sessions. true for SSL/TLS sessions handshaking in server mode and false for basic stream-oriented sessions.

Method Detail

create

public StreamSession create(SocketChannel channel)
                     throws Exception

Creates a stream-oriented session for a newly accepted connection. The returned session will be associated with the handler returned by the createHandler method.

Specified by:

create in interface IStreamSessionFactory

Parameters:

channel - the socket channel associated with the accepted connection.

Returns:

a stream-oriented session that will be associated with the accepted connection

Throws:

Exception - when a stream-oriented session could not be created

createHandler

protected abstract IStreamHandler createHandler(SocketChannel channel)

Creates a stream-oriented handler for a newly accepted connection. This method can be also used to configure the newly accepted channel.

Parameters:

channel - the socket channel associated with the accepted connection.

Returns:

a stream-oriented handler that will be associated with the session returned by the create method

registered

public void registered(ServerSocketChannel channel)

Description copied from interface: IStreamSessionFactory

Notifies about registration of a listening channel. Once it is called the associated selector loop is ready to accept new connections form the channel.

Specified by:

registered in interface IStreamSessionFactory

Parameters:

channel - the listening channel that has been registered

closed

public void closed(ServerSocketChannel channel)

Description copied from interface: IStreamSessionFactory

Notifies about closing and unregistering of a listening channel. It is only called when the channel is closed by the associated selector loop.

Specified by:

closed in interface IStreamSessionFactory

Parameters:

channel - the listening channel that has been closed

exception

public void exception(ServerSocketChannel channel,
                      Throwable exception)

Description copied from interface: IStreamSessionFactory

Notifies about an exception caught during processing of a listening channel.

Specified by:

exception in interface IStreamSessionFactory

Parameters:

channel - the listening channel for witch the exception was caught

exception - the exception that was caught