Class MockServletContext
- All Implemented Interfaces:
ServletContext
Mock implementation of ServletContext.
This implementation supports all of the standard context methods except for request dispatching which just indicates what is being dispatched to, rather than performing an actual dispatch.
The context can be configured with a path parameter that should point to an directory location that represents the place where the contents of the WAR bundle are located. The path can either be an absolute or relative path. If the path is not found, the classpath will be checked for such a directory. Setting this value allows all of the resource location functionality to work as in a fully functioning web application. If this value is not set then not resource location functionality will work and instead null will always be returned.
This class was adapted from Apache Wicket.
- Since:
- 17.10.0
-
Field Summary
FieldsModifier and TypeFieldDescriptionstatic final StringThe servlet context default context path, "/mock".Fields inherited from interface javax.servlet.ServletContext
ORDERED_LIBS, TEMPDIR -
Constructor Summary
ConstructorsConstructorDescriptionDefault constructor for this mock object.MockServletContext(String contextPath, String webappPath) Create the mock object.MockServletContext(String contextPath, String webappPath, String tempPath) Create the mock object. -
Method Summary
Modifier and TypeMethodDescriptionvoidaddInitParameter(String name, String value) Add an init parameter.voidaddInitParameters(Map<String, String> initParameters) Add the map of init parameters.addJspFile(String a, String b) voidaddListener(Class<? extends EventListener> listenerClass) voidaddListener(String className) <T extends EventListener>
voidaddListener(T t) voidaddMimeType(String fileExtension, String mimeType) Add a new recognized mime type.addServlet(String servletName, Class<? extends Servlet> servletClass) addServlet(String servletName, String className) addServlet(String servletName, Servlet servlet) <T extends Filter>
TcreateFilter(Class<T> clazz) <T extends EventListener>
TcreateListener(Class<T> clazz) <T extends Servlet>
TcreateServlet(Class<T> clazz) voidCreates a temporary directory as specified bygetTempPath().voidCreates the web application root FilegetWebappRoot().voiddeclareRoles(String... roleNames) getAttribute(String name) Get an attribute with the given name.Get all of the attribute names.getContext(String name) Get the context for the given URL path.Return the servlet context path.intintgetFilterRegistration(String filterName) Map<String,? extends FilterRegistration> getInitParameter(String name) Get the init parameter with the given name.Get the name of all of the init parameters.intReturn the major version of the Servlet spec that this package supports, defaults to 2.getMimeType(String name) Get the mime type for the given file.intReturn the minor version of the Servlet spec that this package supports, defaults to 3.getNamedDispatcher(String name) Returns a RequestDispatcher for the specified name.getRealPath(String name) Get the real file path of the given resource name.getRequestDispatcher(String path) Returns a RequestDispatcher for the specified path.getResource(String name) Get the URL for a particular resource that is relative to the web app root directory.getResourceAsStream(String name) Get an input stream for a particular resource that is relative to the web app root directory or the current classpath.getResourcePaths(String name) Get the resource paths starting from the web app root directory and then relative to the given name.Get the server info.getServlet(String name) NOT USED - Servlet Spec requires that this always returns null.Return the name of the servlet context.NOT USED - Servlet spec requires that this always returns null.getServletRegistration(String servletName) Map<String,? extends ServletRegistration> NOT USED - Servlet spec requires that this always returns null.intReturn the temporary path where files are stored during test runs.Return the web application path where resources like javascript, css and images can be picked up.Return the web application root File where resources like javascript, css and images can be picked up.voidLog the exception to System.err and the message to System.out.voidLog the message to System.out.voidLog the cause to System.err and the message to System.out.voidremoveAttribute(String name) Remove an attribute with the given name.voidsetAttribute(String name, Object o) Set an attribute.voidsetContextPath(String contextPath) Sets the servlet context path.booleansetInitParameter(String name, String value) voidsetRequestCharacterEncoding(String encoding) voidsetResponseCharacterEncoding(String encoding) voidsetServletContextName(String servletContextName) Set the servlet context name to the specified value.voidsetSessionTimeout(int time) voidsetSessionTrackingModes(Set<SessionTrackingMode> sessionTrackingModes) voidsetTempPath(String tempPath) Set the temporary path where files are stored during test runs.voidsetWebappPath(String webappPath) Sets the mock web application path to the specified webappPath.
-
Field Details
-
DEFAULT_CONTEXT_PATH
The servlet context default context path, "/mock".- See Also:
-
-
Constructor Details
-
MockServletContext
public MockServletContext()Default constructor for this mock object. The servlet context name is set to 'mock'. The web content root and temporary work direcotry are set to null. -
MockServletContext
Create the mock object. As part of the creation, the context sets the root directory where web application content is stored. This must be an ABSOLUTE directory relative to where the tests are being executed.
For example:
System.getProperty("user.dir") + "/src/webapp"In addition to setting the web root directory, this constructor also sets up a temporary work directory for things like file uploads.
Note this temporary work directory is set as the value of the ServletContext attribute 'javax.servlet.context.tempdir'.
The temporary work directory defaults to System.getProperty("java.io.tmpdir").
- Parameters:
contextPath- the servlet context pathwebappPath- The path to the root of the web application
-
MockServletContext
Create the mock object. As part of the creation, the context sets the root directory where web application content is stored. This must be an ABSOLUTE directory relative to where the tests are being executed.
For example:
System.getProperty("user.dir") + "/src/webapp"In addition to setting the web root directory, this constructor also sets up a temporary work directory for things like file uploads.
Note this temporary work directory is set as the value of the ServletContext attribute 'javax.servlet.context.tempdir'.
- Parameters:
contextPath- the servlet context pathwebappPath- the path to the root of the web applicationtempPath- the temporary work directory
-
-
Method Details
-
createWebappRoot
public void createWebappRoot()Creates the web application root FilegetWebappRoot(). -
createTempDir
public void createTempDir()Creates a temporary directory as specified bygetTempPath(). -
setServletContextName
Set the servlet context name to the specified value.- Parameters:
servletContextName- the servlet context name
-
getTempPath
Return the temporary path where files are stored during test runs.- Returns:
- the temporary path where files are stored during test runs
-
setTempPath
Set the temporary path where files are stored during test runs.- Parameters:
tempPath- the temporary path where files are stored during test runs
-
getWebappPath
Return the web application path where resources like javascript, css and images can be picked up.- Returns:
- the web application path
-
getWebappRoot
Return the web application root File where resources like javascript, css and images can be picked up.- Returns:
- the web application root File
-
setWebappPath
Sets the mock web application path to the specified webappPath.
Note: this method will also set the web application's temporary directory to the value
getTempPath(). IfgetTempPath()is not set, this method will default tempPath to: System.getProperty("java.io.tmpdir").- Parameters:
webappPath- set the context web application path
-
addInitParameter
Add an init parameter.- Parameters:
name- The parameter namevalue- The parameter value
-
addInitParameters
Add the map of init parameters.- Parameters:
initParameters- A map of init parameters
-
addMimeType
Add a new recognized mime type.- Parameters:
fileExtension- The file extension (e.g. "jpg")mimeType- The mime type (e.g. "image/jpeg")
-
getAttribute
Get an attribute with the given name.- Specified by:
getAttributein interfaceServletContext- Parameters:
name- The attribute name- Returns:
- The value, or null
-
getAttributeNames
Get all of the attribute names.- Specified by:
getAttributeNamesin interfaceServletContext- Returns:
- The attribute names
-
getContext
Get the context for the given URL path.- Specified by:
getContextin interfaceServletContext- Parameters:
name- The url path- Returns:
- Always returns this
-
getContextPath
Return the servlet context path.- Specified by:
getContextPathin interfaceServletContext- Returns:
- the servletContext path
-
setContextPath
Sets the servlet context path.- Parameters:
contextPath- the servlet context path
-
getInitParameter
Get the init parameter with the given name.- Specified by:
getInitParameterin interfaceServletContext- Parameters:
name- The name- Returns:
- The parameter, or null if no such parameter
-
getInitParameterNames
Get the name of all of the init parameters.- Specified by:
getInitParameterNamesin interfaceServletContext- Returns:
- The init parameter names
-
getMajorVersion
public int getMajorVersion()Return the major version of the Servlet spec that this package supports, defaults to 2.- Specified by:
getMajorVersionin interfaceServletContext- Returns:
- the major version of the Servlet spec that this package supports, defaults to 2.
-
getMimeType
Get the mime type for the given file. Uses a hardcoded map of mime types set at initialization time. If the mime type was not explicitly set, this method will fallback to- Specified by:
getMimeTypein interfaceServletContext- Parameters:
name- The name to get the mime type for- Returns:
- The mime type
-
getMinorVersion
public int getMinorVersion()Return the minor version of the Servlet spec that this package supports, defaults to 3.- Specified by:
getMinorVersionin interfaceServletContext- Returns:
- the minor version of the Servlet spec that this package supports, defaults to 3.
-
getRealPath
Get the real file path of the given resource name.- Specified by:
getRealPathin interfaceServletContext- Parameters:
name- The name- Returns:
- The real path or null
-
getRequestDispatcher
Returns a RequestDispatcher for the specified path. The dispatcher will not dispatch to the resource. It only records the specified path so that one can test if the correct path was dispatched to.- Specified by:
getRequestDispatcherin interfaceServletContext- Parameters:
path- a String specifying the pathname to the resource- Returns:
- a dispatcher for the specified path
-
getNamedDispatcher
Returns a RequestDispatcher for the specified name. The dispatcher will not dispatch to the resource. It only records the specified name so that one can test if the correct name was dispatched to.- Specified by:
getNamedDispatcherin interfaceServletContext- Parameters:
name- a String specifying the name of a servlet to wrap- Returns:
- a dispatcher for the specified name
-
getResource
Get the URL for a particular resource that is relative to the web app root directory.- Specified by:
getResourcein interfaceServletContext- Parameters:
name- The name of the resource to get- Returns:
- The resource, or null if resource not found
- Throws:
MalformedURLException- If the URL is invalid
-
getResourceAsStream
Get an input stream for a particular resource that is relative to the web app root directory or the current classpath. If the webappRoot is not set, this method will try and load the resource from the classpath.- Specified by:
getResourceAsStreamin interfaceServletContext- Parameters:
name- The name of the resource to get- Returns:
- The input stream for the resource, or null if resource is not found
-
getResourcePaths
Get the resource paths starting from the web app root directory and then relative to the given name.- Specified by:
getResourcePathsin interfaceServletContext- Parameters:
name- The starting name- Returns:
- The set of resource paths at this location
-
getServerInfo
Get the server info.- Specified by:
getServerInfoin interfaceServletContext- Returns:
- The server info
-
getServlet
NOT USED - Servlet Spec requires that this always returns null.- Specified by:
getServletin interfaceServletContext- Parameters:
name- Not used- Returns:
- null
-
getServletContextName
Return the name of the servlet context.- Specified by:
getServletContextNamein interfaceServletContext- Returns:
- The name
-
getServletNames
NOT USED - Servlet spec requires that this always returns null.- Specified by:
getServletNamesin interfaceServletContext- Returns:
- null
-
getServlets
NOT USED - Servlet spec requires that this always returns null.- Specified by:
getServletsin interfaceServletContext- Returns:
- null
-
log
Log the exception to System.err and the message to System.out.- Specified by:
login interfaceServletContext- Parameters:
e- The exception to logmsg- The message to log
-
log
Log the message to System.out.- Specified by:
login interfaceServletContext- Parameters:
msg- The message to log
-
log
Log the cause to System.err and the message to System.out.- Specified by:
login interfaceServletContext- Parameters:
msg- The message to logcause- The cause exception
-
removeAttribute
Remove an attribute with the given name.- Specified by:
removeAttributein interfaceServletContext- Parameters:
name- The name
-
setAttribute
Set an attribute.- Specified by:
setAttributein interfaceServletContext- Parameters:
name- The name of the attributeo- The value
-
setResponseCharacterEncoding
- Specified by:
setResponseCharacterEncodingin interfaceServletContext
-
getResponseCharacterEncoding
- Specified by:
getResponseCharacterEncodingin interfaceServletContext
-
setRequestCharacterEncoding
- Specified by:
setRequestCharacterEncodingin interfaceServletContext
-
getRequestCharacterEncoding
- Specified by:
getRequestCharacterEncodingin interfaceServletContext
-
setSessionTimeout
public void setSessionTimeout(int time) - Specified by:
setSessionTimeoutin interfaceServletContext
-
getSessionTimeout
public int getSessionTimeout()- Specified by:
getSessionTimeoutin interfaceServletContext
-
addJspFile
- Specified by:
addJspFilein interfaceServletContext
-
getEffectiveMajorVersion
public int getEffectiveMajorVersion()- Specified by:
getEffectiveMajorVersionin interfaceServletContext
-
getEffectiveMinorVersion
public int getEffectiveMinorVersion()- Specified by:
getEffectiveMinorVersionin interfaceServletContext
-
setInitParameter
- Specified by:
setInitParameterin interfaceServletContext
-
addServlet
- Specified by:
addServletin interfaceServletContext
-
addServlet
- Specified by:
addServletin interfaceServletContext
-
addServlet
public ServletRegistration.Dynamic addServlet(String servletName, Class<? extends Servlet> servletClass) - Specified by:
addServletin interfaceServletContext
-
createServlet
- Specified by:
createServletin interfaceServletContext
-
getServletRegistration
- Specified by:
getServletRegistrationin interfaceServletContext
-
getServletRegistrations
- Specified by:
getServletRegistrationsin interfaceServletContext
-
addFilter
- Specified by:
addFilterin interfaceServletContext
-
addFilter
- Specified by:
addFilterin interfaceServletContext
-
addFilter
- Specified by:
addFilterin interfaceServletContext
-
createFilter
- Specified by:
createFilterin interfaceServletContext
-
getFilterRegistration
- Specified by:
getFilterRegistrationin interfaceServletContext
-
getFilterRegistrations
- Specified by:
getFilterRegistrationsin interfaceServletContext
-
getSessionCookieConfig
- Specified by:
getSessionCookieConfigin interfaceServletContext
-
setSessionTrackingModes
- Specified by:
setSessionTrackingModesin interfaceServletContext
-
getDefaultSessionTrackingModes
- Specified by:
getDefaultSessionTrackingModesin interfaceServletContext
-
getEffectiveSessionTrackingModes
- Specified by:
getEffectiveSessionTrackingModesin interfaceServletContext
-
addListener
- Specified by:
addListenerin interfaceServletContext
-
addListener
- Specified by:
addListenerin interfaceServletContext
-
addListener
- Specified by:
addListenerin interfaceServletContext
-
createListener
- Specified by:
createListenerin interfaceServletContext
-
getJspConfigDescriptor
- Specified by:
getJspConfigDescriptorin interfaceServletContext
-
getClassLoader
- Specified by:
getClassLoaderin interfaceServletContext
-
declareRoles
- Specified by:
declareRolesin interfaceServletContext
-
getVirtualServerName
- Specified by:
getVirtualServerNamein interfaceServletContext
-