javax.servlet
Class ServletRequestWrapper
java.lang.Object
|
+--javax.servlet.ServletRequestWrapper
- Direct Known Subclasses:
- HttpServletRequestWrapper
- public class ServletRequestWrapper
- extends java.lang.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.
- Since:
- v 2.3
- See Also:
ServletRequest
Constructor Summary
Method Summary
java.lang.Object
getAttribute(java.lang.String name)
The default behavior of this method is to call getAttribute(String name)
on the wrapped request object.
java.util.Enumeration
getAttributeNames()
The default behavior of this method is to return getAttributeNames()
on the wrapped request object.
java.lang.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.
java.lang.String
getContentType()
The default behavior of this method is to return getContentType()
on the wrapped request object.
java.lang.String
getLocalAddr()
The default behavior of this method is to return
getLocalAddr() on the wrapped request object.
java.util.Locale
getLocale()
The default behavior of this method is to return getLocale()
on the wrapped request object.
java.util.Enumeration
getLocales()
The default behavior of this method is to return getLocales()
on the wrapped request object.
java.lang.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.
java.lang.String
getParameter(java.lang.String name)
The default behavior of this method is to return getParameter(String name)
on the wrapped request object.
java.util.Map
getParameterMap()
The default behavior of this method is to return getParameterMap()
on the wrapped request object.
java.util.Enumeration
getParameterNames()
The default behavior of this method is to return getParameterNames()
on the wrapped request object.
java.lang.String[]
getParameterValues(java.lang.String name)
The default behavior of this method is to return getParameterValues(String name)
on the wrapped request object.
java.lang.String
getProtocol()
The default behavior of this method is to return getProtocol()
on the wrapped request object.
java.io.BufferedReader
getReader()
The default behavior of this method is to return getReader()
on the wrapped request object.
java.lang.String
getRealPath(java.lang.String path)
The default behavior of this method is to return getRealPath(String path)
on the wrapped request object.
java.lang.String
getRemoteAddr()
The default behavior of this method is to return getRemoteAddr()
on the wrapped request object.
java.lang.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.
java.lang.String
getScheme()
The default behavior of this method is to return getScheme()
on the wrapped request object.
java.lang.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.
boolean
isSecure()
The default behavior of this method is to return isSecure()
on the wrapped request object.
void
removeAttribute(java.lang.String name)
The default behavior of this method is to call removeAttribute(String name)
on the wrapped request object.
void
setAttribute(java.lang.String name,
java.lang.Object o)
The default behavior of this method is to return setAttribute(String name, Object o)
on the wrapped request object.
void
setCharacterEncoding(java.lang.String enc)
The default behavior of this method is to set the character encoding
on the wrapped request object.
Methods inherited from class java.lang.Object
clone,
equals,
finalize,
getClass,
hashCode,
notify,
notifyAll,
toString,
wait,
wait,
wait
Constructor Detail
ServletRequestWrapper
public ServletRequestWrapper(ServletRequest request)
- Creates a ServletRequest adaptor wrapping the given request object.
- Throws:
- java.lang.IllegalArgumentException - if the request is null
Method Detail
getRequest
public ServletRequest getRequest()
- Return the wrapped request object.
-
setRequest
public void setRequest(ServletRequest request)
- Sets the request object being wrapped.
-
- Throws:
- java.lang.IllegalArgumentException - if the request is null.
getAttribute
public java.lang.Object getAttribute(java.lang.String name)
- The default behavior of this method is to call getAttribute(String name)
on the wrapped request object.
- Specified by:
- getAttribute in interface ServletRequest
- Tags copied from interface: ServletRequest
- Parameters:
name
- a String
specifying the name of
the attribute- Returns:
- an
Object
containing the value
of the attribute, or null
if
the attribute does not exist
getAttributeNames
public java.util.Enumeration getAttributeNames()
- The default behavior of this method is to return getAttributeNames()
on the wrapped request object.
- Specified by:
- getAttributeNames in interface ServletRequest
- Tags copied from interface: ServletRequest
- Returns:
- an
Enumeration
of strings
containing the names
of the request's attributes
getCharacterEncoding
public java.lang.String getCharacterEncoding()
- The default behavior of this method is to return getCharacterEncoding()
on the wrapped request object.
- Specified by:
- getCharacterEncoding in interface ServletRequest
- Tags copied from interface: ServletRequest
- Returns:
- a
String
containing the name of
the character encoding, or null
if the request does not specify a character encoding
setCharacterEncoding
public void setCharacterEncoding(java.lang.String enc)
throws java.io.UnsupportedEncodingException
- The default behavior of this method is to set the character encoding
on the wrapped request object.
- Specified by:
- setCharacterEncoding in interface ServletRequest
- Tags copied from interface: ServletRequest
- Parameters:
env
- a String
containing the name of
the character encoding.- Throws:
- java.io.UnsupportedEncodingException - if this is not a valid encoding
getContentLength
public int getContentLength()
- The default behavior of this method is to return getContentLength()
on the wrapped request object.
- Specified by:
- getContentLength in interface ServletRequest
- Tags copied from interface: ServletRequest
- Returns:
- an integer containing the length of the
request body or -1 if the length is not known
getContentType
public java.lang.String getContentType()
- The default behavior of this method is to return getContentType()
on the wrapped request object.
- Specified by:
- getContentType in interface ServletRequest
- Tags copied from interface: ServletRequest
- Returns:
- 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 java.io.IOException
- The default behavior of this method is to return getInputStream()
on the wrapped request object.
- Specified by:
- getInputStream in interface ServletRequest
- Tags copied from interface: ServletRequest
- Returns:
- a
ServletInputStream
object containing
the body of the request - Throws:
- IllegalStateException - if the
ServletRequest.getReader()
method
has already been called for this request- java.io.IOException - if an input or output exception occurred
getLocalAddr
public java.lang.String getLocalAddr()
- The default behavior of this method is to return
getLocalAddr() on the wrapped request object.
- Specified by:
- getLocalAddr in interface ServletRequest
- Since:
- 2.4
getLocalName
public java.lang.String getLocalName()
- The default behavior of this method is to return
getLocalName() on the wrapped request object.
- Specified by:
- getLocalName in interface ServletRequest
- Since:
- 2.4
getLocalPort
public int getLocalPort()
- The default behavior of this method is to return
getLocalPort() on the wrapped request object.
- Specified by:
- getLocalPort in interface ServletRequest
- Since:
- 2.4
getParameter
public java.lang.String getParameter(java.lang.String name)
- The default behavior of this method is to return getParameter(String name)
on the wrapped request object.
- Specified by:
- getParameter in interface ServletRequest
- Tags copied from interface: ServletRequest
- Parameters:
name
- a String
specifying the
name of the parameter- Returns:
- a
String
representing the
single value of the parameter - See Also:
ServletRequest.getParameterValues(java.lang.String)
getParameterMap
public java.util.Map getParameterMap()
- The default behavior of this method is to return getParameterMap()
on the wrapped request object.
- Specified by:
- getParameterMap in interface ServletRequest
- Tags copied from interface: ServletRequest
- Returns:
- 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 java.util.Enumeration getParameterNames()
- The default behavior of this method is to return getParameterNames()
on the wrapped request object.
- Specified by:
- getParameterNames in interface ServletRequest
- Tags copied from interface: ServletRequest
- Returns:
- 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 java.lang.String[] getParameterValues(java.lang.String name)
- The default behavior of this method is to return getParameterValues(String name)
on the wrapped request object.
- Specified by:
- getParameterValues in interface ServletRequest
- Tags copied from interface: ServletRequest
- Parameters:
name
- a String
containing the name of
the parameter whose value is requested- Returns:
- an array of
String
objects
containing the parameter's values - See Also:
ServletRequest.getParameter(java.lang.String)
getProtocol
public java.lang.String getProtocol()
- The default behavior of this method is to return getProtocol()
on the wrapped request object.
- Specified by:
- getProtocol in interface ServletRequest
- Tags copied from interface: ServletRequest
- Returns:
- a
String
containing the protocol
name and version number
getScheme
public java.lang.String getScheme()
- The default behavior of this method is to return getScheme()
on the wrapped request object.
- Specified by:
- getScheme in interface ServletRequest
- Tags copied from interface: ServletRequest
- Returns:
- a
String
containing the name
of the scheme used to make this request
getServerName
public java.lang.String getServerName()
- The default behavior of this method is to return getServerName()
on the wrapped request object.
- Specified by:
- getServerName in interface ServletRequest
- Tags copied from interface: ServletRequest
- Returns:
- 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.
- Specified by:
- getServerPort in interface ServletRequest
- Tags copied from interface: ServletRequest
- Returns:
- an integer specifying the port number
getReader
public java.io.BufferedReader getReader()
throws java.io.IOException
- The default behavior of this method is to return getReader()
on the wrapped request object.
- Specified by:
- getReader in interface ServletRequest
- Tags copied from interface: ServletRequest
- Returns:
- a
BufferedReader
containing the body of the request - Throws:
- java.io.UnsupportedEncodingException - if the character set encoding
used is not supported and the
text cannot be decoded
- IllegalStateException - if
ServletRequest.getInputStream()
method
has been called on this request- java.io.IOException - if an input or output exception occurred
- See Also:
ServletRequest.getInputStream()
getRemoteAddr
public java.lang.String getRemoteAddr()
- The default behavior of this method is to return getRemoteAddr()
on the wrapped request object.
- Specified by:
- getRemoteAddr in interface ServletRequest
- Tags copied from interface: ServletRequest
- Returns:
- a
String
containing the
IP address of the client that sent the request
getRemoteHost
public java.lang.String getRemoteHost()
- The default behavior of this method is to return getRemoteHost()
on the wrapped request object.
- Specified by:
- getRemoteHost in interface ServletRequest
- Tags copied from interface: ServletRequest
- Returns:
- a
String
containing the fully
qualified name of the client
getRemotePort
public int getRemotePort()
- The default behavior of this method is to return
getRemotePort() on the wrapped request object.
- Specified by:
- getRemotePort in interface ServletRequest
- Since:
- 2.4
setAttribute
public void setAttribute(java.lang.String name,
java.lang.Object o)
- The default behavior of this method is to return setAttribute(String name, Object o)
on the wrapped request object.
- Specified by:
- setAttribute in interface ServletRequest
- Tags copied from interface: ServletRequest
- Parameters:
name
- a String
specifying
the name of the attributeo
- the Object
to be stored
removeAttribute
public void removeAttribute(java.lang.String name)
- The default behavior of this method is to call removeAttribute(String name)
on the wrapped request object.
- Specified by:
- removeAttribute in interface ServletRequest
- Tags copied from interface: ServletRequest
- Parameters:
name
- a String
specifying
the name of the attribute to remove
getLocale
public java.util.Locale getLocale()
- The default behavior of this method is to return getLocale()
on the wrapped request object.
- Specified by:
- getLocale in interface ServletRequest
- Tags copied from interface: ServletRequest
- Returns:
- the preferred
Locale
for the client
getLocales
public java.util.Enumeration getLocales()
- The default behavior of this method is to return getLocales()
on the wrapped request object.
- Specified by:
- getLocales in interface ServletRequest
- Tags copied from interface: ServletRequest
- Returns:
- 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.
- Specified by:
- isSecure in interface ServletRequest
- Tags copied from interface: ServletRequest
- Returns:
- a boolean indicating if the request was made using a
secure channel
getRequestDispatcher
public RequestDispatcher getRequestDispatcher(java.lang.String path)
- The default behavior of this method is to return getRequestDispatcher(String path)
on the wrapped request object.
- Specified by:
- getRequestDispatcher in interface ServletRequest
- Tags copied from interface: ServletRequest
- Parameters:
path
- a String
specifying the pathname
to the resource. If it is relative, it must be
relative against the current servlet.- Returns:
- 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
- See Also:
RequestDispatcher
,
ServletContext.getRequestDispatcher(java.lang.String)
getRealPath
public java.lang.String getRealPath(java.lang.String path)
- The default behavior of this method is to return getRealPath(String path)
on the wrapped request object.
- Specified by:
- getRealPath in interface ServletRequest