Class PortletWebRequest
- java.lang.Object
- org.springframework.web.context.request.AbstractRequestAttributes
- org.springframework.web.portlet.context.PortletRequestAttributes
- org.springframework.web.portlet.context.PortletWebRequest
- All Implemented Interfaces:
NativeWebRequest,RequestAttributes,WebRequest
public class PortletWebRequest extends PortletRequestAttributes implements NativeWebRequest
WebRequestadapter for aPortletRequest.- Since:
- 2.0
- Author:
- Juergen Hoeller
Field Summary
Fields inherited from class org.springframework.web.portlet.context.PortletRequestAttributes
DESTRUCTION_CALLBACK_NAME_PREFIX
Fields inherited from class org.springframework.web.context.request.AbstractRequestAttributes
requestDestructionCallbacks
Fields inherited from interface org.springframework.web.context.request.RequestAttributes
REFERENCE_REQUEST, REFERENCE_SESSION, SCOPE_GLOBAL_SESSION, SCOPE_REQUEST, SCOPE_SESSION
Constructor Summary
Constructors Constructor Description PortletWebRequest(PortletRequest request)Create a new PortletWebRequest instance for the given request.PortletWebRequest(PortletRequest request, PortletResponse response)Create a new PortletWebRequest instance for the given request/response pair.
Method Summary
All Methods Instance Methods Concrete Methods Modifier and Type Method Description booleancheckNotModified(long lastModifiedTimestamp)Last-modified handling not supported for portlet requests: As a consequence, this method always returnsfalse.booleancheckNotModified(String eTag)Last-modified handling not supported for portlet requests: As a consequence, this method always returnsfalse.booleancheckNotModified(String etag, long lastModifiedTimestamp)Last-modified handling not supported for portlet requests: As a consequence, this method always returnsfalse.StringgetContextPath()Return the context path for this request (usually the base path that the current web application is mapped to).StringgetDescription(boolean includeClientInfo)Get a short description of this request, typically containing request URI and session id.StringgetHeader(String headerName)Return the request header of the given name, ornullif none.Iterator<String>getHeaderNames()Return a Iterator over request header names.String[]getHeaderValues(String headerName)Return the request header values for the given header name, ornullif none.LocalegetLocale()Return the primary Locale for this request.ObjectgetNativeRequest()Return the underlying native request object.<T> TgetNativeRequest(Class<T> requiredType)Return the underlying native request object, if available.ObjectgetNativeResponse()Return the underlying native response object, if any.<T> TgetNativeResponse(Class<T> requiredType)Return the underlying native response object, if available.StringgetParameter(String paramName)Return the request parameter of the given name, ornullif none.Map<String,String[]>getParameterMap()Return a immutable Map of the request parameters, with parameter names as map keys and parameter values as map values.Iterator<String>getParameterNames()Return a Iterator over request parameter names.String[]getParameterValues(String paramName)Return the request parameter values for the given parameter name, ornullif none.StringgetRemoteUser()Return the remote user for this request, if any.PrincipalgetUserPrincipal()Return the user principal for this request, if any.booleanisSecure()Return whether this request has been sent over a secure transport mechanism (such as SSL).booleanisUserInRole(String role)Determine whether the user is in the given role for this request.StringtoString()Methods inherited from class org.springframework.web.portlet.context.PortletRequestAttributes
getAttribute, getAttributeNames, getRequest, getResponse, getSession, getSessionId, getSessionMutex, registerDestructionCallback, registerSessionDestructionCallback, removeAttribute, resolveReference, setAttribute, updateAccessedSessionAttributes
Methods inherited from class org.springframework.web.context.request.AbstractRequestAttributes
isRequestActive, registerRequestDestructionCallback, removeRequestDestructionCallback, requestCompleted
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait
Methods inherited from interface org.springframework.web.context.request.RequestAttributes
getAttribute, getAttributeNames, getSessionId, getSessionMutex, registerDestructionCallback, removeAttribute, resolveReference, setAttribute
Constructor Detail
PortletWebRequest
public PortletWebRequest(PortletRequest request)
Create a new PortletWebRequest instance for the given request.- Parameters:
request- current portlet request
PortletWebRequest
public PortletWebRequest(PortletRequest request, PortletResponse response)
Create a new PortletWebRequest instance for the given request/response pair.- Parameters:
request- current portlet requestresponse- current portlet response
Method Detail
getNativeRequest
public Object getNativeRequest()
Description copied from interface:NativeWebRequestReturn the underlying native request object.- Specified by:
getNativeRequestin interfaceNativeWebRequest- See Also:
HttpServletRequest,ActionRequest,RenderRequest
getNativeResponse
public Object getNativeResponse()
Description copied from interface:NativeWebRequestReturn the underlying native response object, if any.- Specified by:
getNativeResponsein interfaceNativeWebRequest- See Also:
HttpServletResponse,ActionResponse,RenderResponse
getNativeRequest
public <T> T getNativeRequest(Class<T> requiredType)
Description copied from interface:NativeWebRequestReturn the underlying native request object, if available.- Specified by:
getNativeRequestin interfaceNativeWebRequest- Parameters:
requiredType- the desired type of request object- Returns:
- the matching request object, or
nullif none of that type is available - See Also:
HttpServletRequest,ActionRequest,RenderRequest
getNativeResponse
public <T> T getNativeResponse(Class<T> requiredType)
Description copied from interface:NativeWebRequestReturn the underlying native response object, if available.- Specified by:
getNativeResponsein interfaceNativeWebRequest- Parameters:
requiredType- the desired type of response object- Returns:
- the matching response object, or
nullif none of that type is available - See Also:
HttpServletResponse,ActionResponse,RenderResponse
getHeader
public String getHeader(String headerName)
Description copied from interface:WebRequestReturn the request header of the given name, ornullif none.Retrieves the first header value in case of a multi-value header.
- Specified by:
getHeaderin interfaceWebRequest- See Also:
HttpServletRequest.getHeader(String)
getHeaderValues
public String[] getHeaderValues(String headerName)
Description copied from interface:WebRequestReturn the request header values for the given header name, ornullif none.A single-value header will be exposed as an array with a single element.
- Specified by:
getHeaderValuesin interfaceWebRequest- See Also:
HttpServletRequest.getHeaders(String)
getHeaderNames
public Iterator<String> getHeaderNames()
Description copied from interface:WebRequestReturn a Iterator over request header names.- Specified by:
getHeaderNamesin interfaceWebRequest- See Also:
HttpServletRequest.getHeaderNames()
getParameter
public String getParameter(String paramName)
Description copied from interface:WebRequestReturn the request parameter of the given name, ornullif none.Retrieves the first parameter value in case of a multi-value parameter.
- Specified by:
getParameterin interfaceWebRequest- See Also:
ServletRequest.getParameter(String)
getParameterValues
public String[] getParameterValues(String paramName)
Description copied from interface:WebRequestReturn the request parameter values for the given parameter name, ornullif none.A single-value parameter will be exposed as an array with a single element.
- Specified by:
getParameterValuesin interfaceWebRequest- See Also:
ServletRequest.getParameterValues(String)
getParameterNames
public Iterator<String> getParameterNames()
Description copied from interface:WebRequestReturn a Iterator over request parameter names.- Specified by:
getParameterNamesin interfaceWebRequest- See Also:
ServletRequest.getParameterNames()
getParameterMap
public Map<String,String[]> getParameterMap()
Description copied from interface:WebRequestReturn a immutable Map of the request parameters, with parameter names as map keys and parameter values as map values. The map values will be of type String array.A single-value parameter will be exposed as an array with a single element.
- Specified by:
getParameterMapin interfaceWebRequest- See Also:
ServletRequest.getParameterMap()
getLocale
public Locale getLocale()
Description copied from interface:WebRequestReturn the primary Locale for this request.- Specified by:
getLocalein interfaceWebRequest- See Also:
ServletRequest.getLocale()
getContextPath
public String getContextPath()
Description copied from interface:WebRequestReturn the context path for this request (usually the base path that the current web application is mapped to).- Specified by:
getContextPathin interfaceWebRequest- See Also:
HttpServletRequest.getContextPath()
getRemoteUser
public String getRemoteUser()
Description copied from interface:WebRequestReturn the remote user for this request, if any.- Specified by:
getRemoteUserin interfaceWebRequest- See Also:
HttpServletRequest.getRemoteUser()
getUserPrincipal
public Principal getUserPrincipal()
Description copied from interface:WebRequestReturn the user principal for this request, if any.- Specified by:
getUserPrincipalin interfaceWebRequest- See Also:
HttpServletRequest.getUserPrincipal()
isUserInRole
public boolean isUserInRole(String role)
Description copied from interface:WebRequestDetermine whether the user is in the given role for this request.- Specified by:
isUserInRolein interfaceWebRequest- See Also:
HttpServletRequest.isUserInRole(String)
isSecure
public boolean isSecure()
Description copied from interface:WebRequestReturn whether this request has been sent over a secure transport mechanism (such as SSL).- Specified by:
isSecurein interfaceWebRequest- See Also:
ServletRequest.isSecure()
checkNotModified
public boolean checkNotModified(long lastModifiedTimestamp)
Last-modified handling not supported for portlet requests: As a consequence, this method always returnsfalse.- Specified by:
checkNotModifiedin interfaceWebRequest- Parameters:
lastModifiedTimestamp- the last-modified timestamp in milliseconds that the application determined for the underlying resource- Returns:
- whether the request qualifies as not modified, allowing to abort request processing and relying on the response telling the client that the content has not been modified
checkNotModified
public boolean checkNotModified(String eTag)
Last-modified handling not supported for portlet requests: As a consequence, this method always returnsfalse.- Specified by:
checkNotModifiedin interfaceWebRequest- Parameters:
eTag- the entity tag that the application determined for the underlying resource. This parameter will be padded with quotes (") if necessary.- Returns:
- true if the request does not require further processing.
checkNotModified
public boolean checkNotModified(String etag, long lastModifiedTimestamp)
Last-modified handling not supported for portlet requests: As a consequence, this method always returnsfalse.- Specified by:
checkNotModifiedin interfaceWebRequest- Parameters:
etag- the entity tag that the application determined for the underlying resource. This parameter will be padded with quotes (") if necessary.lastModifiedTimestamp- the last-modified timestamp in milliseconds that the application determined for the underlying resource- Returns:
- true if the request does not require further processing.
- Since:
- 4.2
getDescription
public String getDescription(boolean includeClientInfo)
Description copied from interface:WebRequestGet a short description of this request, typically containing request URI and session id.- Specified by:
getDescriptionin interfaceWebRequest- Parameters:
includeClientInfo- whether to include client-specific information such as session id and user name- Returns:
- the requested description as String
toString
public String toString()
- Overrides:
toStringin classPortletRequestAttributes