Package javax.servlet

Class ServletRequestWrapper

  • All Implemented Interfaces:
    ServletRequest
    Direct Known Subclasses:
    HttpServletRequestWrapper

    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.
    Since:
    Servlet 2.3
    See Also:
    ServletRequest
    • Constructor Detail

      • ServletRequestWrapper

        public ServletRequestWrapper​(ServletRequest request)
        Creates a ServletRequest adaptor wrapping the given request object.
        Parameters:
        request - the ServletRequest to be wrapped
        Throws:
        IllegalArgumentException - if the request is null
    • Method Detail

      • getAttribute

        public Object getAttribute​(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
        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 Enumeration<String> getAttributeNames()
        The default behavior of this method is to return getAttributeNames() on the wrapped request object.
        Specified by:
        getAttributeNames in interface ServletRequest
        Returns:
        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.
        Specified by:
        getCharacterEncoding in 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​(String enc)
                                  throws UnsupportedEncodingException
        The default behavior of this method is to set the character encoding on the wrapped request object.
        Specified by:
        setCharacterEncoding in interface ServletRequest
        Parameters:
        enc - String containing the name of the character encoding.
        Throws:
        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.
        Specified by:
        getContentLength in interface ServletRequest
        Returns:
        an integer containing the length of the request body or -1 if the length is not known or is greater than Integer.MAX_VALUE.
      • getContentLengthLong

        public long getContentLengthLong()
        The default behavior of this method is to return getContentLengthLong() on the wrapped request object.
        Specified by:
        getContentLengthLong in interface ServletRequest
        Returns:
        a long containing the length of the request body or -1L if the length is not known
        Since:
        Servlet 3.1
      • getContentType

        public String getContentType()
        The default behavior of this method is to return getContentType() on the wrapped request object.
        Specified by:
        getContentType in interface ServletRequest
        Returns:
        a String containing the name of the MIME type of the request, or null if the type is not known
      • getParameterMap

        public Map<String,​String[]> getParameterMap()
        The default behavior of this method is to return getParameterMap() on the wrapped request object.
        Specified by:
        getParameterMap in 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 Enumeration<String> getParameterNames()
        The default behavior of this method is to return getParameterNames() on the wrapped request object.
        Specified by:
        getParameterNames in 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 String[] getParameterValues​(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
        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 String getProtocol()
        The default behavior of this method is to return getProtocol() on the wrapped request object.
        Specified by:
        getProtocol in interface ServletRequest
        Returns:
        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.
        Specified by:
        getScheme in interface ServletRequest
        Returns:
        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.
        Specified by:
        getServerName in 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
        Returns:
        an integer specifying the port number
      • getRemoteAddr

        public String getRemoteAddr()
        The default behavior of this method is to return getRemoteAddr() on the wrapped request object.
        Specified by:
        getRemoteAddr in interface ServletRequest
        Returns:
        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.
        Specified by:
        getRemoteHost in interface ServletRequest
        Returns:
        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.
        Specified by:
        setAttribute in interface ServletRequest
        Parameters:
        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.
        Specified by:
        removeAttribute in interface ServletRequest
        Parameters:
        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.
        Specified by:
        getLocale in interface ServletRequest
        Returns:
        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.
        Specified by:
        getLocales in 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
        Returns:
        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.
        Specified by:
        getRequestDispatcher in 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

        @Deprecated
        public String getRealPath​(String path)
        Deprecated.
        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.
        Specified by:
        getRealPath in interface ServletRequest
        Parameters:
        path - the path for which the real path is to be returned.
        Returns:
        the real path, or null if the translation cannot be performed.
      • 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
        Returns:
        an integer specifying the port number
        Since:
        Servlet 2.4
      • getLocalName

        public String getLocalName()
        The default behavior of this method is to return getLocalName() on the wrapped request object.
        Specified by:
        getLocalName in interface ServletRequest
        Returns:
        a String containing the host name of the IP on which the request was received.
        Since:
        Servlet 2.4
      • getLocalAddr

        public String getLocalAddr()
        The default behavior of this method is to return getLocalAddr() on the wrapped request object.
        Specified by:
        getLocalAddr in interface ServletRequest
        Returns:
        a String containing the IP address on which the request was received.
        Since:
        Servlet 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
        Returns:
        an integer specifying the port number
        Since:
        Servlet 2.4
      • getServletContext

        public ServletContext getServletContext()
        Gets the servlet context to which the wrapped servlet request was last dispatched.
        Specified by:
        getServletContext in interface ServletRequest
        Returns:
        the servlet context to which the wrapped servlet request was last dispatched
        Since:
        Servlet 3.0
      • isAsyncStarted

        public boolean isAsyncStarted()
        Checks if the wrapped request has been put into asynchronous mode.
        Specified by:
        isAsyncStarted in interface ServletRequest
        Returns:
        true if this request has been put into asynchronous mode, false otherwise
        Since:
        Servlet 3.0
        See Also:
        ServletRequest.isAsyncStarted()
      • isAsyncSupported

        public boolean isAsyncSupported()
        Checks if the wrapped request supports asynchronous operation.
        Specified by:
        isAsyncSupported in interface ServletRequest
        Returns:
        true if this request supports asynchronous operation, false otherwise
        Since:
        Servlet 3.0
        See Also:
        ServletRequest.isAsyncSupported()
      • isWrapperFor

        public boolean isWrapperFor​(ServletRequest wrapped)
        Checks (recursively) if this ServletRequestWrapper wraps the given ServletRequest instance.
        Parameters:
        wrapped - the ServletRequest instance to search for
        Returns:
        true if this ServletRequestWrapper wraps the given ServletRequest instance, false otherwise
        Since:
        Servlet 3.0
      • isWrapperFor

        public boolean isWrapperFor​(Class<?> wrappedType)
        Checks (recursively) if this ServletRequestWrapper wraps a ServletRequest of the given class type.
        Parameters:
        wrappedType - the ServletRequest class type to search for
        Returns:
        true if this ServletRequestWrapper wraps a ServletRequest of the given class type, false otherwise
        Throws:
        IllegalArgumentException - if the given class does not implement ServletRequest
        Since:
        Servlet 3.0