org.apache.tapestry.services
Interface Session

All Known Implementing Classes:

PageTesterSession, SessionImpl

public interface Session

Generic version of HttpSession, used to bridge the gaps between the Servlet API and the Portlet API.

Method Summary

Object	getAttribute(String name) Returns the value previously stored in the session.
List<String>	getAttributeNames() Returns a list of the names of all attributes stored in the session.
List<String>	getAttributeNames(String prefix) Returns a list of the names of all attributes stored in the session whose name has the provided prefix.
int	getMaxInactiveInterval() Returns the maximum time interval, in seconds, that the servlet container will keep this session open between client accesses.
void	invalidate() Invalidates this session then unbinds any objects bound to it.
void	setAttribute(String name, Object value) Sets the value of an attribute.
void	setMaxInactiveInterval(int seconds) Specifies the time, in seconds, between client requests before the servlet container will invalidate this session.

Method Detail

getAttributeNames

List<String> getAttributeNames()

Returns a list of the names of all attributes stored in the session. The names are returned sorted alphabetically.

getAttributeNames

List<String> getAttributeNames(String prefix)

Returns a list of the names of all attributes stored in the session whose name has the provided prefix. The names are returned in alphabetical order.

getAttribute

Object getAttribute(String name)

Returns the value previously stored in the session.

setAttribute

void setAttribute(String name,
                  Object value)

Sets the value of an attribute. If the value is null, then the attribute is deleted.

getMaxInactiveInterval

int getMaxInactiveInterval()

Returns the maximum time interval, in seconds, that the servlet container will keep this session open between client accesses. After this interval, the servlet container will invalidate the session. The maximum time interval can be set with the setMaxInactiveInterval method. A negative time indicates the session should never timeout.

setMaxInactiveInterval

void setMaxInactiveInterval(int seconds)

Specifies the time, in seconds, between client requests before the servlet container will invalidate this session. A negative time indicates the session should never timeout.

invalidate

void invalidate()

Invalidates this session then unbinds any objects bound to it.

Throws:

IllegalStateException - if this method is called on an already invalidated session