javax.servlet
类 ServletRequestWrapper

java.lang.Object
  javax.servlet.ServletRequestWrapper

所有已实现的接口：

ServletRequest

直接已知子类：

HttpServletRequestWrapper, ServletRequestHttpWrapper

public class ServletRequestWrapper
extends Object
implements ServletRequest

Provides a convenient implementation of the ServletRequest interface that can be subclassed by developers wishing to adapt the request to a Servlet. This class implements the Wrapper or Decorator pattern. Methods default to calling through to the wrapped request object.

从以下版本开始：

Servlet 2.3

另请参见：

ServletRequest

构造方法摘要

ServletRequestWrapper(ServletRequest request)
Creates a ServletRequest adaptor wrapping the given request object.

方法摘要

AsyncContext	getAsyncContext() Gets the AsyncContext that was created or reinitialized by the most recent invocation of startAsync() or startAsync(ServletRequest,ServletResponse) on the wrapped request.
Object	getAttribute(String name) The default behavior of this method is to call getAttribute(String name) on the wrapped request object.
Enumeration<String>	getAttributeNames() The default behavior of this method is to return getAttributeNames() on the wrapped request object.
String	getCharacterEncoding() The default behavior of this method is to return getCharacterEncoding() on the wrapped request object.
int	getContentLength() The default behavior of this method is to return getContentLength() on the wrapped request object.
String	getContentType() The default behavior of this method is to return getContentType() on the wrapped request object.
DispatcherType	getDispatcherType() Gets the dispatcher type of the wrapped request.
ServletInputStream	getInputStream() The default behavior of this method is to return getInputStream() on the wrapped request object.
String	getLocalAddr() The default behavior of this method is to return getLocalAddr() on the wrapped request object.
Locale	getLocale() The default behavior of this method is to return getLocale() on the wrapped request object.
Enumeration<Locale>	getLocales() The default behavior of this method is to return getLocales() on the wrapped request object.
String	getLocalName() The default behavior of this method is to return getLocalName() on the wrapped request object.
int	getLocalPort() The default behavior of this method is to return getLocalPort() on the wrapped request object.
String	getParameter(String name) The default behavior of this method is to return getParameter(String name) on the wrapped request object.
Map<String,String[]>	getParameterMap() The default behavior of this method is to return getParameterMap() on the wrapped request object.
Enumeration<String>	getParameterNames() The default behavior of this method is to return getParameterNames() on the wrapped request object.
String[]	getParameterValues(String name) The default behavior of this method is to return getParameterValues(String name) on the wrapped request object.
String	getProtocol() The default behavior of this method is to return getProtocol() on the wrapped request object.
BufferedReader	getReader() The default behavior of this method is to return getReader() on the wrapped request object.
String	getRealPath(String path) 已过时。 As of Version 2.1 of the Java Servlet API, use ServletContext.getRealPath(java.lang.String) instead
String	getRemoteAddr() The default behavior of this method is to return getRemoteAddr() on the wrapped request object.
String	getRemoteHost() The default behavior of this method is to return getRemoteHost() on the wrapped request object.
int	getRemotePort() The default behavior of this method is to return getRemotePort() on the wrapped request object.
ServletRequest	getRequest() Return the wrapped request object.
RequestDispatcher	getRequestDispatcher(String path) The default behavior of this method is to return getRequestDispatcher(String path) on the wrapped request object.
String	getScheme() The default behavior of this method is to return getScheme() on the wrapped request object.
String	getServerName() The default behavior of this method is to return getServerName() on the wrapped request object.
int	getServerPort() The default behavior of this method is to return getServerPort() on the wrapped request object.
ServletContext	getServletContext() Gets the servlet context to which the wrapped servlet request was last dispatched.
boolean	isAsyncStarted() Checks if the wrapped request has been put into asynchronous mode.
boolean	isAsyncSupported() Checks if the wrapped request supports asynchronous operation.
boolean	isSecure() The default behavior of this method is to return isSecure() on the wrapped request object.
boolean	isWrapperFor(Class wrappedType) Checks (recursively) if this ServletRequestWrapper wraps a ServletRequest of the given class type.
boolean	isWrapperFor(ServletRequest wrapped) Checks (recursively) if this ServletRequestWrapper wraps the given ServletRequest instance.
void	removeAttribute(String name) The default behavior of this method is to call removeAttribute(String name) on the wrapped request object.
void	setAttribute(String name, Object o) The default behavior of this method is to return setAttribute(String name, Object o) on the wrapped request object.
void	setCharacterEncoding(String enc) The default behavior of this method is to set the character encoding on the wrapped request object.
void	setRequest(ServletRequest request) Sets the request object being wrapped.
AsyncContext	startAsync() The default behavior of this method is to invoke ServletRequest.startAsync() on the wrapped request object.
AsyncContext	startAsync(ServletRequest servletRequest, ServletResponse servletResponse) The default behavior of this method is to invoke ServletRequest.startAsync(ServletRequest, ServletResponse) on the wrapped request object.

