MockServletContext (spring-project 3.1.4.RELEASE API)

java.lang.Object
- org.springframework.mock.web.MockServletContext

All Implemented Interfaces:

javax.servlet.ServletContext
```
public class MockServletContext
extends Object
implements javax.servlet.ServletContext
```
Mock implementation of the ServletContext interface.
Compatible with Servlet 2.5 and partially with Servlet 3.0. Can be configured to expose a specific version through setMajorVersion(int)/setMinorVersion(int); default is 2.5. Note that Servlet 3.0 support is limited: servlet, filter and listener registration methods are not supported; neither is cookie or JSP configuration. We generally do not recommend to unit-test your ServletContainerInitializers and WebApplicationInitializers which is where those registration methods would be used.
Used for testing the Spring web framework; only rarely necessary for testing application controllers. As long as application components don't explicitly access the ServletContext, ClassPathXmlApplicationContext or FileSystemXmlApplicationContext can be used to load the context files for testing, even for DispatcherServlet context definitions.
For setting up a full WebApplicationContext in a test environment, you can use XmlWebApplicationContext (or GenericWebApplicationContext), passing in an appropriate MockServletContext instance. You might want to configure your MockServletContext with a FileSystemResourceLoader in that case, to make your resource paths interpreted as relative file system locations.
A common setup is to point your JVM working directory to the root of your web application directory, in combination with filesystem-based resource loading. This allows to load the context files as used in the web application, with relative paths getting interpreted correctly. Such a setup will work with both FileSystemXmlApplicationContext (which will load straight from the file system) and XmlWebApplicationContext with an underlying MockServletContext (as long as the MockServletContext has been configured with a FileSystemResourceLoader).

Since:

1.0.2

Author:

Rod Johnson, Juergen Hoeller

See Also:
MockServletContext(org.springframework.core.io.ResourceLoader), XmlWebApplicationContext, GenericWebApplicationContext, ClassPathXmlApplicationContext, FileSystemXmlApplicationContext

Field Summary
- Fields inherited from interface javax.servlet.ServletContext
  ORDERED_LIBS, TEMPDIR

Constructor Summary

Constructors
Constructor and Description
`MockServletContext()` Create a new MockServletContext, using no base path and a DefaultResourceLoader (i.e. the classpath root as WAR root).
`MockServletContext(ResourceLoader resourceLoader)` Create a new MockServletContext, using the specified ResourceLoader and no base path.
`MockServletContext(String resourceBasePath)` Create a new MockServletContext, using a DefaultResourceLoader.
`MockServletContext(String resourceBasePath, ResourceLoader resourceLoader)` Create a new MockServletContext.

Method Summary

