Package org.eclipse.jetty.server.session

Class AbstractSession

java.lang.Object

org.eclipse.jetty.server.session.AbstractSession

All Implemented Interfaces:

javax.servlet.http.HttpSession, AbstractSessionManager.SessionIf

Direct Known Subclasses:

MemSession

public abstract class AbstractSession
extends java.lang.Object
implements AbstractSessionManager.SessionIf

Implements HttpSession from the javax.servlet package.

Field Summary

Fields

Modifier and Type	Field	Description
static java.lang.String	SESSION_CREATED_SECURE

Constructor Summary

Constructors

Modifier	Constructor	Description
protected	AbstractSession(AbstractSessionManager abstractSessionManager, long created, long accessed, java.lang.String clusterId)
protected	AbstractSession(AbstractSessionManager abstractSessionManager, javax.servlet.http.HttpServletRequest request)

Method Summary

Modifier and Type	Method	Description
protected boolean	access(long time)
void	bindValue(java.lang.String name, java.lang.Object value)	Bind value if value implements HttpSessionBindingListener (calls HttpSessionBindingListener.valueBound(HttpSessionBindingEvent))
protected void	callSessionAttributeListeners(java.lang.String name, java.lang.Object newValue, java.lang.Object oldValue)	Call binding and attribute listeners based on the new and old values of the attribute.
protected java.lang.Object	changeAttribute(java.lang.String name, java.lang.Object value)	Either set (perhaps replace) or remove the value of the attribute in the session.
protected boolean	checkExpiry(long time)	Check to see if session has expired as at the time given.
protected void	checkValid()	asserts that the session is valid
abstract void	clearAttributes()
protected void	complete()
protected void	cookieSet()
void	didActivate()
abstract java.lang.Object	doGet(java.lang.String name)
abstract java.util.Enumeration<java.lang.String>	doGetAttributeNames()
protected void	doInvalidate()
abstract java.lang.Object	doPutOrRemove(java.lang.String name, java.lang.Object value)
long	getAccessed()
java.lang.Object	getAttribute(java.lang.String name)
abstract java.util.Map<java.lang.String,java.lang.Object>	getAttributeMap()
java.util.Enumeration<java.lang.String>	getAttributeNames()
abstract int	getAttributes()
java.lang.String	getClusterId()
long	getCookieSetTime()
long	getCreationTime()
java.lang.String	getId()
long	getLastAccessedTime()
int	getMaxInactiveInterval()
abstract java.util.Set<java.lang.String>	getNames()
java.lang.String	getNodeId()
int	getRequests()
javax.servlet.ServletContext	getServletContext()
AbstractSession	getSession()
javax.servlet.http.HttpSessionContext	getSessionContext()	Deprecated.
SessionManager	getSessionManager()
java.lang.Object	getValue(java.lang.String name)	Deprecated. As of Version 2.2, this method is replaced by getAttribute(java.lang.String)
java.lang.String[]	getValueNames()	Deprecated. As of Version 2.2, this method is replaced by getAttributeNames()
void	invalidate()
boolean	isIdChanged()
boolean	isNew()
boolean	isValid()
void	putValue(java.lang.String name, java.lang.Object value)	Deprecated. As of Version 2.2, this method is replaced by setAttribute(java.lang.String, java.lang.Object)
void	removeAttribute(java.lang.String name)
void	removeValue(java.lang.String name)	Deprecated. As of Version 2.2, this method is replaced by removeAttribute(java.lang.String)
void	renewId(javax.servlet.http.HttpServletRequest request)
void	setAttribute(java.lang.String name, java.lang.Object value)
protected void	setClusterId(java.lang.String clusterId)
void	setCookieSetTime(long time)
void	setIdChanged(boolean changed)
void	setLastAccessedTime(long time)
void	setMaxInactiveInterval(int secs)
protected void	setNodeId(java.lang.String nodeId)
void	setRequests(int requests)
protected void	timeout()
java.lang.String	toString()
void	unbindValue(java.lang.String name, java.lang.Object value)	Unbind value if value implements HttpSessionBindingListener (calls HttpSessionBindingListener.valueUnbound(HttpSessionBindingEvent))
protected boolean	updateAttribute(java.lang.String name, java.lang.Object value)	Deprecated. use changeAttribute(String,Object) instead
void	willPassivate()

