MockServletContext

Overview

Package

Class

Tree

Deprecated

Index

Help

PREV CLASS NEXT CLASS

FRAMES NO FRAMES

SUMMARY: NESTED | FIELD | CONSTR | METHOD

DETAIL: FIELD | CONSTR | METHOD

org.springframework.mock.web
Class MockServletContext

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

All Implemented Interfaces:: ServletContext

public class MockServletContext
extends Object
implements ServletContext
extends Object
implements 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

Constructor Summary
`MockServletContext()` Create a new MockServletContext, using no base path and a DefaultResourceLoader (i.e.
`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
`void`	`addInitParameter(String name, String value)`
`void`	`declareRoles(String... roleNames)`
`Object`	`getAttribute(String name)`
`Enumeration<String>`	`getAttributeNames()`
`ClassLoader`	`getClassLoader()`
`ServletContext`	`getContext(String contextPath)`
`String`	`getContextPath()`
`Set<String>`	`getDeclaredRoles()`
`int`	`getEffectiveMajorVersion()`
`int`	`getEffectiveMinorVersion()`
`String`	`getInitParameter(String name)`
`Enumeration<String>`	`getInitParameterNames()`
`int`	`getMajorVersion()`
`String`	`getMimeType(String filePath)`
`int`	`getMinorVersion()`
`RequestDispatcher`	`getNamedDispatcher(String path)`
`String`	`getRealPath(String path)`
`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()`
`Servlet`	`getServlet(String name)`
`String`	`getServletContextName()`
`Enumeration<String>`	`getServletNames()`
`Enumeration<Servlet>`	`getServlets()`
`void`	`log(Exception ex, String message)`
`void`	`log(String message)`
`void`	`log(String message, Throwable ex)`
`void`	`registerContext(String contextPath, 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)`

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

Constructor Detail