net.officefloor.plugin.web.http.session

Interface HttpSession

All Known Implementing Classes:

ServletHttpSession

public interface HttpSession

HTTP session.

Author:

Daniel Sagenschneider

Method Summary

Modifier and Type	Method and Description
Serializable	getAttribute(String name) Obtains the Object that is bound to the name for this HttpSession.
Iterator<String>	getAttributeNames() Obtains an Iterator to the names of the bound Object instances.
long	getCreationTime() Obtains the time this HttpSession was created.
long	getExpireTime() Obtains the time this HttpSession will be expired should it be idle.
HttpSessionAdministration	getHttpSessionAdministration() Obtains the HttpSessionAdministration to administer this HttpSession.
String	getSessionId() Obtains the session Id.
String	getTokenName() Obtains the token name.
boolean	isNew() Indicates if this is a new HttpSession.
void	removeAttribute(String name) Removes the bound Object by the name from this HttpSession.
void	setAttribute(String name, Serializable object) Binds the Object to the name within this HttpSession.
void	setExpireTime(long expireTime) Specifies the time this HttpSession will expire if idle.

Method Detail

getSessionId

String getSessionId()
             throws InvalidatedHttpSessionException

Obtains the session Id.

Returns:

Session Id.

Throws:

InvalidatedHttpSessionException - Indicating the HttpSession is invalidated.

getTokenName

String getTokenName()

Obtains the token name.

This is the name of the cookie or parameter that contains the session Id.

Returns:

Token name.

isNew

boolean isNew()
       throws InvalidatedHttpSessionException

Indicates if this is a new HttpSession.

Returns:

true if this is a new HttpSession.

Throws:

InvalidatedHttpSessionException - Indicating the HttpSession is invalidated.

getCreationTime

long getCreationTime()
              throws InvalidatedHttpSessionException

Obtains the time this HttpSession was created.

Returns:

Time this HttpSession was created.

Throws:

InvalidatedHttpSessionException - Indicating the HttpSession is invalidated.

getExpireTime

long getExpireTime()
            throws InvalidatedHttpSessionException

Obtains the time this HttpSession will be expired should it be idle.

Returns:

Time this HttpSession will be expired.

Throws:

InvalidatedHttpSessionException - Indicating the HttpSession is invalidated.

setExpireTime

void setExpireTime(long expireTime)
            throws StoringHttpSessionException,
                   InvalidatedHttpSessionException

Specifies the time this HttpSession will expire if idle.

The HttpSessionStore may increment this time on further requests to keep the HttpSession active over a long conversation.

Parameters:

expireTime - Time to expire this HttpSession.

Throws:

StoringHttpSessionException - Indicating the HttpSession is currently being stored and can not be altered.

InvalidatedHttpSessionException - Indicating the HttpSession is invalidated.

getAttribute

Serializable getAttribute(String name)
                   throws InvalidatedHttpSessionException

Obtains the Object that is bound to the name for this HttpSession.

Parameters:

name - Name.

Returns:

Object bound to the name or null if no Object bound by the name.

Throws:

InvalidatedHttpSessionException - Indicating the HttpSession is invalidated.

getAttributeNames

Iterator<String> getAttributeNames()
                            throws InvalidatedHttpSessionException

Obtains an Iterator to the names of the bound Object instances.

Returns:

Iterator to the names of the bound Object instances.

Throws:

InvalidatedHttpSessionException - Indicating the HttpSession is invalidated.

setAttribute

void setAttribute(String name,
                  Serializable object)
           throws StoringHttpSessionException,
                  InvalidatedHttpSessionException

Binds the Object to the name within this HttpSession.

Parameters:

name - Name.

object - Object. Must be Serializable as the attributes of this HttpSession may be serialised to larger, cheaper memory stores or for clustered HttpSession management sent over the network.

Throws:

StoringHttpSessionException - Indicating the HttpSession is currently being stored and can not be altered.

InvalidatedHttpSessionException - Indicating the HttpSession is invalidated.

removeAttribute

void removeAttribute(String name)
              throws StoringHttpSessionException,
                     InvalidatedHttpSessionException

Removes the bound Object by the name from this HttpSession.

Parameters:

name - Name of bound Object to remove.

Throws:

StoringHttpSessionException - Indicating the HttpSession is currently being stored and can not be altered.

InvalidatedHttpSessionException - Indicating the HttpSession is invalidated.

getHttpSessionAdministration

HttpSessionAdministration getHttpSessionAdministration()

Obtains the HttpSessionAdministration to administer this HttpSession.

Returns:

HttpSessionAdministration to administer this HttpSession.