Methods inherited from class java.lang.Object

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

Field Detail

SESSION_CREATED_SECURE

public static final java.lang.String SESSION_CREATED_SECURE

See Also:

Constant Field Values

Constructor Detail

AbstractSession

protected AbstractSession(AbstractSessionManager abstractSessionManager,
                          javax.servlet.http.HttpServletRequest request)

AbstractSession

protected AbstractSession(AbstractSessionManager abstractSessionManager,
                          long created,
                          long accessed,
                          java.lang.String clusterId)

Method Detail

checkValid

protected void checkValid()
                   throws java.lang.IllegalStateException

asserts that the session is valid

Throws:

java.lang.IllegalStateException - if the sesion is invalid

checkExpiry

protected boolean checkExpiry(long time)

Check to see if session has expired as at the time given.

Parameters:

time - the time in milliseconds

Returns:

true if expired

getSession

public AbstractSession getSession()

Specified by:

getSession in interface AbstractSessionManager.SessionIf

getAccessed

public long getAccessed()

getAttributeMap

public abstract java.util.Map<java.lang.String,java.lang.Object> getAttributeMap()

getAttributes

public abstract int getAttributes()

getNames

public abstract java.util.Set<java.lang.String> getNames()

getCookieSetTime

public long getCookieSetTime()

setCookieSetTime

public void setCookieSetTime(long time)

getCreationTime

public long getCreationTime()
                     throws java.lang.IllegalStateException

Specified by:

getCreationTime in interface javax.servlet.http.HttpSession

Throws:

java.lang.IllegalStateException

getId

public java.lang.String getId()
                       throws java.lang.IllegalStateException

Specified by:

getId in interface javax.servlet.http.HttpSession

Throws:

java.lang.IllegalStateException

getNodeId

public java.lang.String getNodeId()

getClusterId

public java.lang.String getClusterId()

getLastAccessedTime

public long getLastAccessedTime()
                         throws java.lang.IllegalStateException

Specified by:

getLastAccessedTime in interface javax.servlet.http.HttpSession

Throws:

java.lang.IllegalStateException

setLastAccessedTime

public void setLastAccessedTime(long time)

getMaxInactiveInterval

public int getMaxInactiveInterval()

Specified by:

getMaxInactiveInterval in interface javax.servlet.http.HttpSession

getServletContext

public javax.servlet.ServletContext getServletContext()

Specified by:

getServletContext in interface javax.servlet.http.HttpSession

getSessionContext

@Deprecated
public javax.servlet.http.HttpSessionContext getSessionContext()
                                                        throws java.lang.IllegalStateException

Deprecated.

Specified by:

getSessionContext in interface javax.servlet.http.HttpSession

Throws:

java.lang.IllegalStateException

getValue

@Deprecated
public java.lang.Object getValue(java.lang.String name)
                          throws java.lang.IllegalStateException

Deprecated. As of Version 2.2, this method is replaced by getAttribute(java.lang.String)

Specified by:

getValue in interface javax.servlet.http.HttpSession

Throws:

java.lang.IllegalStateException

renewId

public void renewId(javax.servlet.http.HttpServletRequest request)

getSessionManager

public SessionManager getSessionManager()

setClusterId

protected void setClusterId(java.lang.String clusterId)

setNodeId

protected void setNodeId(java.lang.String nodeId)

access

protected boolean access(long time)

complete

protected void complete()

timeout

protected void timeout()
                throws java.lang.IllegalStateException

Throws:

java.lang.IllegalStateException

invalidate

public void invalidate()
                throws java.lang.IllegalStateException

Specified by:

invalidate in interface javax.servlet.http.HttpSession

Throws:

java.lang.IllegalStateException

doInvalidate

protected void doInvalidate()
                     throws java.lang.IllegalStateException

Throws:

java.lang.IllegalStateException

clearAttributes

public abstract void clearAttributes()