Methods
Modifier and Type	Method and Description
`javax.servlet.FilterRegistration.Dynamic`	`addFilter(String filterName, Class<? extends javax.servlet.Filter> filterClass)`
`javax.servlet.FilterRegistration.Dynamic`	`addFilter(String filterName, javax.servlet.Filter filter)`
`javax.servlet.FilterRegistration.Dynamic`	`addFilter(String filterName, String className)`
`void`	`addInitParameter(String name, String value)`
`void`	`addListener(Class<? extends EventListener> listenerClass)`
`void`	`addListener(String className)`
`<T extends EventListener> void`	`addListener(T t)`
`javax.servlet.ServletRegistration.Dynamic`	`addServlet(String servletName, Class<? extends javax.servlet.Servlet> servletClass)`
`javax.servlet.ServletRegistration.Dynamic`	`addServlet(String servletName, javax.servlet.Servlet servlet)`
`javax.servlet.ServletRegistration.Dynamic`	`addServlet(String servletName, String className)`
`<T extends javax.servlet.Filter> T`	`createFilter(Class<T> c)`
`<T extends EventListener> T`	`createListener(Class<T> c)`
`<T extends javax.servlet.Servlet> T`	`createServlet(Class<T> c)`
`void`	`declareRoles(String... roleNames)`
`Object`	`getAttribute(String name)`
`Enumeration<String>`	`getAttributeNames()`
`ClassLoader`	`getClassLoader()`
`javax.servlet.ServletContext`	`getContext(String contextPath)`
`String`	`getContextPath()`
`Set<String>`	`getDeclaredRoles()`
`Set<javax.servlet.SessionTrackingMode>`	`getDefaultSessionTrackingModes()`
`int`	`getEffectiveMajorVersion()`
`int`	`getEffectiveMinorVersion()`
`Set<javax.servlet.SessionTrackingMode>`	`getEffectiveSessionTrackingModes()`
`javax.servlet.FilterRegistration`	`getFilterRegistration(String filterName)`
`Map<String,? extends javax.servlet.FilterRegistration>`	`getFilterRegistrations()`
`String`	`getInitParameter(String name)`
`Enumeration<String>`	`getInitParameterNames()`
`javax.servlet.descriptor.JspConfigDescriptor`	`getJspConfigDescriptor()`
`int`	`getMajorVersion()`
`String`	`getMimeType(String filePath)`
`int`	`getMinorVersion()`
`javax.servlet.RequestDispatcher`	`getNamedDispatcher(String path)`
`String`	`getRealPath(String path)`
`javax.servlet.RequestDispatcher`	`getRequestDispatcher(String path)`
`URL`	`getResource(String path)`
`InputStream`	`getResourceAsStream(String path)`
`protected String`	`getResourceLocation(String path)` Build a full resource location for the given path, prepending the resource base path of this MockServletContext.
`Set<String>`	`getResourcePaths(String path)`
`String`	`getServerInfo()`
`javax.servlet.Servlet`	`getServlet(String name)`
`String`	`getServletContextName()`
`Enumeration<String>`	`getServletNames()`
`javax.servlet.ServletRegistration`	`getServletRegistration(String servletName)`
`Map<String,? extends javax.servlet.ServletRegistration>`	`getServletRegistrations()`
`Enumeration<javax.servlet.Servlet>`	`getServlets()`
`javax.servlet.SessionCookieConfig`	`getSessionCookieConfig()`
`void`	`log(Exception ex, String message)`
`void`	`log(String message)`
`void`	`log(String message, Throwable ex)`
`void`	`registerContext(String contextPath, javax.servlet.ServletContext context)`
`void`	`removeAttribute(String name)`
`void`	`setAttribute(String name, Object value)`
`void`	`setContextPath(String contextPath)`
`void`	`setEffectiveMajorVersion(int effectiveMajorVersion)`
`void`	`setEffectiveMinorVersion(int effectiveMinorVersion)`
`boolean`	`setInitParameter(String name, String value)`
`void`	`setMajorVersion(int majorVersion)`
`void`	`setMinorVersion(int minorVersion)`
`void`	`setServletContextName(String servletContextName)`
`void`	`setSessionTrackingModes(Set<javax.servlet.SessionTrackingMode> sessionTrackingModes)`

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- Constructor Detail
  - MockServletContext
```
public MockServletContext()
```
    Create a new MockServletContext, using no base path and a DefaultResourceLoader (i.e. the classpath root as WAR root).
    
    See Also:
    DefaultResourceLoader
  - MockServletContext
```
public MockServletContext(String resourceBasePath)
```
    Create a new MockServletContext, using a DefaultResourceLoader.
    
    Parameters:
    resourceBasePath - the WAR root directory (should not end with a slash)
    See Also:
    DefaultResourceLoader
  - MockServletContext
```
public MockServletContext(ResourceLoader resourceLoader)
```
    Create a new MockServletContext, using the specified ResourceLoader and no base path.
    
    Parameters:
    resourceLoader - the ResourceLoader to use (or null for the default)
  - MockServletContext
```
public MockServletContext(String resourceBasePath,
                  ResourceLoader resourceLoader)
```
    Create a new MockServletContext.
    
    Parameters:
    resourceBasePath - the WAR root directory (should not end with a slash)
    resourceLoader - the ResourceLoader to use (or null for the default)
