uk.org.ogsadai.sessions
Interface SessionManagerFactory

All Known Implementing Classes:

TransientSessionManagerFactory

public interface SessionManagerFactory

The factory interface for creating session managers.

Each data service resource has one session manager which is used for accessing and managing the sessions that requests join to.

Author:

The OGSA-DAI Project Team

Method Summary

SessionManager

createSessionManager(org.w3c.dom.Element configuration, Properties properties, DataResourceAccessor dataResource) Creates a new session manager instance.

Method Detail

createSessionManager

public SessionManager createSessionManager(org.w3c.dom.Element configuration,
                                           Properties properties,
                                           DataResourceAccessor dataResource)
                                    throws SessionManagerCreationException

Creates a new session manager instance.

This method is invoked only once when a data service resource is instantiated. The object returned is then used for managing all the sessions associated with that data service resource.

Parameters:

configuration - The sessionConfiguration element from the session configuration file. This may contain settings used to initialise the SessionManager.

properties - The properties associated with the session.

dataResource - The data resource accessor associated with the session manager or null if no data resource accessor is associated.

Returns:

a new SessionManager, initialised and ready for use.

Throws:

java.lang.IllegalArgumentException - if configuration is null

SessionManagerCreationException - if there is a problem creating the new session manager. The consequence of this is that the data service resource cannot be properly initialised, so requests cannot be processed.