uk.org.ogsadai.sessions (OGSA-DAI -- (c) International Business Machines Corporation, 2002-2006, The University of Edinburgh, 2002-2006)

Overview?

?Package?

Class?

Use?

Tree?

Deprecated?

Index?

Help?

?PREV PACKAGE? ?NEXT PACKAGE

FRAMES ? ?NO FRAMES ? ?

Package uk.org.ogsadai.sessions

Contains the core classes and interfaces used to support sessions.

See:
??????????Description

Interface Summary
*InternalSession*	The internal interface for all objects acting as sessions.
*Session*	The interface through which a session participant can interact with a session.
*SessionAttribute*	The interface for all state objects stored in sessions.
*SessionAttributeValue*	The interface for static session attribute values configured from XML.
*SessionComponentFactory*	Inferface used to create session components for data service resources.
*SessionCoordinator*	The interface for coordinating the joining and releasing of session participants to and from their sessions.
*SessionListener*	The listener interface for receiving session events.
*SessionManager*	The interface for the creation, retrieval and termination of sessions.
*SessionManagerFactory*	The factory interface for creating session managers.
*SessionParticipant*	The interface for all objects capable of joining sessions.
*SessionStrategy*	The interface for obtaining sessions from the session manager.
*SessionStrategyFactory*	Interface for creating `SessionStrategy` objects from OGSA-DAI perform documents.
*SessionStreamManager*	The interface through which session input and output streams can be written to and read from.

Class Summary
SessionConfigurationLoader	This class loads an XML session configuration file conforming to the `session_config.xsd` schema.
SessionEvent	An event representing some kind of interaction involving an `InternalSession` object.
SessionEventDispatcher	A thread-safe class for dispatching session events to a collection of session listeners.
SessionID	An object use to identify a particular session.
SessionNames	This class contains a number of utility methods for retrieving the names of resource properties associated with sessions.
SessionSettings	Encapsulates the settings of a session.
SessionStreamID	A compound identifier for identifying an external input or output belonging to a particular session.
SimpleSessionStreamManager	A simple `SessionStreamManager` that retrieves data from and inserts data onto output and input streams of the current requests of sessions.

Exception Summary
MaxSessionParticipantsException	A session has reached its maximum number of participants.
SessionAttrCreationException	A session attribute cannot be created.
SessionAttrValueCreationException	A session attribute value cannot be initialised.
SessionCoordinatorCreationException	A session coordinator cannot be created.
SessionCreationException	A session cannot be creation.
SessionJoinDeniedException	A participant is not allowed to join a session.
SessionJoinException	A problem arose when a participant joined a session.
SessionLookupException	A session cannot be looked up.
SessionManagerCreationException	A session manager cannot be created.
SessionManagerFactoryCreationException	A session manager factory cannot be created.
SessionNotFoundException	A session cannot be accessed.
SessionReleaseException	A problem occurred when a session released a participant.
SessionRequestException	A request violates session-specific conditions.
SessionStreamClosedException	A session's stream has been closed.
SessionStreamDuplicateException	An attempt is made to add a session stream with a name that already exists.
SessionStreamIOException	There was a problem encountered when reading to or writing from a session's stream.
SessionStreamNotFoundException	A session's stream cannot be accessed.
SessionStreamRequestNotProcessingException	The request associated with a session's stream has not yet started processing.
SessionTerminationException	A session cannot be terminated.
SessionViewCreationException	A session view cannot be created.
StaticSessionAttrException	An attempt was made to update or remove a static session attribute.

Package uk.org.ogsadai.sessions Description

Contains the core classes and interfaces used to support sessions. Sessions provide the ability for users to store state in the engine across multiple requests. In other words, one request can store objects in a session that can then be accessed by subsequent requests. These objects are known as session attributes. When a request interacts with a session, it is said to join that session.

Storing state in this way is important because it allows a context to be created for operations that are spread across related requests. For example, a session could be used to manage a transaction described in three sequential requests. Each request would join the same session, storing, accessing and updating session attributes.

Sessions may also provide access to a number of static session attributes. These are special read-only attributes that automatically exist in every session within the scope of an engine. An example could be a TransactionManager object.