public class MockHttpServletRequest
extends java.lang.Object
implements javax.servlet.http.HttpServletRequest
HttpServletRequest
interface.Modifier and Type | Field and Description |
---|---|
static java.lang.String |
DEFAULT_PROTOCOL
The default protocol: 'http'.
|
static java.lang.String |
DEFAULT_REMOTE_ADDR
The default remote address: '127.0.0.1'.
|
static java.lang.String |
DEFAULT_REMOTE_HOST
The default remote host: 'localhost'.
|
static java.lang.String |
DEFAULT_SERVER_ADDR
The default server address: '127.0.0.1'.
|
static java.lang.String |
DEFAULT_SERVER_NAME
The default server name: 'localhost'.
|
static int |
DEFAULT_SERVER_PORT
The default server port: '80'.
|
Constructor and Description |
---|
MockHttpServletRequest()
Create a new
MockHttpServletRequest with a default
MockServletContext . |
MockHttpServletRequest(javax.servlet.ServletContext servletContext)
Create a new
MockHttpServletRequest with the supplied ServletContext . |
MockHttpServletRequest(javax.servlet.ServletContext servletContext,
java.lang.String method,
java.lang.String requestURI)
Create a new
MockHttpServletRequest with the supplied ServletContext ,
method , and requestURI . |
MockHttpServletRequest(java.lang.String method,
java.lang.String requestURI)
Create a new
MockHttpServletRequest with a default
MockServletContext . |
Modifier and Type | Method and Description |
---|---|
void |
addHeader(java.lang.String name,
java.lang.Object value)
Add a header entry for the given name.
|
void |
addParameter(java.lang.String name,
java.lang.String value)
Add a single value for the specified HTTP parameter.
|
void |
addParameter(java.lang.String name,
java.lang.String[] values)
Add an array of values for the specified HTTP parameter.
|
void |
addParameters(java.util.Map<?,?> params)
Adds all provided parameters without replacing any existing values.
|
void |
addPart(javax.servlet.http.Part part) |
void |
addPreferredLocale(java.util.Locale locale)
Add a new preferred locale, before any existing locales.
|
void |
addUserRole(java.lang.String role) |
boolean |
authenticate(javax.servlet.http.HttpServletResponse response) |
java.lang.String |
changeSessionId()
The implementation of this (Servlet 3.1+) method calls
MockHttpSession.changeSessionId() if the session is a mock session. |
protected void |
checkActive()
Check whether this request is still active (that is, not completed yet),
throwing an IllegalStateException if not active anymore.
|
void |
clearAttributes()
Clear all of this request's attributes.
|
void |
close()
Mark this request as completed, keeping its state.
|
javax.servlet.AsyncContext |
getAsyncContext() |
java.lang.Object |
getAttribute(java.lang.String name) |
java.util.Enumeration<java.lang.String> |
getAttributeNames() |
java.lang.String |
getAuthType() |
java.lang.String |
getCharacterEncoding() |
int |
getContentLength() |
long |
getContentLengthLong() |
java.lang.String |
getContentType() |
java.lang.String |
getContextPath() |
javax.servlet.http.Cookie[] |
getCookies() |
long |
getDateHeader(java.lang.String name)
Return the long timestamp for the date header with the given
name . |
javax.servlet.DispatcherType |
getDispatcherType() |
java.lang.String |
getHeader(java.lang.String name) |
java.util.Enumeration<java.lang.String> |
getHeaderNames() |
java.util.Enumeration<java.lang.String> |
getHeaders(java.lang.String name) |
javax.servlet.ServletInputStream |
getInputStream() |
int |
getIntHeader(java.lang.String name) |
java.lang.String |
getLocalAddr() |
java.util.Locale |
getLocale()
Return the first preferred locale configured
in this mock request.
|
java.util.Enumeration<java.util.Locale> |
getLocales()
Return an enumeration of the preferred
locales configured in this mock request.
|
java.lang.String |
getLocalName() |
int |
getLocalPort() |
java.lang.String |
getMethod() |
java.lang.String |
getParameter(java.lang.String name) |
java.util.Map<java.lang.String,java.lang.String[]> |
getParameterMap() |
java.util.Enumeration<java.lang.String> |
getParameterNames() |
java.lang.String[] |
getParameterValues(java.lang.String name) |
javax.servlet.http.Part |
getPart(java.lang.String name) |
java.util.Collection<javax.servlet.http.Part> |
getParts() |
java.lang.String |
getPathInfo() |
java.lang.String |
getPathTranslated() |
java.lang.String |
getProtocol() |
java.lang.String |
getQueryString() |
java.io.BufferedReader |
getReader() |
java.lang.String |
getRealPath(java.lang.String path)
Deprecated.
|
java.lang.String |
getRemoteAddr() |
java.lang.String |
getRemoteHost() |
int |
getRemotePort() |
java.lang.String |
getRemoteUser() |
javax.servlet.RequestDispatcher |
getRequestDispatcher(java.lang.String path) |
java.lang.String |
getRequestedSessionId() |
java.lang.String |
getRequestURI() |
java.lang.StringBuffer |
getRequestURL() |
java.lang.String |
getScheme() |
java.lang.String |
getServerName() |
int |
getServerPort() |
javax.servlet.ServletContext |
getServletContext()
Return the ServletContext that this request is associated with.
|
java.lang.String |
getServletPath() |
javax.servlet.http.HttpSession |
getSession() |
javax.servlet.http.HttpSession |
getSession(boolean create) |
java.security.Principal |
getUserPrincipal() |
void |
invalidate()
Invalidate this request, clearing its state.
|
boolean |
isActive()
Return whether this request is still active (that is, not completed yet).
|
boolean |
isAsyncStarted() |
boolean |
isAsyncSupported() |
boolean |
isRequestedSessionIdFromCookie() |
boolean |
isRequestedSessionIdFromUrl()
Deprecated.
|
boolean |
isRequestedSessionIdFromURL() |
boolean |
isRequestedSessionIdValid() |
boolean |
isSecure()
|
boolean |
isUserInRole(java.lang.String role) |
void |
login(java.lang.String username,
java.lang.String password) |
void |
logout() |
void |
removeAllParameters()
Removes all existing parameters.
|
void |
removeAttribute(java.lang.String name) |
void |
removeParameter(java.lang.String name)
Remove already registered values for the specified HTTP parameter, if any.
|
void |
setAsyncContext(MockAsyncContext asyncContext) |
void |
setAsyncStarted(boolean asyncStarted) |
void |
setAsyncSupported(boolean asyncSupported) |
void |
setAttribute(java.lang.String name,
java.lang.Object value) |
void |
setAuthType(java.lang.String authType) |
void |
setCharacterEncoding(java.lang.String characterEncoding) |
void |
setContent(byte[] content) |
void |
setContentType(java.lang.String contentType) |
void |
setContextPath(java.lang.String contextPath) |
void |
setCookies(javax.servlet.http.Cookie... cookies) |
void |
setDispatcherType(javax.servlet.DispatcherType dispatcherType) |
void |
setLocalAddr(java.lang.String localAddr) |
void |
setLocalName(java.lang.String localName) |
void |
setLocalPort(int localPort) |
void |
setMethod(java.lang.String method) |
void |
setParameter(java.lang.String name,
java.lang.String value)
Set a single value for the specified HTTP parameter.
|
void |
setParameter(java.lang.String name,
java.lang.String[] values)
Set an array of values for the specified HTTP parameter.
|
void |
setParameters(java.util.Map params)
Sets all provided parameters replacing any existing values for the provided parameter names.
|
void |
setPathInfo(java.lang.String pathInfo) |
void |
setPreferredLocales(java.util.List<java.util.Locale> locales)
Set the list of preferred locales, in descending order, effectively replacing
any existing locales.
|
void |
setProtocol(java.lang.String protocol) |
void |
setQueryString(java.lang.String queryString) |
void |
setRemoteAddr(java.lang.String remoteAddr) |
void |
setRemoteHost(java.lang.String remoteHost) |
void |
setRemotePort(int remotePort) |
void |
setRemoteUser(java.lang.String remoteUser) |
void |
setRequestedSessionId(java.lang.String requestedSessionId) |
void |
setRequestedSessionIdFromCookie(boolean requestedSessionIdFromCookie) |
void |
setRequestedSessionIdFromURL(boolean requestedSessionIdFromURL) |
void |
setRequestedSessionIdValid(boolean requestedSessionIdValid) |
void |
setRequestURI(java.lang.String requestURI) |
void |
setScheme(java.lang.String scheme) |
void |
setSecure(boolean secure)
Set the boolean
secure flag indicating whether the mock request
was made using a secure channel, such as HTTPS. |
void |
setServerName(java.lang.String serverName) |
void |
setServerPort(int serverPort) |
void |
setServletPath(java.lang.String servletPath) |
void |
setSession(javax.servlet.http.HttpSession session) |
void |
setUserPrincipal(java.security.Principal userPrincipal) |
javax.servlet.AsyncContext |
startAsync() |
javax.servlet.AsyncContext |
startAsync(javax.servlet.ServletRequest request,
javax.servlet.ServletResponse response) |
<T extends javax.servlet.http.HttpUpgradeHandler> |
upgrade(java.lang.Class<T> arg0) |
public static final java.lang.String DEFAULT_PROTOCOL
public static final java.lang.String DEFAULT_SERVER_ADDR
public static final java.lang.String DEFAULT_SERVER_NAME
public static final int DEFAULT_SERVER_PORT
public static final java.lang.String DEFAULT_REMOTE_ADDR
public static final java.lang.String DEFAULT_REMOTE_HOST
public MockHttpServletRequest()
MockHttpServletRequest
with a default
MockServletContext
.public MockHttpServletRequest(java.lang.String method, java.lang.String requestURI)
MockHttpServletRequest
with a default
MockServletContext
.method
- the request method (may be null
)requestURI
- the request URI (may be null
)setMethod(java.lang.String)
,
setRequestURI(java.lang.String)
,
MockHttpServletRequest(ServletContext, String, String)
public MockHttpServletRequest(javax.servlet.ServletContext servletContext)
MockHttpServletRequest
with the supplied ServletContext
.servletContext
- the ServletContext that the request runs in
(may be null
to use a default MockServletContext
)MockHttpServletRequest(ServletContext, String, String)
public MockHttpServletRequest(javax.servlet.ServletContext servletContext, java.lang.String method, java.lang.String requestURI)
MockHttpServletRequest
with the supplied ServletContext
,
method
, and requestURI
.
The preferred locale will be set to Locale.ENGLISH
.
servletContext
- the ServletContext that the request runs in (may be
null
to use a default MockServletContext
)method
- the request method (may be null
)requestURI
- the request URI (may be null
)setMethod(java.lang.String)
,
setRequestURI(java.lang.String)
,
setPreferredLocales(java.util.List<java.util.Locale>)
,
MockServletContext
public javax.servlet.ServletContext getServletContext()
getServletContext
in interface javax.servlet.ServletRequest
public boolean isActive()
public void close()
public void invalidate()
protected void checkActive() throws java.lang.IllegalStateException
java.lang.IllegalStateException
public java.lang.Object getAttribute(java.lang.String name)
getAttribute
in interface javax.servlet.ServletRequest
public java.util.Enumeration<java.lang.String> getAttributeNames()
getAttributeNames
in interface javax.servlet.ServletRequest
public java.lang.String getCharacterEncoding()
getCharacterEncoding
in interface javax.servlet.ServletRequest
public void setCharacterEncoding(java.lang.String characterEncoding)
setCharacterEncoding
in interface javax.servlet.ServletRequest
public void setContent(byte[] content)
public int getContentLength()
getContentLength
in interface javax.servlet.ServletRequest
public long getContentLengthLong()
getContentLengthLong
in interface javax.servlet.ServletRequest
public void setContentType(java.lang.String contentType)
public java.lang.String getContentType()
getContentType
in interface javax.servlet.ServletRequest
public javax.servlet.ServletInputStream getInputStream()
getInputStream
in interface javax.servlet.ServletRequest
public void setParameter(java.lang.String name, java.lang.String value)
If there are already one or more values registered for the given parameter name, they will be replaced.
name
- namevalue
- valuepublic void setParameter(java.lang.String name, java.lang.String[] values)
If there are already one or more values registered for the given parameter name, they will be replaced.
name
- namevalues
- valuespublic void setParameters(java.util.Map params)
addParameters(java.util.Map)
.params
- map of paramspublic void addParameter(java.lang.String name, java.lang.String value)
If there are already one or more values registered for the given parameter name, the given value will be added to the end of the list.
name
- namevalue
- valuepublic void addParameter(java.lang.String name, java.lang.String[] values)
If there are already one or more values registered for the given parameter name, the given values will be added to the end of the list.
name
- namevalues
- valuepublic void addParameters(java.util.Map<?,?> params)
setParameters(java.util.Map)
.params
- map of paramspublic void removeParameter(java.lang.String name)
name
- namepublic void removeAllParameters()
public java.lang.String getParameter(java.lang.String name)
getParameter
in interface javax.servlet.ServletRequest
public java.util.Enumeration<java.lang.String> getParameterNames()
getParameterNames
in interface javax.servlet.ServletRequest
public java.lang.String[] getParameterValues(java.lang.String name)
getParameterValues
in interface javax.servlet.ServletRequest
public java.util.Map<java.lang.String,java.lang.String[]> getParameterMap()
getParameterMap
in interface javax.servlet.ServletRequest
public void setProtocol(java.lang.String protocol)
public java.lang.String getProtocol()
getProtocol
in interface javax.servlet.ServletRequest
public void setScheme(java.lang.String scheme)
public java.lang.String getScheme()
getScheme
in interface javax.servlet.ServletRequest
public void setServerName(java.lang.String serverName)
public java.lang.String getServerName()
getServerName
in interface javax.servlet.ServletRequest
public void setServerPort(int serverPort)
public int getServerPort()
getServerPort
in interface javax.servlet.ServletRequest
public java.io.BufferedReader getReader() throws java.io.UnsupportedEncodingException
getReader
in interface javax.servlet.ServletRequest
java.io.UnsupportedEncodingException
public void setRemoteAddr(java.lang.String remoteAddr)
public java.lang.String getRemoteAddr()
getRemoteAddr
in interface javax.servlet.ServletRequest
public void setRemoteHost(java.lang.String remoteHost)
public java.lang.String getRemoteHost()
getRemoteHost
in interface javax.servlet.ServletRequest
public void setAttribute(java.lang.String name, java.lang.Object value)
setAttribute
in interface javax.servlet.ServletRequest
public void removeAttribute(java.lang.String name)
removeAttribute
in interface javax.servlet.ServletRequest
public void clearAttributes()
public void addPreferredLocale(java.util.Locale locale)
locale
- localesetPreferredLocales(java.util.List<java.util.Locale>)
public void setPreferredLocales(java.util.List<java.util.Locale> locales)
addPreferredLocale(java.util.Locale)
public java.util.Locale getLocale()
If no locales have been explicitly configured, the default,
preferred Locale
for the server mocked by this
request is Locale.ENGLISH
.
In contrast to the Servlet specification, this mock implementation
does not take into consideration any locales
specified via the Accept-Language
header.
getLocale
in interface javax.servlet.ServletRequest
ServletRequest.getLocale()
,
addPreferredLocale(Locale)
,
setPreferredLocales(List)
public java.util.Enumeration<java.util.Locale> getLocales()
If no locales have been explicitly configured, the default,
preferred Locale
for the server mocked by this
request is Locale.ENGLISH
.
In contrast to the Servlet specification, this mock implementation
does not take into consideration any locales
specified via the Accept-Language
header.
getLocales
in interface javax.servlet.ServletRequest
ServletRequest.getLocales()
,
addPreferredLocale(Locale)
,
setPreferredLocales(List)
public void setSecure(boolean secure)
secure
flag indicating whether the mock request
was made using a secure channel, such as HTTPS.isSecure()
,
getScheme()
,
setScheme(String)
public boolean isSecure()
isSecure
in interface javax.servlet.ServletRequest
ServletRequest.isSecure()
public javax.servlet.RequestDispatcher getRequestDispatcher(java.lang.String path)
getRequestDispatcher
in interface javax.servlet.ServletRequest
@Deprecated public java.lang.String getRealPath(java.lang.String path)
getRealPath
in interface javax.servlet.ServletRequest
public void setRemotePort(int remotePort)
public int getRemotePort()
getRemotePort
in interface javax.servlet.ServletRequest
public void setLocalName(java.lang.String localName)
public java.lang.String getLocalName()
getLocalName
in interface javax.servlet.ServletRequest
public void setLocalAddr(java.lang.String localAddr)
public java.lang.String getLocalAddr()
getLocalAddr
in interface javax.servlet.ServletRequest
public void setLocalPort(int localPort)
public int getLocalPort()
getLocalPort
in interface javax.servlet.ServletRequest
public javax.servlet.AsyncContext startAsync()
startAsync
in interface javax.servlet.ServletRequest
public javax.servlet.AsyncContext startAsync(javax.servlet.ServletRequest request, javax.servlet.ServletResponse response)
startAsync
in interface javax.servlet.ServletRequest
public void setAsyncStarted(boolean asyncStarted)
public boolean isAsyncStarted()
isAsyncStarted
in interface javax.servlet.ServletRequest
public void setAsyncSupported(boolean asyncSupported)
public boolean isAsyncSupported()
isAsyncSupported
in interface javax.servlet.ServletRequest
public void setAsyncContext(MockAsyncContext asyncContext)
public javax.servlet.AsyncContext getAsyncContext()
getAsyncContext
in interface javax.servlet.ServletRequest
public void setDispatcherType(javax.servlet.DispatcherType dispatcherType)
public javax.servlet.DispatcherType getDispatcherType()
getDispatcherType
in interface javax.servlet.ServletRequest
public void setAuthType(java.lang.String authType)
public java.lang.String getAuthType()
getAuthType
in interface javax.servlet.http.HttpServletRequest
public void setCookies(javax.servlet.http.Cookie... cookies)
public javax.servlet.http.Cookie[] getCookies()
getCookies
in interface javax.servlet.http.HttpServletRequest
public void addHeader(java.lang.String name, java.lang.Object value)
While this method can take any Object
as a parameter, it is recommended to use the following types:
toString()
; see getHeader(java.lang.String)
.getDateHeader(java.lang.String)
.getIntHeader(java.lang.String)
.String[]
or Collection<String>
for multiple values; see getHeaders(java.lang.String)
.name
- namevalue
- valuegetHeaderNames()
,
getHeaders(java.lang.String)
,
getHeader(java.lang.String)
,
getDateHeader(java.lang.String)
public long getDateHeader(java.lang.String name)
name
.
If the internal value representation is a String, this method will try to parse it as a date using the supported date formats:
getDateHeader
in interface javax.servlet.http.HttpServletRequest
name
- the header namepublic java.lang.String getHeader(java.lang.String name)
getHeader
in interface javax.servlet.http.HttpServletRequest
public java.util.Enumeration<java.lang.String> getHeaders(java.lang.String name)
getHeaders
in interface javax.servlet.http.HttpServletRequest
public java.util.Enumeration<java.lang.String> getHeaderNames()
getHeaderNames
in interface javax.servlet.http.HttpServletRequest
public int getIntHeader(java.lang.String name)
getIntHeader
in interface javax.servlet.http.HttpServletRequest
public void setMethod(java.lang.String method)
public java.lang.String getMethod()
getMethod
in interface javax.servlet.http.HttpServletRequest
public void setPathInfo(java.lang.String pathInfo)
public java.lang.String getPathInfo()
getPathInfo
in interface javax.servlet.http.HttpServletRequest
public java.lang.String getPathTranslated()
getPathTranslated
in interface javax.servlet.http.HttpServletRequest
public void setContextPath(java.lang.String contextPath)
public java.lang.String getContextPath()
getContextPath
in interface javax.servlet.http.HttpServletRequest
public void setQueryString(java.lang.String queryString)
public java.lang.String getQueryString()
getQueryString
in interface javax.servlet.http.HttpServletRequest
public void setRemoteUser(java.lang.String remoteUser)
public java.lang.String getRemoteUser()
getRemoteUser
in interface javax.servlet.http.HttpServletRequest
public void addUserRole(java.lang.String role)
public boolean isUserInRole(java.lang.String role)
isUserInRole
in interface javax.servlet.http.HttpServletRequest
public void setUserPrincipal(java.security.Principal userPrincipal)
public java.security.Principal getUserPrincipal()
getUserPrincipal
in interface javax.servlet.http.HttpServletRequest
public void setRequestedSessionId(java.lang.String requestedSessionId)
public java.lang.String getRequestedSessionId()
getRequestedSessionId
in interface javax.servlet.http.HttpServletRequest
public void setRequestURI(java.lang.String requestURI)
public java.lang.String getRequestURI()
getRequestURI
in interface javax.servlet.http.HttpServletRequest
public java.lang.StringBuffer getRequestURL()
getRequestURL
in interface javax.servlet.http.HttpServletRequest
public void setServletPath(java.lang.String servletPath)
public java.lang.String getServletPath()
getServletPath
in interface javax.servlet.http.HttpServletRequest
public void setSession(javax.servlet.http.HttpSession session)
public javax.servlet.http.HttpSession getSession(boolean create)
getSession
in interface javax.servlet.http.HttpServletRequest
public javax.servlet.http.HttpSession getSession()
getSession
in interface javax.servlet.http.HttpServletRequest
public java.lang.String changeSessionId()
MockHttpSession.changeSessionId()
if the session is a mock session.
Otherwise it simply returns the current session id.changeSessionId
in interface javax.servlet.http.HttpServletRequest
public void setRequestedSessionIdValid(boolean requestedSessionIdValid)
public boolean isRequestedSessionIdValid()
isRequestedSessionIdValid
in interface javax.servlet.http.HttpServletRequest
public void setRequestedSessionIdFromCookie(boolean requestedSessionIdFromCookie)
public boolean isRequestedSessionIdFromCookie()
isRequestedSessionIdFromCookie
in interface javax.servlet.http.HttpServletRequest
public void setRequestedSessionIdFromURL(boolean requestedSessionIdFromURL)
public boolean isRequestedSessionIdFromURL()
isRequestedSessionIdFromURL
in interface javax.servlet.http.HttpServletRequest
@Deprecated public boolean isRequestedSessionIdFromUrl()
isRequestedSessionIdFromUrl
in interface javax.servlet.http.HttpServletRequest
public boolean authenticate(javax.servlet.http.HttpServletResponse response) throws java.io.IOException, javax.servlet.ServletException
authenticate
in interface javax.servlet.http.HttpServletRequest
java.io.IOException
javax.servlet.ServletException
public void login(java.lang.String username, java.lang.String password) throws javax.servlet.ServletException
login
in interface javax.servlet.http.HttpServletRequest
javax.servlet.ServletException
public void logout() throws javax.servlet.ServletException
logout
in interface javax.servlet.http.HttpServletRequest
javax.servlet.ServletException
public void addPart(javax.servlet.http.Part part)
public javax.servlet.http.Part getPart(java.lang.String name) throws java.io.IOException, java.lang.IllegalStateException, javax.servlet.ServletException
getPart
in interface javax.servlet.http.HttpServletRequest
java.io.IOException
java.lang.IllegalStateException
javax.servlet.ServletException
public java.util.Collection<javax.servlet.http.Part> getParts() throws java.io.IOException, java.lang.IllegalStateException, javax.servlet.ServletException
getParts
in interface javax.servlet.http.HttpServletRequest
java.io.IOException
java.lang.IllegalStateException
javax.servlet.ServletException
public <T extends javax.servlet.http.HttpUpgradeHandler> T upgrade(java.lang.Class<T> arg0) throws java.io.IOException, javax.servlet.ServletException
upgrade
in interface javax.servlet.http.HttpServletRequest
java.io.IOException
javax.servlet.ServletException
Copyright © 2001-2018 Jalios SA. All Rights Reserved.