Class MockServletContext
- java.lang.Object
-
- com.avoka.tm.test.MockServletContext
-
- All Implemented Interfaces:
ServletContext
public class MockServletContext extends Object implements 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
Fields Modifier and Type Field Description static String
DEFAULT_CONTEXT_PATH
The servlet context default context path, "/mock".-
Fields inherited from interface javax.servlet.ServletContext
ORDERED_LIBS, TEMPDIR
-
-
Constructor Summary
Constructors Constructor Description MockServletContext()
Default 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
All Methods Instance Methods Concrete Methods Modifier and Type Method Description FilterRegistration.Dynamic
addFilter(String filterName, Class<? extends Filter> filterClass)
FilterRegistration.Dynamic
addFilter(String filterName, String className)
FilterRegistration.Dynamic
addFilter(String filterName, Filter filter)
void
addInitParameter(String name, String value)
Add an init parameter.void
addInitParameters(Map<String,String> initParameters)
Add the map of init parameters.ServletRegistration.Dynamic
addJspFile(String a, String b)
void
addListener(Class<? extends EventListener> listenerClass)
void
addListener(String className)
<T extends EventListener>
voidaddListener(T t)
void
addMimeType(String fileExtension, String mimeType)
Add a new recognized mime type.ServletRegistration.Dynamic
addServlet(String servletName, Class<? extends Servlet> servletClass)
ServletRegistration.Dynamic
addServlet(String servletName, String className)
ServletRegistration.Dynamic
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)
void
createTempDir()
Creates a temporary directory as specified bygetTempPath()
.void
createWebappRoot()
Creates the web application root FilegetWebappRoot()
.void
declareRoles(String... roleNames)
Object
getAttribute(String name)
Get an attribute with the given name.Enumeration<String>
getAttributeNames()
Get all of the attribute names.ClassLoader
getClassLoader()
ServletContext
getContext(String name)
Get the context for the given URL path.String
getContextPath()
Return the servlet context path.Set<SessionTrackingMode>
getDefaultSessionTrackingModes()
int
getEffectiveMajorVersion()
int
getEffectiveMinorVersion()
Set<SessionTrackingMode>
getEffectiveSessionTrackingModes()
FilterRegistration
getFilterRegistration(String filterName)
Map<String,? extends FilterRegistration>
getFilterRegistrations()
String
getInitParameter(String name)
Get the init parameter with the given name.Enumeration<String>
getInitParameterNames()
Get the name of all of the init parameters.JspConfigDescriptor
getJspConfigDescriptor()
int
getMajorVersion()
Return the major version of the Servlet spec that this package supports, defaults to 2.String
getMimeType(String name)
Get the mime type for the given file.int
getMinorVersion()
Return the minor version of the Servlet spec that this package supports, defaults to 3.RequestDispatcher
getNamedDispatcher(String name)
Returns a RequestDispatcher for the specified name.String
getRealPath(String name)
Get the real file path of the given resource name.String
getRequestCharacterEncoding()
RequestDispatcher
getRequestDispatcher(String path)
Returns a RequestDispatcher for the specified path.URL
getResource(String name)
Get the URL for a particular resource that is relative to the web app root directory.InputStream
getResourceAsStream(String name)
Get an input stream for a particular resource that is relative to the web app root directory or the current classpath.Set<String>
getResourcePaths(String name)
Get the resource paths starting from the web app root directory and then relative to the given name.String
getResponseCharacterEncoding()
String
getServerInfo()
Get the server info.Servlet
getServlet(String name)
NOT USED - Servlet Spec requires that this always returns null.String
getServletContextName()
Return the name of the servlet context.Enumeration<String>
getServletNames()
NOT USED - Servlet spec requires that this always returns null.ServletRegistration
getServletRegistration(String servletName)
Map<String,? extends ServletRegistration>
getServletRegistrations()
Enumeration<Servlet>
getServlets()
NOT USED - Servlet spec requires that this always returns null.SessionCookieConfig
getSessionCookieConfig()
int
getSessionTimeout()
String
getTempPath()
Return the temporary path where files are stored during test runs.String
getVirtualServerName()
String
getWebappPath()
Return the web application path where resources like javascript, css and images can be picked up.File
getWebappRoot()
Return the web application root File where resources like javascript, css and images can be picked up.void
log(Exception e, String msg)
Log the exception to System.err and the message to System.out.void
log(String msg)
Log the message to System.out.void
log(String msg, Throwable cause)
Log the cause to System.err and the message to System.out.void
removeAttribute(String name)
Remove an attribute with the given name.void
setAttribute(String name, Object o)
Set an attribute.void
setContextPath(String contextPath)
Sets the servlet context path.boolean
setInitParameter(String name, String value)
void
setRequestCharacterEncoding(String encoding)
void
setResponseCharacterEncoding(String encoding)
void
setServletContextName(String servletContextName)
Set the servlet context name to the specified value.void
setSessionTimeout(int time)
void
setSessionTrackingModes(Set<SessionTrackingMode> sessionTrackingModes)
void
setTempPath(String tempPath)
Set the temporary path where files are stored during test runs.void
setWebappPath(String webappPath)
Sets the mock web application path to the specified webappPath.
-
-
-
Field Detail
-
DEFAULT_CONTEXT_PATH
public static final String DEFAULT_CONTEXT_PATH
The servlet context default context path, "/mock".- See Also:
- Constant Field Values
-
-
Constructor Detail
-
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
public MockServletContext(String contextPath, String webappPath)
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
public MockServletContext(String contextPath, String webappPath, String tempPath)
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 Detail
-
createWebappRoot
public void createWebappRoot()
Creates the web application root FilegetWebappRoot()
.
-
createTempDir
public void createTempDir()
Creates a temporary directory as specified bygetTempPath()
.
-
setServletContextName
public void setServletContextName(String servletContextName)
Set the servlet context name to the specified value.- Parameters:
servletContextName
- the servlet context name
-
getTempPath
public String getTempPath()
Return the temporary path where files are stored during test runs.- Returns:
- the temporary path where files are stored during test runs
-
setTempPath
public void setTempPath(String tempPath)
Set the temporary path where files are stored during test runs.- Parameters:
tempPath
- the temporary path where files are stored during test runs
-
getWebappPath
public String getWebappPath()
Return the web application path where resources like javascript, css and images can be picked up.- Returns:
- the web application path
-
getWebappRoot
public File 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
public void setWebappPath(String webappPath)
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
public void addInitParameter(String name, String value)
Add an init parameter.- Parameters:
name
- The parameter namevalue
- The parameter value
-
addInitParameters
public void addInitParameters(Map<String,String> initParameters)
Add the map of init parameters.- Parameters:
initParameters
- A map of init parameters
-
addMimeType
public void addMimeType(String fileExtension, String mimeType)
Add a new recognized mime type.- Parameters:
fileExtension
- The file extension (e.g. "jpg")mimeType
- The mime type (e.g. "image/jpeg")
-
getAttribute
public Object getAttribute(String name)
Get an attribute with the given name.- Specified by:
getAttribute
in interfaceServletContext
- Parameters:
name
- The attribute name- Returns:
- The value, or null
-
getAttributeNames
public Enumeration<String> getAttributeNames()
Get all of the attribute names.- Specified by:
getAttributeNames
in interfaceServletContext
- Returns:
- The attribute names
-
getContext
public ServletContext getContext(String name)
Get the context for the given URL path.- Specified by:
getContext
in interfaceServletContext
- Parameters:
name
- The url path- Returns:
- Always returns this
-
getContextPath
public String getContextPath()
Return the servlet context path.- Specified by:
getContextPath
in interfaceServletContext
- Returns:
- the servletContext path
-
setContextPath
public void setContextPath(String contextPath)
Sets the servlet context path.- Parameters:
contextPath
- the servlet context path
-
getInitParameter
public String getInitParameter(String name)
Get the init parameter with the given name.- Specified by:
getInitParameter
in interfaceServletContext
- Parameters:
name
- The name- Returns:
- The parameter, or null if no such parameter
-
getInitParameterNames
public Enumeration<String> getInitParameterNames()
Get the name of all of the init parameters.- Specified by:
getInitParameterNames
in 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:
getMajorVersion
in interfaceServletContext
- Returns:
- the major version of the Servlet spec that this package supports, defaults to 2.
-
getMimeType
public String getMimeType(String name)
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:
getMimeType
in 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:
getMinorVersion
in interfaceServletContext
- Returns:
- the minor version of the Servlet spec that this package supports, defaults to 3.
-
getRealPath
public String getRealPath(String name)
Get the real file path of the given resource name.- Specified by:
getRealPath
in interfaceServletContext
- Parameters:
name
- The name- Returns:
- The real path or null
-
getRequestDispatcher
public RequestDispatcher getRequestDispatcher(String path)
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:
getRequestDispatcher
in interfaceServletContext
- Parameters:
path
- a String specifying the pathname to the resource- Returns:
- a dispatcher for the specified path
-
getNamedDispatcher
public RequestDispatcher getNamedDispatcher(String name)
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:
getNamedDispatcher
in interfaceServletContext
- Parameters:
name
- a String specifying the name of a servlet to wrap- Returns:
- a dispatcher for the specified name
-
getResource
public URL getResource(String name) throws MalformedURLException
Get the URL for a particular resource that is relative to the web app root directory.- Specified by:
getResource
in 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
public InputStream getResourceAsStream(String name)
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:
getResourceAsStream
in 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
public Set<String> getResourcePaths(String name)
Get the resource paths starting from the web app root directory and then relative to the given name.- Specified by:
getResourcePaths
in interfaceServletContext
- Parameters:
name
- The starting name- Returns:
- The set of resource paths at this location
-
getServerInfo
public String getServerInfo()
Get the server info.- Specified by:
getServerInfo
in interfaceServletContext
- Returns:
- The server info
-
getServlet
public Servlet getServlet(String name)
NOT USED - Servlet Spec requires that this always returns null.- Specified by:
getServlet
in interfaceServletContext
- Parameters:
name
- Not used- Returns:
- null
-
getServletContextName
public String getServletContextName()
Return the name of the servlet context.- Specified by:
getServletContextName
in interfaceServletContext
- Returns:
- The name
-
getServletNames
public Enumeration<String> getServletNames()
NOT USED - Servlet spec requires that this always returns null.- Specified by:
getServletNames
in interfaceServletContext
- Returns:
- null
-
getServlets
public Enumeration<Servlet> getServlets()
NOT USED - Servlet spec requires that this always returns null.- Specified by:
getServlets
in interfaceServletContext
- Returns:
- null
-
log
public void log(Exception e, String msg)
Log the exception to System.err and the message to System.out.- Specified by:
log
in interfaceServletContext
- Parameters:
e
- The exception to logmsg
- The message to log
-
log
public void log(String msg)
Log the message to System.out.- Specified by:
log
in interfaceServletContext
- Parameters:
msg
- The message to log
-
log
public void log(String msg, Throwable cause)
Log the cause to System.err and the message to System.out.- Specified by:
log
in interfaceServletContext
- Parameters:
msg
- The message to logcause
- The cause exception
-
removeAttribute
public void removeAttribute(String name)
Remove an attribute with the given name.- Specified by:
removeAttribute
in interfaceServletContext
- Parameters:
name
- The name
-
setAttribute
public void setAttribute(String name, Object o)
Set an attribute.- Specified by:
setAttribute
in interfaceServletContext
- Parameters:
name
- The name of the attributeo
- The value
-
setResponseCharacterEncoding
public void setResponseCharacterEncoding(String encoding)
- Specified by:
setResponseCharacterEncoding
in interfaceServletContext
-
getResponseCharacterEncoding
public String getResponseCharacterEncoding()
- Specified by:
getResponseCharacterEncoding
in interfaceServletContext
-
setRequestCharacterEncoding
public void setRequestCharacterEncoding(String encoding)
- Specified by:
setRequestCharacterEncoding
in interfaceServletContext
-
getRequestCharacterEncoding
public String getRequestCharacterEncoding()
- Specified by:
getRequestCharacterEncoding
in interfaceServletContext
-
setSessionTimeout
public void setSessionTimeout(int time)
- Specified by:
setSessionTimeout
in interfaceServletContext
-
getSessionTimeout
public int getSessionTimeout()
- Specified by:
getSessionTimeout
in interfaceServletContext
-
addJspFile
public ServletRegistration.Dynamic addJspFile(String a, String b)
- Specified by:
addJspFile
in interfaceServletContext
-
getEffectiveMajorVersion
public int getEffectiveMajorVersion()
- Specified by:
getEffectiveMajorVersion
in interfaceServletContext
-
getEffectiveMinorVersion
public int getEffectiveMinorVersion()
- Specified by:
getEffectiveMinorVersion
in interfaceServletContext
-
setInitParameter
public boolean setInitParameter(String name, String value)
- Specified by:
setInitParameter
in interfaceServletContext
-
addServlet
public ServletRegistration.Dynamic addServlet(String servletName, String className)
- Specified by:
addServlet
in interfaceServletContext
-
addServlet
public ServletRegistration.Dynamic addServlet(String servletName, Servlet servlet)
- Specified by:
addServlet
in interfaceServletContext
-
addServlet
public ServletRegistration.Dynamic addServlet(String servletName, Class<? extends Servlet> servletClass)
- Specified by:
addServlet
in interfaceServletContext
-
createServlet
public <T extends Servlet> T createServlet(Class<T> clazz)
- Specified by:
createServlet
in interfaceServletContext
-
getServletRegistration
public ServletRegistration getServletRegistration(String servletName)
- Specified by:
getServletRegistration
in interfaceServletContext
-
getServletRegistrations
public Map<String,? extends ServletRegistration> getServletRegistrations()
- Specified by:
getServletRegistrations
in interfaceServletContext
-
addFilter
public FilterRegistration.Dynamic addFilter(String filterName, String className)
- Specified by:
addFilter
in interfaceServletContext
-
addFilter
public FilterRegistration.Dynamic addFilter(String filterName, Filter filter)
- Specified by:
addFilter
in interfaceServletContext
-
addFilter
public FilterRegistration.Dynamic addFilter(String filterName, Class<? extends Filter> filterClass)
- Specified by:
addFilter
in interfaceServletContext
-
createFilter
public <T extends Filter> T createFilter(Class<T> clazz)
- Specified by:
createFilter
in interfaceServletContext
-
getFilterRegistration
public FilterRegistration getFilterRegistration(String filterName)
- Specified by:
getFilterRegistration
in interfaceServletContext
-
getFilterRegistrations
public Map<String,? extends FilterRegistration> getFilterRegistrations()
- Specified by:
getFilterRegistrations
in interfaceServletContext
-
getSessionCookieConfig
public SessionCookieConfig getSessionCookieConfig()
- Specified by:
getSessionCookieConfig
in interfaceServletContext
-
setSessionTrackingModes
public void setSessionTrackingModes(Set<SessionTrackingMode> sessionTrackingModes)
- Specified by:
setSessionTrackingModes
in interfaceServletContext
-
getDefaultSessionTrackingModes
public Set<SessionTrackingMode> getDefaultSessionTrackingModes()
- Specified by:
getDefaultSessionTrackingModes
in interfaceServletContext
-
getEffectiveSessionTrackingModes
public Set<SessionTrackingMode> getEffectiveSessionTrackingModes()
- Specified by:
getEffectiveSessionTrackingModes
in interfaceServletContext
-
addListener
public void addListener(String className)
- Specified by:
addListener
in interfaceServletContext
-
addListener
public <T extends EventListener> void addListener(T t)
- Specified by:
addListener
in interfaceServletContext
-
addListener
public void addListener(Class<? extends EventListener> listenerClass)
- Specified by:
addListener
in interfaceServletContext
-
createListener
public <T extends EventListener> T createListener(Class<T> clazz)
- Specified by:
createListener
in interfaceServletContext
-
getJspConfigDescriptor
public JspConfigDescriptor getJspConfigDescriptor()
- Specified by:
getJspConfigDescriptor
in interfaceServletContext
-
getClassLoader
public ClassLoader getClassLoader()
- Specified by:
getClassLoader
in interfaceServletContext
-
declareRoles
public void declareRoles(String... roleNames)
- Specified by:
declareRoles
in interfaceServletContext
-
getVirtualServerName
public String getVirtualServerName()
- Specified by:
getVirtualServerName
in interfaceServletContext
-
-