从类 java.lang.Object 继承的方法

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

构造方法详细信息

ServletRequestWrapper

public ServletRequestWrapper(ServletRequest request)

Creates a ServletRequest adaptor wrapping the given request object.

抛出：

IllegalArgumentException - if the request is null

方法详细信息

getRequest

public ServletRequest getRequest()

Return the wrapped request object.

setRequest

public void setRequest(ServletRequest request)

Sets the request object being wrapped.

抛出：

IllegalArgumentException - if the request is null.

getAttribute

public Object getAttribute(String name)

The default behavior of this method is to call getAttribute(String name) on the wrapped request object.

指定者：

接口 ServletRequest 中的 getAttribute

参数：

name - a String specifying the name of the attribute

返回：

an Object containing the value of the attribute, or null if the attribute does not exist

getAttributeNames

public Enumeration<String> getAttributeNames()

The default behavior of this method is to return getAttributeNames() on the wrapped request object.

指定者：

接口 ServletRequest 中的 getAttributeNames

返回：

an Enumeration of strings containing the names of the request's attributes

getCharacterEncoding

public String getCharacterEncoding()

The default behavior of this method is to return getCharacterEncoding() on the wrapped request object.

指定者：

接口 ServletRequest 中的 getCharacterEncoding

返回：

a String containing the name of the character encoding, or null if the request does not specify a character encoding

setCharacterEncoding

public void setCharacterEncoding(String enc)
                          throws UnsupportedEncodingException

The default behavior of this method is to set the character encoding on the wrapped request object.

指定者：

接口 ServletRequest 中的 setCharacterEncoding

参数：

enc - String containing the name of the character encoding.

抛出：

UnsupportedEncodingException - if this ServletRequest is still in a state where a character encoding may be set, but the specified encoding is invalid

getContentLength

public int getContentLength()

The default behavior of this method is to return getContentLength() on the wrapped request object.

指定者：

接口 ServletRequest 中的 getContentLength

返回：

an integer containing the length of the request body or -1 if the length is not known

getContentType

public String getContentType()

The default behavior of this method is to return getContentType() on the wrapped request object.

指定者：

接口 ServletRequest 中的 getContentType

返回：

a String containing the name of the MIME type of the request, or null if the type is not known

getInputStream

public ServletInputStream getInputStream()
                                  throws IOException

The default behavior of this method is to return getInputStream() on the wrapped request object.

指定者：

接口 ServletRequest 中的 getInputStream

返回：

a ServletInputStream object containing the body of the request

抛出：

IOException - if an input or output exception occurred

getParameter

public String getParameter(String name)

The default behavior of this method is to return getParameter(String name) on the wrapped request object.

指定者：

接口 ServletRequest 中的 getParameter

参数：

name - a String specifying the name of the parameter

返回：

a String representing the single value of the parameter

另请参见：

ServletRequest.getParameterValues(java.lang.String)

getParameterMap

public Map<String,String[]> getParameterMap()

The default behavior of this method is to return getParameterMap() on the wrapped request object.

指定者：

接口 ServletRequest 中的 getParameterMap

返回：

an immutable java.util.Map containing parameter names as keys and parameter values as map values. The keys in the parameter map are of type String. The values in the parameter map are of type String array.

getParameterNames

public Enumeration<String> getParameterNames()

The default behavior of this method is to return getParameterNames() on the wrapped request object.

指定者：

接口 ServletRequest 中的 getParameterNames

返回：

an Enumeration of String objects, each String containing the name of a request parameter; or an empty Enumeration if the request has no parameters

getParameterValues

public String[] getParameterValues(String name)

The default behavior of this method is to return getParameterValues(String name) on the wrapped request object.

指定者：

接口 ServletRequest 中的 getParameterValues

参数：

name - a String containing the name of the parameter whose value is requested

返回：

an array of String objects containing the parameter's values

另请参见：

ServletRequest.getParameter(java.lang.String)

getProtocol

public String getProtocol()

The default behavior of this method is to return getProtocol() on the wrapped request object.

指定者：

接口 ServletRequest 中的 getProtocol

返回：

a String containing the protocol name and version number

