org.apache.tapestry.web

Class ServletWebSession

java.lang.Object

org.apache.tapestry.web.ServletWebSession

All Implemented Interfaces:

Describable, AttributeHolder, WebSession

public class ServletWebSession
extends java.lang.Object
implements WebSession

Adapts HttpSession as WebSession.

Since:

4.0

Author:

Howard M. Lewis Ship

Constructor Summary

Constructors

Constructor and Description
ServletWebSession(javax.servlet.http.HttpSession session)

Method Summary

Methods

Modifier and Type	Method and Description
void	describeTo(DescriptionReceiver receiver) Invoked to have the receiver describe itself (largely in terms of properties and values).
java.lang.Object	getAttribute(java.lang.String name) Returns the named object, or null if no attribute has been stored with the given name.
java.util.List	getAttributeNames() Returns a list of all known attributes in ascending alphabetical order.
java.lang.String	getId() Returns a unique string identifier used to identify the session.
void	invalidate() Invalidates this session then unbinds any objects bound to it.
boolean	isNew() Returns true if the client does not yet know about the session or if the client chooses not to join the session.
void	setAttribute(java.lang.String name, java.lang.Object attribute) Updates the attribute, replacing (or removing) its value.

Methods inherited from class java.lang.Object

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

Constructor Detail

ServletWebSession

public ServletWebSession(javax.servlet.http.HttpSession session)

Method Detail

describeTo

public void describeTo(DescriptionReceiver receiver)

Description copied from interface: Describable

Invoked to have the receiver describe itself (largely in terms of properties and values). If the caller does not invoke any methods on the receiver, then the a default description of the caller will be used (based on toString().

Specified by:

describeTo in interface Describable

getAttributeNames

public java.util.List getAttributeNames()

Description copied from interface: AttributeHolder

Returns a list of all known attributes in ascending alphabetical order. May be empty (but won't be null).

Specified by:

getAttributeNames in interface AttributeHolder

getAttribute

public java.lang.Object getAttribute(java.lang.String name)

Description copied from interface: AttributeHolder

Returns the named object, or null if no attribute has been stored with the given name.

Specified by:

getAttribute in interface AttributeHolder

setAttribute

public void setAttribute(java.lang.String name,
                java.lang.Object attribute)

Description copied from interface: AttributeHolder

Updates the attribute, replacing (or removing) its value. For certain implementations, the attribute may need to be serializable (for example, a WebSession attribute in a clustered application).

Specified by:

setAttribute in interface AttributeHolder

Parameters:

name - the name of the attribute to update

attribute - the new value for the attribute, or null to delete the attribute entirely.

getId

public java.lang.String getId()

Description copied from interface: WebSession

Returns a unique string identifier used to identify the session. This value is provided by the container, and is typically incorporated into URLs, or stored as a HTTP cookie.

Specified by:

getId in interface WebSession

See Also:

WebResponse.encodeURL(String).

isNew

public boolean isNew()

Description copied from interface: WebSession

Returns true if the client does not yet know about the session or if the client chooses not to join the session.

Specified by:

isNew in interface WebSession

invalidate

public void invalidate()

Description copied from interface: WebSession

Invalidates this session then unbinds any objects bound to it.

Specified by:

invalidate in interface WebSession