- Method Detail
  - getResourceLocation
```
protected String getResourceLocation(String path)
```
    Build a full resource location for the given path, prepending the resource base path of this MockServletContext.
    
    Parameters:
    path - the path as specified
    
    Returns:
    the full resource path
  - setContextPath
```
public void setContextPath(String contextPath)
```
  - getContextPath
```
public String getContextPath()
```
    Specified by:
    
    getContextPath in interface javax.servlet.ServletContext
  - registerContext
```
public void registerContext(String contextPath,
                   javax.servlet.ServletContext context)
```
  - getContext
```
public javax.servlet.ServletContext getContext(String contextPath)
```
    Specified by:
    
    getContext in interface javax.servlet.ServletContext
  - setMajorVersion
```
public void setMajorVersion(int majorVersion)
```
  - getMajorVersion
```
public int getMajorVersion()
```
    Specified by:
    
    getMajorVersion in interface javax.servlet.ServletContext
  - setMinorVersion
```
public void setMinorVersion(int minorVersion)
```
  - getMinorVersion
```
public int getMinorVersion()
```
    Specified by:
    
    getMinorVersion in interface javax.servlet.ServletContext
  - setEffectiveMajorVersion
```
public void setEffectiveMajorVersion(int effectiveMajorVersion)
```
  - getEffectiveMajorVersion
```
public int getEffectiveMajorVersion()
```
    Specified by:
    
    getEffectiveMajorVersion in interface javax.servlet.ServletContext
  - setEffectiveMinorVersion
```
public void setEffectiveMinorVersion(int effectiveMinorVersion)
```
  - getEffectiveMinorVersion
```
public int getEffectiveMinorVersion()
```
    Specified by:
    
    getEffectiveMinorVersion in interface javax.servlet.ServletContext
  - getMimeType
```
public String getMimeType(String filePath)
```
    Specified by:
    
    getMimeType in interface javax.servlet.ServletContext
  - getResourcePaths
```
public Set<String> getResourcePaths(String path)
```
    Specified by:
    
    getResourcePaths in interface javax.servlet.ServletContext
  - getResource
```
public URL getResource(String path)
                throws MalformedURLException
```
    Specified by:
    
    getResource in interface javax.servlet.ServletContext
    
    Throws:
    
    MalformedURLException
  - getResourceAsStream
```
public InputStream getResourceAsStream(String path)
```
    Specified by:
    
    getResourceAsStream in interface javax.servlet.ServletContext
  - getRequestDispatcher
```
public javax.servlet.RequestDispatcher getRequestDispatcher(String path)
```
    Specified by:
    
    getRequestDispatcher in interface javax.servlet.ServletContext
  - getNamedDispatcher
```
public javax.servlet.RequestDispatcher getNamedDispatcher(String path)
```
    Specified by:
    
    getNamedDispatcher in interface javax.servlet.ServletContext
  - getServlet
```
public javax.servlet.Servlet getServlet(String name)
```
    Specified by:
    
    getServlet in interface javax.servlet.ServletContext
  - getServlets
```
public Enumeration<javax.servlet.Servlet> getServlets()
```
    Specified by:
    
    getServlets in interface javax.servlet.ServletContext
  - getServletNames
```
public Enumeration<String> getServletNames()
```
    Specified by:
    
    getServletNames in interface javax.servlet.ServletContext
  - log
```
public void log(String message)
```
    Specified by:
    
    log in interface javax.servlet.ServletContext
  - log
```
public void log(Exception ex,
       String message)
```
    Specified by:
    
    log in interface javax.servlet.ServletContext
  - log
```
public void log(String message,
       Throwable ex)
```
    Specified by:
    
    log in interface javax.servlet.ServletContext
  - getRealPath
```
public String getRealPath(String path)
```
    Specified by:
    
    getRealPath in interface javax.servlet.ServletContext
  - getServerInfo