getScheme

public String getScheme()

The default behavior of this method is to return getScheme() on the wrapped request object.

指定者：

接口 ServletRequest 中的 getScheme

返回：

a String containing the name of the scheme used to make this request

getServerName

public String getServerName()

The default behavior of this method is to return getServerName() on the wrapped request object.

指定者：

接口 ServletRequest 中的 getServerName

返回：

a String containing the name of the server

getServerPort

public int getServerPort()

The default behavior of this method is to return getServerPort() on the wrapped request object.

指定者：

接口 ServletRequest 中的 getServerPort

返回：

an integer specifying the port number

getReader

public BufferedReader getReader()
                         throws IOException

The default behavior of this method is to return getReader() on the wrapped request object.

指定者：

接口 ServletRequest 中的 getReader

返回：

a BufferedReader containing the body of the request

抛出：

UnsupportedEncodingException - if the character set encoding used is not supported and the text cannot be decoded

IOException - if an input or output exception occurred

另请参见：

ServletRequest.getInputStream()

getRemoteAddr

public String getRemoteAddr()

The default behavior of this method is to return getRemoteAddr() on the wrapped request object.

指定者：

接口 ServletRequest 中的 getRemoteAddr

返回：

a String containing the IP address of the client that sent the request

getRemoteHost

public String getRemoteHost()

The default behavior of this method is to return getRemoteHost() on the wrapped request object.

指定者：

接口 ServletRequest 中的 getRemoteHost

返回：

a String containing the fully qualified name of the client

setAttribute

public void setAttribute(String name,
                         Object o)

The default behavior of this method is to return setAttribute(String name, Object o) on the wrapped request object.

指定者：

接口 ServletRequest 中的 setAttribute

参数：

name - a String specifying the name of the attribute

o - the Object to be stored

removeAttribute

public void removeAttribute(String name)

The default behavior of this method is to call removeAttribute(String name) on the wrapped request object.

指定者：

接口 ServletRequest 中的 removeAttribute

参数：

name - a String specifying the name of the attribute to remove

getLocale

public Locale getLocale()

The default behavior of this method is to return getLocale() on the wrapped request object.

指定者：

接口 ServletRequest 中的 getLocale

返回：

the preferred Locale for the client

getLocales

public Enumeration<Locale> getLocales()

The default behavior of this method is to return getLocales() on the wrapped request object.

指定者：

接口 ServletRequest 中的 getLocales

返回：

an Enumeration of preferred Locale objects for the client

isSecure

public boolean isSecure()

The default behavior of this method is to return isSecure() on the wrapped request object.

指定者：

接口 ServletRequest 中的 isSecure

返回：

a boolean indicating if the request was made using a secure channel

getRequestDispatcher

public RequestDispatcher getRequestDispatcher(String path)

The default behavior of this method is to return getRequestDispatcher(String path) on the wrapped request object.

指定者：

接口 ServletRequest 中的 getRequestDispatcher

参数：

path - a String specifying the pathname to the resource. If it is relative, it must be relative against the current servlet.

返回：

a RequestDispatcher object that acts as a wrapper for the resource at the specified path, or null if the servlet container cannot return a RequestDispatcher

另请参见：

RequestDispatcher, ServletContext.getRequestDispatcher(java.lang.String)

getRealPath

public String getRealPath(String path)

已过时。 As of Version 2.1 of the Java Servlet API, use ServletContext.getRealPath(java.lang.String) instead

The default behavior of this method is to return getRealPath(String path) on the wrapped request object.

指定者：

接口 ServletRequest 中的 getRealPath

getRemotePort

public int getRemotePort()

The default behavior of this method is to return getRemotePort() on the wrapped request object.

指定者：

接口 ServletRequest 中的 getRemotePort

返回：

an integer specifying the port number

从以下版本开始：

Servlet 2.4

getLocalName

public String getLocalName()

The default behavior of this method is to return getLocalName() on the wrapped request object.

指定者：

接口 ServletRequest 中的 getLocalName

返回：

a String containing the host name of the IP on which the request was received.

从以下版本开始：

Servlet 2.4

getLocalAddr

public String getLocalAddr()

The default behavior of this method is to return getLocalAddr() on the wrapped request object.

指定者：

接口 ServletRequest 中的 getLocalAddr

返回：

a String containing the IP address on which the request was received.

从以下版本开始：

Servlet 2.4

getLocalPort

public int getLocalPort()

The default behavior of this method is to return getLocalPort() on the wrapped request object.

指定者：

接口 ServletRequest 中的 getLocalPort

返回：

an integer specifying the port number