isIdChanged

public boolean isIdChanged()

isNew

public boolean isNew()
              throws java.lang.IllegalStateException

Specified by:

isNew in interface javax.servlet.http.HttpSession

Throws:

java.lang.IllegalStateException

putValue

@Deprecated
public void putValue(java.lang.String name,
                     java.lang.Object value)
              throws java.lang.IllegalStateException

Deprecated. As of Version 2.2, this method is replaced by setAttribute(java.lang.String, java.lang.Object)

Specified by:

putValue in interface javax.servlet.http.HttpSession

Throws:

java.lang.IllegalStateException

removeAttribute

public void removeAttribute(java.lang.String name)

Specified by:

removeAttribute in interface javax.servlet.http.HttpSession

removeValue

@Deprecated
public void removeValue(java.lang.String name)
                 throws java.lang.IllegalStateException

Deprecated. As of Version 2.2, this method is replaced by removeAttribute(java.lang.String)

Specified by:

removeValue in interface javax.servlet.http.HttpSession

Throws:

java.lang.IllegalStateException

getAttributeNames

public java.util.Enumeration<java.lang.String> getAttributeNames()

Specified by:

getAttributeNames in interface javax.servlet.http.HttpSession

getValueNames

@Deprecated
public java.lang.String[] getValueNames()
                                 throws java.lang.IllegalStateException

Deprecated. As of Version 2.2, this method is replaced by getAttributeNames()

Specified by:

getValueNames in interface javax.servlet.http.HttpSession

Throws:

java.lang.IllegalStateException

doPutOrRemove

public abstract java.lang.Object doPutOrRemove(java.lang.String name,
                                               java.lang.Object value)

doGet

public abstract java.lang.Object doGet(java.lang.String name)

doGetAttributeNames

public abstract java.util.Enumeration<java.lang.String> doGetAttributeNames()

getAttribute

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

Specified by:

getAttribute in interface javax.servlet.http.HttpSession

setAttribute

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

Specified by:

setAttribute in interface javax.servlet.http.HttpSession

updateAttribute

@Deprecated
protected boolean updateAttribute(java.lang.String name,
                                  java.lang.Object value)

Deprecated. use changeAttribute(String,Object) instead

Parameters:

name - the name of the attribute

value - the value of the attribute

Returns:

true if attribute changed

changeAttribute

protected java.lang.Object changeAttribute(java.lang.String name,
                                           java.lang.Object value)

Either set (perhaps replace) or remove the value of the attribute in the session. The appropriate session attribute listeners are also called.

Parameters:

name - the name of the attribute

value - the value of the attribute

Returns:

the old value for the attribute

callSessionAttributeListeners

protected void callSessionAttributeListeners(java.lang.String name,
                                             java.lang.Object newValue,
                                             java.lang.Object oldValue)

Call binding and attribute listeners based on the new and old values of the attribute.

Parameters:

name - name of the attribute

newValue - new value of the attribute

oldValue - previous value of the attribute

setIdChanged

public void setIdChanged(boolean changed)

setMaxInactiveInterval

public void setMaxInactiveInterval(int secs)

Specified by:

setMaxInactiveInterval in interface javax.servlet.http.HttpSession

toString

public java.lang.String toString()

Overrides:

toString in class java.lang.Object

bindValue

public void bindValue(java.lang.String name,
                      java.lang.Object value)

Bind value if value implements HttpSessionBindingListener (calls HttpSessionBindingListener.valueBound(HttpSessionBindingEvent))

Parameters:

name - the name with which the object is bound or unbound

value - the bound value

isValid

public boolean isValid()

cookieSet

protected void cookieSet()

getRequests

public int getRequests()

setRequests

public void setRequests(int requests)

unbindValue

public void unbindValue(java.lang.String name,
                        java.lang.Object value)

Unbind value if value implements HttpSessionBindingListener (calls HttpSessionBindingListener.valueUnbound(HttpSessionBindingEvent))

Parameters:

name - the name with which the object is bound or unbound

value - the bound value

willPassivate

public void willPassivate()

didActivate

public void didActivate()