org.springframework.mock.web

Class MockHttpSession

java.lang.Object

org.springframework.mock.web.MockHttpSession

All Implemented Interfaces:

HttpSession

public class MockHttpSession
extends java.lang.Object
implements HttpSession

Mock implementation of the HttpSession interface.

As of Spring 4.0, this set of mocks is designed on a Servlet 3.0 baseline.

Used for testing the web framework; also useful for testing application controllers.

Since:

1.0.2

Author:

Juergen Hoeller, Rod Johnson, Mark Fisher, Sam Brannen

Field Summary

Fields

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

Constructor Summary

Constructors

Constructor and Description
MockHttpSession() Create a new MockHttpSession with a default MockServletContext.
MockHttpSession(ServletContext servletContext) Create a new MockHttpSession.
MockHttpSession(ServletContext servletContext, java.lang.String id) Create a new MockHttpSession.

Method Summary

Modifier and Type	Method and Description
void	access()
java.lang.String	changeSessionId() As of Servlet 3.1 the id of a session can be changed.
void	clearAttributes() Clear all of this session's attributes.
void	deserializeState(java.io.Serializable state) Deserialize the attributes of this session from a state object created by serializeState().
java.lang.Object	getAttribute(java.lang.String name)
java.util.Enumeration<java.lang.String>	getAttributeNames()
long	getCreationTime()
java.lang.String	getId()
long	getLastAccessedTime()
int	getMaxInactiveInterval()
ServletContext	getServletContext()
HttpSessionContext	getSessionContext()
java.lang.Object	getValue(java.lang.String name)
java.lang.String[]	getValueNames()
void	invalidate() Invalidates this session then unbinds any objects bound to it.
boolean	isInvalid()
boolean	isNew()
void	putValue(java.lang.String name, java.lang.Object value)
void	removeAttribute(java.lang.String name)
void	removeValue(java.lang.String name)
java.io.Serializable	serializeState() Serialize the attributes of this session into an object that can be turned into a byte array with standard Java serialization.
void	setAttribute(java.lang.String name, java.lang.Object value)
void	setMaxInactiveInterval(int interval)
void	setNew(boolean value)

Methods inherited from class java.lang.Object

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

Field Detail

SESSION_COOKIE_NAME

public static final java.lang.String SESSION_COOKIE_NAME

See Also:

Constant Field Values

Constructor Detail

MockHttpSession

public MockHttpSession()

Create a new MockHttpSession with a default MockServletContext.

See Also:

MockServletContext

MockHttpSession

public MockHttpSession(ServletContext servletContext)

Create a new MockHttpSession.

Parameters:

servletContext - the ServletContext that the session runs in

MockHttpSession

public MockHttpSession(ServletContext servletContext,
                       java.lang.String id)

Create a new MockHttpSession.

Parameters:

servletContext - the ServletContext that the session runs in

id - a unique identifier for this session

Method Detail

getCreationTime

public long getCreationTime()

Specified by:

getCreationTime in interface HttpSession

getId

public java.lang.String getId()

Specified by:

getId in interface HttpSession

changeSessionId

public java.lang.String changeSessionId()

As of Servlet 3.1 the id of a session can be changed.

Returns:

the new session id.

Since:

4.0.3

access

public void access()

getLastAccessedTime

public long getLastAccessedTime()

Specified by:

getLastAccessedTime in interface HttpSession

getServletContext

public ServletContext getServletContext()

Specified by:

getServletContext in interface HttpSession

setMaxInactiveInterval

public void setMaxInactiveInterval(int interval)

Specified by:

setMaxInactiveInterval in interface HttpSession

getMaxInactiveInterval

public int getMaxInactiveInterval()

Specified by:

getMaxInactiveInterval in interface HttpSession

getSessionContext

public HttpSessionContext getSessionContext()

Specified by:

getSessionContext in interface HttpSession

getAttribute

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

Specified by:

getAttribute in interface HttpSession

getValue

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

Specified by:

getValue in interface HttpSession

getAttributeNames

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

Specified by:

getAttributeNames in interface HttpSession

getValueNames

public java.lang.String[] getValueNames()

Specified by:

getValueNames in interface HttpSession

setAttribute

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

Specified by:

setAttribute in interface HttpSession

putValue

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

Specified by:

putValue in interface HttpSession

removeAttribute

public void removeAttribute(java.lang.String name)

Specified by:

removeAttribute in interface HttpSession

removeValue

public void removeValue(java.lang.String name)

Specified by:

removeValue in interface HttpSession

clearAttributes

public void clearAttributes()

Clear all of this session's attributes.

invalidate

public void invalidate()

Invalidates this session then unbinds any objects bound to it.

Specified by:

invalidate in interface HttpSession

Throws:

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

isInvalid

public boolean isInvalid()

setNew

public void setNew(boolean value)

isNew

public boolean isNew()

Specified by:

isNew in interface HttpSession

serializeState

public java.io.Serializable serializeState()

Serialize the attributes of this session into an object that can be turned into a byte array with standard Java serialization.

Returns:

a representation of this session's serialized state

deserializeState

public void deserializeState(java.io.Serializable state)

Deserialize the attributes of this session from a state object created by serializeState().

Parameters:

state - a representation of this session's serialized state