从以下版本开始：

Servlet 2.4

getServletContext

public ServletContext getServletContext()

Gets the servlet context to which the wrapped servlet request was last dispatched.

指定者：

接口 ServletRequest 中的 getServletContext

返回：

the servlet context to which the wrapped servlet request was last dispatched

从以下版本开始：

Servlet 3.0

startAsync

public AsyncContext startAsync()
                        throws IllegalStateException

The default behavior of this method is to invoke ServletRequest.startAsync() on the wrapped request object.

指定者：

接口 ServletRequest 中的 startAsync

返回：

the (re)initialized AsyncContext

抛出：

IllegalStateException - if the request is within the scope of a filter or servlet that does not support asynchronous operations (that is, isAsyncSupported() returns false), or if this method is called again without any asynchronous dispatch (resulting from one of the AsyncContext.dispatch() methods), is called outside the scope of any such dispatch, or is called again within the scope of the same dispatch, or if the response has already been closed

从以下版本开始：

Servlet 3.0

另请参见：

ServletRequest.startAsync()

startAsync

public AsyncContext startAsync(ServletRequest servletRequest,
                               ServletResponse servletResponse)
                        throws IllegalStateException

The default behavior of this method is to invoke ServletRequest.startAsync(ServletRequest, ServletResponse) on the wrapped request object.

指定者：

接口 ServletRequest 中的 startAsync

参数：

servletRequest - the ServletRequest used to initialize the AsyncContext

servletResponse - the ServletResponse used to initialize the AsyncContext

返回：

the (re)initialized AsyncContext

抛出：

IllegalStateException - if the request is within the scope of a filter or servlet that does not support asynchronous operations (that is, isAsyncSupported() returns false), or if this method is called again without any asynchronous dispatch (resulting from one of the AsyncContext.dispatch() methods), is called outside the scope of any such dispatch, or is called again within the scope of the same dispatch, or if the response has already been closed

从以下版本开始：

Servlet 3.0

另请参见：

ServletRequest.startAsync(ServletRequest, ServletResponse)

isAsyncStarted

public boolean isAsyncStarted()

Checks if the wrapped request has been put into asynchronous mode.

指定者：

接口 ServletRequest 中的 isAsyncStarted

返回：

true if this request has been put into asynchronous mode, false otherwise

从以下版本开始：

Servlet 3.0

另请参见：

ServletRequest.isAsyncStarted()

isAsyncSupported

public boolean isAsyncSupported()

Checks if the wrapped request supports asynchronous operation.

指定者：

接口 ServletRequest 中的 isAsyncSupported

返回：

true if this request supports asynchronous operation, false otherwise

从以下版本开始：

Servlet 3.0

另请参见：

ServletRequest.isAsyncSupported()

getAsyncContext

public AsyncContext getAsyncContext()

Gets the AsyncContext that was created or reinitialized by the most recent invocation of startAsync() or startAsync(ServletRequest,ServletResponse) on the wrapped request.

指定者：

接口 ServletRequest 中的 getAsyncContext

返回：

the AsyncContext that was created or reinitialized by the most recent invocation of startAsync() or startAsync(ServletRequest,ServletResponse) on the wrapped request

抛出：

IllegalStateException - if this request has not been put into asynchronous mode, i.e., if neither startAsync() nor startAsync(ServletRequest,ServletResponse) has been called

从以下版本开始：

Servlet 3.0

另请参见：

ServletRequest.getAsyncContext()

isWrapperFor

public boolean isWrapperFor(ServletRequest wrapped)

Checks (recursively) if this ServletRequestWrapper wraps the given ServletRequest instance.

参数：

wrapped - the ServletRequest instance to search for

返回：

true if this ServletRequestWrapper wraps the given ServletRequest instance, false otherwise

从以下版本开始：

Servlet 3.0

isWrapperFor

public boolean isWrapperFor(Class wrappedType)

Checks (recursively) if this ServletRequestWrapper wraps a ServletRequest of the given class type.

参数：

wrappedType - the ServletRequest class type to search for

返回：

true if this ServletRequestWrapper wraps a ServletRequest of the given class type, false otherwise

抛出：

IllegalArgumentException - if the given class does not implement ServletRequest

从以下版本开始：

Servlet 3.0

getDispatcherType

public DispatcherType getDispatcherType()

Gets the dispatcher type of the wrapped request.

指定者：

接口 ServletRequest 中的 getDispatcherType

返回：

the dispatcher type of the wrapped request

从以下版本开始：

Servlet 3.0

另请参见：

ServletRequest.getDispatcherType()