类 FacesWebRequest
- java.lang.Object
- org.springframework.web.context.request.FacesRequestAttributes
- org.springframework.web.context.request.FacesWebRequest
- 所有已实现的接口:
NativeWebRequest
,RequestAttributes
,WebRequest
public class FacesWebRequest extends FacesRequestAttributes implements NativeWebRequest
- 从以下版本开始:
- 2.5.2
- 作者:
- Juergen Hoeller
字段概要
从接口继承的字段 org.springframework.web.context.request.RequestAttributes
REFERENCE_REQUEST, REFERENCE_SESSION, SCOPE_GLOBAL_SESSION, SCOPE_REQUEST, SCOPE_SESSION
构造器概要
构造器 构造器 说明 FacesWebRequest(FacesContext facesContext)
Create a new FacesWebRequest adapter for the given FacesContext.
方法概要
所有方法 实例方法 具体方法 修饰符和类型 方法 说明 boolean
checkNotModified(long lastModifiedTimestamp)
Check whether the requested resource has been modified given the supplied last-modified timestamp (as determined by the application).boolean
checkNotModified(String eTag)
Check whether the requested resource has been modified given the suppliedETag
(entity tag), as determined by the application.boolean
checkNotModified(String etag, long lastModifiedTimestamp)
Last-modified handling not supported for portlet requests: As a consequence, this method always returnsfalse
.String
getContextPath()
Return the context path for this request (usually the base path that the current web application is mapped to).String
getDescription(boolean includeClientInfo)
Get a short description of this request, typically containing request URI and session id.String
getHeader(String headerName)
Return the request header of the given name, ornull
if 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, ornull
if none.Locale
getLocale()
Return the primary Locale for this request.Object
getNativeRequest()
Return the underlying native request object.<T> T
getNativeRequest(Class<T> requiredType)
Return the underlying native request object, if available.Object
getNativeResponse()
Return the underlying native response object, if any.<T> T
getNativeResponse(Class<T> requiredType)
Return the underlying native response object, if available.String
getParameter(String paramName)
Return the request parameter of the given name, ornull
if 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, ornull
if none.String
getRemoteUser()
Return the remote user for this request, if any.Principal
getUserPrincipal()
Return the user principal for this request, if any.boolean
isSecure()
Return whether this request has been sent over a secure transport mechanism (such as SSL).boolean
isUserInRole(String role)
Determine whether the user is in the given role for this request.String
toString()
从类继承的方法 org.springframework.web.context.request.FacesRequestAttributes
getAttribute, getAttributeMap, getAttributeNames, getExternalContext, getFacesContext, getSessionId, getSessionMutex, registerDestructionCallback, removeAttribute, resolveReference, setAttribute
从类继承的方法 java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait
从接口继承的方法 org.springframework.web.context.request.RequestAttributes
getAttribute, getAttributeNames, getSessionId, getSessionMutex, registerDestructionCallback, removeAttribute, resolveReference, setAttribute
构造器详细资料
FacesWebRequest
public FacesWebRequest(FacesContext facesContext)
Create a new FacesWebRequest adapter for the given FacesContext.- 参数:
facesContext
- the current FacesContext- 另请参阅:
FacesContext.getCurrentInstance()
方法详细资料
getNativeRequest
public Object getNativeRequest()
从接口复制的说明:NativeWebRequest
Return the underlying native request object.- 指定者:
getNativeRequest
在接口中NativeWebRequest
- 另请参阅:
HttpServletRequest
,ActionRequest
,RenderRequest
getNativeResponse
public Object getNativeResponse()
从接口复制的说明:NativeWebRequest
Return the underlying native response object, if any.
getNativeRequest
public <T> T getNativeRequest(Class<T> requiredType)
从接口复制的说明:NativeWebRequest
Return the underlying native request object, if available.- 指定者:
getNativeRequest
在接口中NativeWebRequest
- 参数:
requiredType
- the desired type of request object- 返回:
- the matching request object, or
null
if none of that type is available - 另请参阅:
HttpServletRequest
,ActionRequest
,RenderRequest
getNativeResponse
public <T> T getNativeResponse(Class<T> requiredType)
从接口复制的说明:NativeWebRequest
Return the underlying native response object, if available.- 指定者:
getNativeResponse
在接口中NativeWebRequest
- 参数:
requiredType
- the desired type of response object- 返回:
- the matching response object, or
null
if none of that type is available - 另请参阅:
HttpServletResponse
,ActionResponse
,RenderResponse
getHeader
public String getHeader(String headerName)
从接口复制的说明:WebRequest
Return the request header of the given name, ornull
if none.Retrieves the first header value in case of a multi-value header.
- 指定者:
getHeader
在接口中WebRequest
- 另请参阅:
HttpServletRequest.getHeader(String)
getHeaderValues
public String[] getHeaderValues(String headerName)
从接口复制的说明:WebRequest
Return the request header values for the given header name, ornull
if none.A single-value header will be exposed as an array with a single element.
getHeaderNames
public Iterator<String> getHeaderNames()
从接口复制的说明:WebRequest
Return a Iterator over request header names.- 指定者:
getHeaderNames
在接口中WebRequest
- 另请参阅:
HttpServletRequest.getHeaderNames()
getParameter
public String getParameter(String paramName)
从接口复制的说明:WebRequest
Return the request parameter of the given name, ornull
if none.Retrieves the first parameter value in case of a multi-value parameter.
- 指定者:
getParameter
在接口中WebRequest
- 另请参阅:
ServletRequest.getParameter(String)
getParameterNames
public Iterator<String> getParameterNames()
从接口复制的说明:WebRequest
Return a Iterator over request parameter names.
getParameterValues
public String[] getParameterValues(String paramName)
从接口复制的说明:WebRequest
Return the request parameter values for the given parameter name, ornull
if none.A single-value parameter will be exposed as an array with a single element.
getParameterMap
public Map<String,String[]> getParameterMap()
从接口复制的说明:WebRequest
Return 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.
- 指定者:
getParameterMap
在接口中WebRequest
- 另请参阅:
ServletRequest.getParameterMap()
getLocale
public Locale getLocale()
从接口复制的说明:WebRequest
Return the primary Locale for this request.- 指定者:
getLocale
在接口中WebRequest
- 另请参阅:
ServletRequest.getLocale()
getContextPath
public String getContextPath()
从接口复制的说明:WebRequest
Return the context path for this request (usually the base path that the current web application is mapped to).- 指定者:
getContextPath
在接口中WebRequest
- 另请参阅:
HttpServletRequest.getContextPath()
getRemoteUser
public String getRemoteUser()
从接口复制的说明:WebRequest
Return the remote user for this request, if any.- 指定者:
getRemoteUser
在接口中WebRequest
- 另请参阅:
HttpServletRequest.getRemoteUser()
getUserPrincipal
public Principal getUserPrincipal()
从接口复制的说明:WebRequest
Return the user principal for this request, if any.
isUserInRole
public boolean isUserInRole(String role)
从接口复制的说明:WebRequest
Determine whether the user is in the given role for this request.
isSecure
public boolean isSecure()
从接口复制的说明:WebRequest
Return whether this request has been sent over a secure transport mechanism (such as SSL).- 指定者:
isSecure
在接口中WebRequest
- 另请参阅:
ServletRequest.isSecure()
checkNotModified
public boolean checkNotModified(long lastModifiedTimestamp)
从接口复制的说明:WebRequest
Check whether the requested resource has been modified given the supplied last-modified timestamp (as determined by the application).This will also transparently set the "Last-Modified" response header and HTTP status when applicable.
Typical usage:
public String myHandleMethod(WebRequest request, Model model) { long lastModified = // application-specific calculation if (request.checkNotModified(lastModified)) { // shortcut exit - no further processing necessary return null; } // further request processing, actually building content model.addAttribute(...); return "myViewName"; }
This method works with conditional GET/HEAD requests, but also with conditional POST/PUT/DELETE requests.
Note: you can use either this
#checkNotModified(long)
method; orWebRequest.checkNotModified(String)
. If you want enforce both a strong entity tag and a Last-Modified value, as recommended by the HTTP specification, then you should useWebRequest.checkNotModified(String, long)
.If the "If-Modified-Since" header is set but cannot be parsed to a date value, this method will ignore the header and proceed with setting the last-modified timestamp on the response.
- 指定者:
checkNotModified
在接口中WebRequest
- 参数:
lastModifiedTimestamp
- the last-modified timestamp in milliseconds that the application determined for the underlying resource- 返回:
- 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)
从接口复制的说明:WebRequest
Check whether the requested resource has been modified given the suppliedETag
(entity tag), as determined by the application.This will also transparently set the "ETag" response header and HTTP status when applicable.
Typical usage:
public String myHandleMethod(WebRequest request, Model model) { String eTag = // application-specific calculation if (request.checkNotModified(eTag)) { // shortcut exit - no further processing necessary return null; } // further request processing, actually building content model.addAttribute(...); return "myViewName"; }
Note: you can use either this
#checkNotModified(String)
method; orWebRequest.checkNotModified(long)
. If you want enforce both a strong entity tag and a Last-Modified value, as recommended by the HTTP specification, then you should useWebRequest.checkNotModified(String, long)
.- 指定者:
checkNotModified
在接口中WebRequest
- 参数:
eTag
- the entity tag that the application determined for the underlying resource. This parameter will be padded with quotes (") if necessary.- 返回:
- 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
.- 指定者:
checkNotModified
在接口中WebRequest
- 参数:
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- 返回:
- true if the request does not require further processing.
- 从以下版本开始:
- 4.2
getDescription
public String getDescription(boolean includeClientInfo)
从接口复制的说明:WebRequest
Get a short description of this request, typically containing request URI and session id.- 指定者:
getDescription
在接口中WebRequest
- 参数:
includeClientInfo
- whether to include client-specific information such as session id and user name- 返回:
- the requested description as String