```
public String getServerInfo()
```
    Specified by:
    
    getServerInfo in interface javax.servlet.ServletContext
  - getInitParameter
```
public String getInitParameter(String name)
```
    Specified by:
    
    getInitParameter in interface javax.servlet.ServletContext
  - getInitParameterNames
```
public Enumeration<String> getInitParameterNames()
```
    Specified by:
    
    getInitParameterNames in interface javax.servlet.ServletContext
  - setInitParameter
```
public boolean setInitParameter(String name,
                       String value)
```
    Specified by:
    
    setInitParameter in interface javax.servlet.ServletContext
  - addInitParameter
```
public void addInitParameter(String name,
                    String value)
```
  - getAttribute
```
public Object getAttribute(String name)
```
    Specified by:
    
    getAttribute in interface javax.servlet.ServletContext
  - getAttributeNames
```
public Enumeration<String> getAttributeNames()
```
    Specified by:
    
    getAttributeNames in interface javax.servlet.ServletContext
  - setAttribute
```
public void setAttribute(String name,
                Object value)
```
    Specified by:
    
    setAttribute in interface javax.servlet.ServletContext
  - removeAttribute
```
public void removeAttribute(String name)
```
    Specified by:
    
    removeAttribute in interface javax.servlet.ServletContext
  - setServletContextName
```
public void setServletContextName(String servletContextName)
```
  - getServletContextName
```
public String getServletContextName()
```
    Specified by:
    
    getServletContextName in interface javax.servlet.ServletContext
  - getClassLoader
```
public ClassLoader getClassLoader()
```
    Specified by:
    
    getClassLoader in interface javax.servlet.ServletContext
  - declareRoles
```
public void declareRoles(String... roleNames)
```
    Specified by:
    
    declareRoles in interface javax.servlet.ServletContext
  - getDeclaredRoles
```
public Set<String> getDeclaredRoles()
```
  - getJspConfigDescriptor
```
public javax.servlet.descriptor.JspConfigDescriptor getJspConfigDescriptor()
```
    Specified by:
    
    getJspConfigDescriptor in interface javax.servlet.ServletContext
  - addServlet
```
public javax.servlet.ServletRegistration.Dynamic addServlet(String servletName,
                                                   String className)
```
    Specified by:
    
    addServlet in interface javax.servlet.ServletContext
  - addServlet
```
public javax.servlet.ServletRegistration.Dynamic addServlet(String servletName,
                                                   javax.servlet.Servlet servlet)
```
    Specified by:
    
    addServlet in interface javax.servlet.ServletContext
  - addServlet
```
public javax.servlet.ServletRegistration.Dynamic addServlet(String servletName,
                                                   Class<? extends javax.servlet.Servlet> servletClass)
```
    Specified by:
    
    addServlet in interface javax.servlet.ServletContext
  - createServlet
```
public <T extends javax.servlet.Servlet> T createServlet(Class<T> c)
                                              throws javax.servlet.ServletException
```
    Specified by:
    
    createServlet in interface javax.servlet.ServletContext
    
    Throws:
    
    javax.servlet.ServletException
  - getServletRegistration
```
public javax.servlet.ServletRegistration getServletRegistration(String servletName)
```
    Specified by:
    
    getServletRegistration in interface javax.servlet.ServletContext
  - getServletRegistrations
```
public Map<String,? extends javax.servlet.ServletRegistration> getServletRegistrations()
```
    Specified by:
    
    getServletRegistrations in interface javax.servlet.ServletContext
  - addFilter
```
public javax.servlet.FilterRegistration.Dynamic addFilter(String filterName,
                                                 String className)
```
    Specified by:
    
    addFilter in interface javax.servlet.ServletContext
  - addFilter
```
public javax.servlet.FilterRegistration.Dynamic addFilter(String filterName,
                                                 javax.servlet.Filter filter)
```
    Specified by:
    
    addFilter in interface javax.servlet.ServletContext
  - addFilter
