Java-ServletRequestWrapper

/**
 *
 * 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 	javax.servlet.ServletRequest
 *
 */
//实现了ServletRequest接口
public class ServletRequestWrapper implements ServletRequest {
    private ServletRequest request;

	/**
	* Creates a ServletRequest adaptor wrapping the given request object.
	* @throws java.lang.IllegalArgumentException if the request is null
	*/
    //构造函数，ServletRequest适配器
    public ServletRequestWrapper(ServletRequest request) {
    	if (request == null) {
    		throw new IllegalArgumentException("Request cannot be null");
    	}
    	this.request = request;
    }

	/**
	* Return the wrapped request object.
	*/
    //获得Request
	public ServletRequest getRequest() {
		return this.request;
	}
	/**
	* Sets the request object being wrapped.
	* @throws java.lang.IllegalArgumentException if the request is null.
	*/
	//设置ServletRequest
	public void setRequest(ServletRequest request) {
	    if (request == null) {
	    	throw new IllegalArgumentException("Request cannot be null");
	    }
	    this.request = request;
	}
    /**
     * The default behavior of this method is to call getAttribute(String name)
     * on the wrapped request object.
     */
	//获取ServletRequest的name属性
    public Object getAttribute(String name) {
    	return this.request.getAttribute(name);
	}
    /**
     * The default behavior of this method is to return getAttributeNames()
     * on the wrapped request object.
     */
    //获得所有属性name的枚举
    public Enumeration getAttributeNames() {
	return this.request.getAttributeNames();
	}
    /**
      * The default behavior of this method is to return getCharacterEncoding()
     * on the wrapped request object.
     */
    //获得字符类型
    public String getCharacterEncoding() {
	return this.request.getCharacterEncoding();
	}
    /**
      * The default behavior of this method is to set the character encoding
     * on the wrapped request object.
     */
    //设置字符类型
    public void setCharacterEncoding(String enc) throws java.io.UnsupportedEncodingException {
	this.request.setCharacterEncoding(enc);
	}
    /**
      * The default behavior of this method is to return getContentLength()
     * on the wrapped request object.
     */
    //获得Request请求body的二进制数据的长度
    public int getContentLength() {
	return this.request.getContentLength();
    }
    /**
     * The default behavior of this method is to return getContentType()
     * on the wrapped request object.
     */
    //获得Request请求body的文件类型
    public String getContentType() {
    	return this.request.getContentType();
    }
     /**
      * The default behavior of this method is to return getInputStream()
     * on the wrapped request object.
     */
    //获得InputStream
    public ServletInputStream getInputStream() throws IOException {
    	return this.request.getInputStream();
	}
    /**
      * The default behavior of this method is to return getParameter(String name)
     * on the wrapped request object.
     */
    //获得参数name
    public String getParameter(String name) {
    	return this.request.getParameter(name);
    }
    /**
      * The default behavior of this method is to return getParameterMap()
     * on the wrapped request object.
     */
    public Map getParameterMap() {
    	return this.request.getParameterMap();
    }
    /**
      * The default behavior of this method is to return getParameterNames()
     * on the wrapped request object.
     */
     //获得属性name的枚举
    public Enumeration getParameterNames() {
    	return this.request.getParameterNames();
    }
    /**
     * The default behavior of this method is to return getParameterValues(String name)
     * on the wrapped request object.
     */
    //获得属性name的所有值
    public String[] getParameterValues(String name) {
    	return this.request.getParameterValues(name);
	}
     /**
      * The default behavior of this method is to return getProtocol()
     * on the wrapped request object.
     */
    //获取协议
    public String getProtocol() {
    	return this.request.getProtocol();
	}
    /**
      * The default behavior of this method is to return getScheme()
     * on the wrapped request object.
     */
    //返回协议名称 http、https、ftp
    public String getScheme() {
    	return this.request.getScheme();
	}
    /**
      * The default behavior of this method is to return getServerName()
     * on the wrapped request object.
     */
    //获得请求发送的服务器名称
    public String getServerName() {
    	return this.request.getServerName();
	}
   /**
      * The default behavior of this method is to return getServerPort()
     * on the wrapped request object.
     */
    //获得请求发送的端口
    public int getServerPort() {
	return this.request.getServerPort();
	}

    /**
      * The default behavior of this method is to return getReader()
     * on the wrapped request object.
     */
  //检索请求body数据作为字符数据使用bufferedReader
    public BufferedReader getReader() throws IOException {
    	return this.request.getReader();
	}
    /**
      * The default behavior of this method is to return getRemoteAddr()
     * on the wrapped request object.
     */
    //获得远程主机IP
    public String getRemoteAddr() {
    	return this.request.getRemoteAddr();
    }
      /**
      * The default behavior of this method is to return getRemoteHost()
     * on the wrapped request object.
     */
    //获得发送请求的主机名或最后一次代理的主机名
    public String getRemoteHost() {
    	return this.request.getRemoteHost();
    }
    /**
      * The default behavior of this method is to return setAttribute(String name, Object o)
     * on the wrapped request object.
     */
    //在请求中设置一个属性
    public void setAttribute(String name, Object o) {
    	this.request.setAttribute(name, o);
    }
    /**
      * The default behavior of this method is to call removeAttribute(String name)
     * on the wrapped request object.
     */
    //删除请求的属性name
    public void removeAttribute(String name) {
    	this.request.removeAttribute(name);
    }
   /**
      * The default behavior of this method is to return getLocale()
     * on the wrapped request object.
     */

    public Locale getLocale() {
    	return this.request.getLocale();
    }
     /**
      * The default behavior of this method is to return getLocales()
     * on the wrapped request object.
     */
    public Enumeration getLocales() {
	return this.request.getLocales();
    }
    /**
      * The default behavior of this method is to return isSecure()
     * on the wrapped request object.
     */
    //判断是否使用的安全协议https
    public boolean isSecure() {
    	return this.request.isSecure();
    }
    /**
      * The default behavior of this method is to return getRequestDispatcher(String path)
     * on the wrapped request object.
     */
    //获得path的分发器
    public RequestDispatcher getRequestDispatcher(String path) {
    	return this.request.getRequestDispatcher(path);
    }
    /**
      * The default behavior of this method is to return getRealPath(String path)
     * on the wrapped request object.
     */

    public String getRealPath(String path) {
	return this.request.getRealPath(path);
    }

    /**
     * The default behavior of this method is to return
     * getRemotePort() on the wrapped request object.
     *
     * @since 2.4
     */
    //端口
    public int getRemotePort(){
        return this.request.getRemotePort();
    }
    /**
     * The default behavior of this method is to return
     * getLocalName() on the wrapped request object.
     *
     * @since 2.4
     */
    //获得Request的服务器名
    public String getLocalName(){
        return this.request.getLocalName();
    }

    /**
     * The default behavior of this method is to return
     * getLocalAddr() on the wrapped request object.
     *
     * @since 2.4
     */
    //获得Request的服务器IP地址
    public String getLocalAddr(){
        return this.request.getLocalAddr();
    }
    /**
     * The default behavior of this method is to return
     * getLocalPort() on the wrapped request object.
     *
     * @since 2.4
     */
    //端口
    public int getLocalPort(){
        return this.request.getLocalPort();
    }

}