```
public javax.servlet.FilterRegistration.Dynamic addFilter(String filterName,
                                                 Class<? extends javax.servlet.Filter> filterClass)
```
    Specified by:
    
    addFilter in interface javax.servlet.ServletContext
  - createFilter
```
public <T extends javax.servlet.Filter> T createFilter(Class<T> c)
                                            throws javax.servlet.ServletException
```
    Specified by:
    
    createFilter in interface javax.servlet.ServletContext
    
    Throws:
    
    javax.servlet.ServletException
  - getFilterRegistration
```
public javax.servlet.FilterRegistration getFilterRegistration(String filterName)
```
    Specified by:
    
    getFilterRegistration in interface javax.servlet.ServletContext
  - getFilterRegistrations
```
public Map<String,? extends javax.servlet.FilterRegistration> getFilterRegistrations()
```
    Specified by:
    
    getFilterRegistrations in interface javax.servlet.ServletContext
  - addListener
```
public void addListener(Class<? extends EventListener> listenerClass)
```
    Specified by:
    
    addListener in interface javax.servlet.ServletContext
  - addListener
```
public void addListener(String className)
```
    Specified by:
    
    addListener in interface javax.servlet.ServletContext
  - addListener
```
public <T extends EventListener> void addListener(T t)
```
    Specified by:
    
    addListener in interface javax.servlet.ServletContext
  - createListener
```
public <T extends EventListener> T createListener(Class<T> c)
                                       throws javax.servlet.ServletException
```
    Specified by:
    
    createListener in interface javax.servlet.ServletContext
    
    Throws:
    
    javax.servlet.ServletException
  - getSessionCookieConfig
```
public javax.servlet.SessionCookieConfig getSessionCookieConfig()
```
    Specified by:
    
    getSessionCookieConfig in interface javax.servlet.ServletContext
  - getDefaultSessionTrackingModes
```
public Set<javax.servlet.SessionTrackingMode> getDefaultSessionTrackingModes()
```
    Specified by:
    
    getDefaultSessionTrackingModes in interface javax.servlet.ServletContext
  - getEffectiveSessionTrackingModes
```
public Set<javax.servlet.SessionTrackingMode> getEffectiveSessionTrackingModes()
```
    Specified by:
    
    getEffectiveSessionTrackingModes in interface javax.servlet.ServletContext
  - setSessionTrackingModes
```
public void setSessionTrackingModes(Set<javax.servlet.SessionTrackingMode> sessionTrackingModes)
                             throws IllegalStateException,
                                    IllegalArgumentException
```
    Specified by:
    
    setSessionTrackingModes in interface javax.servlet.ServletContext
    
    Throws:
    
    IllegalStateException
    
    IllegalArgumentException

Class MockServletContext

Field Summary

Fields inherited from interface javax.servlet.ServletContext

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Constructor Detail

MockServletContext

MockServletContext

MockServletContext

MockServletContext

Method Detail

getResourceLocation

setContextPath

getContextPath

registerContext

getContext

setMajorVersion

getMajorVersion

setMinorVersion

getMinorVersion

setEffectiveMajorVersion

getEffectiveMajorVersion

setEffectiveMinorVersion

getEffectiveMinorVersion

getMimeType

getResourcePaths

getResource

getResourceAsStream

getRequestDispatcher

getNamedDispatcher

getServlet

getServlets

getServletNames

log

log

log

getRealPath

getServerInfo

getInitParameter

getInitParameterNames

setInitParameter

addInitParameter

getAttribute

getAttributeNames

setAttribute

removeAttribute

setServletContextName

getServletContextName

getClassLoader

declareRoles

getDeclaredRoles

getJspConfigDescriptor

addServlet

addServlet

addServlet

createServlet

getServletRegistration

getServletRegistrations

addFilter

addFilter

addFilter

createFilter

getFilterRegistration

getFilterRegistrations

addListener

addListener

addListener

createListener

getSessionCookieConfig

getDefaultSessionTrackingModes

getEffectiveSessionTrackingModes

setSessionTrackingModes