概述
servlet-api 4.0.1版本
HttpServletRequest对象代表客户端的请求，当客户端通过HTTP协议访问服务器时，HTTP请求头中的所有信息都封装在这个对象中，通过这个对象提供的方法，可以获得客户端请求的所有信息。
常用方法
HttpServletRequest接口
扩展ServletRequest接口以提供HTTP Servlet的请求信息。Servlet容器创建一个HttpServletRequest对象，并将其作为参数传递给Servlet的服务方法（doGet，doPost等）。
public String getAuthType(); // 返回用于保护servlet的认证方案的名称
public Cookie[] getCookies(); // 返回一个数组，其中包含客户端与此请求一起发送的所有Cookie对象
public String getContextPath(); // 返回请求URI中指示请求上下文的部分
// /xxx
public HttpSession getSession(); // 返回与此请求关联的当前HttpSession，get后创建session？
public long getDateHeader(String name); // 返回指定请求标头的值，作为代表Date对象的长值
public String getHeader(String name); // 以字符串形式返回指定请求标头的值。 不包含则返回null，多个返回第一个
public Enumeration<String> getHeaders(String name); // 以String对象的枚举形式返回指定请求标头的所有值
public Enumeration<String> getHeaderNames(); // 返回此请求包含的所有标头名称的枚举
public int getIntHeader(String name); // 以int形式返回指定请求标头的值。 如果请求中没有指定名称的标头，则此方法返回-1
default public HttpServletMapping getHttpServletMapping() {...} // 返回调用该HttpServletRequest的HttpServlet的HttpServletMapping
public String getMethod(); // 返回发出此请求的HTTP方法的名称，例如GET，POST或PUT
public String getPathInfo(); // 返回与客户端发出此请求时发送的URL相关的任何其他路径信息
public String getPathTranslated(); // 返回servlet名称之后但查询字符串之前的所有其他路径信息，并将其转换为真实路径
public String getQueryString(); // 返回路径后面的请求URL中包含的查询字符串
public String getRemoteUser(); // 如果用户已通过身份验证，则返回发出此请求的用户的登录名；如果用户未通过身份验证，则返回null
public boolean isUserInRole(String role); // 返回一个布尔值，指示已认证的用户是否包含在指定的逻辑“角色”中。 如果用户尚未通过身份验证，则该方法返回false
public String getRequestedSessionId(); // 返回客户端指定的会话ID。 该名称可能与此请求的当前有效会话的ID不同。 如果客户端未指定会话ID，则此方法返回null
public String getRequestURI(); // 返回此请求的URL的一部分，从协议名称到HTTP请求第一行中的查询字符串。 Web容器不会解码此String
public StringBuffer getRequestURL(); // 重构客户端用于发出请求的URL。 返回的URL包含协议，服务器名称，端口号和服务器路径，但不包含查询字符串参数
public String getServletPath(); // 返回此请求的URL中调用servlet的部分。 该路径以“ /”字符开头，包括servlet名称或servlet路径，但不包含任何额外的路径信息或查询字符串。
public String changeSessionId(); // 更改与此请求关联的当前会话的会话ID，并返回新的会话ID
public boolean isRequestedSessionIdValid(); // 检查请求的会话ID是否仍然有效。如果客户端未指定任何会话ID，则此方法返回false。
public boolean isRequestedSessionIdFromCookie(); // 检查请求的会话ID是否作为HTTP cookie传递到服务器。
public boolean isRequestedSessionIdFromURL(); // 检查请求的会话ID是否已作为请求URL的一部分传送到服务器。
public boolean authenticate(HttpServletResponse response) throws IOException,ServletException; // 使用为ServletContext配置的容器登录机制来验证发出此请求的用户
public void login(String username, String password) throws ServletException; // 在为ServletContext配置的Web容器登录机制所使用的密码验证领域中，验证提供的用户名和密码
public void logout() throws ServletException; // 将null设置为在请求上调用getUserPrincipal，getRemoteUser和getAuthType时返回的值
public Collection<Part> getParts() throws IOException, ServletException; // 获取此请求的所有Part组件，条件是该请求的类型为multipart / form-data
public Part getPart(String name) throws IOException, ServletException; // 获取具有给定名称的Part
ServletRequest接口
定义一个对象以向Servlet提供客户端请求信息。 Servlet容器创建一个ServletRequest对象，并将其作为参数传递给Servlet的service方法
public RequestDispatcher getRequestDispatcher(String path); // 返回一个RequestDispatcher对象，该对象充当位于给定路径的资源的包装
// 请求转发
public Object getAttribute(String name); // 将命名属性的值作为Object返回；如果不存在给定名称的属性，则返回null
public Enumeration<String> getAttributeNames(); // 返回一个枚举，其中包含可用于此请求的属性的名称
public String getCharacterEncoding(); // 返回此请求正文中使用的字符编码的名称。 如果未指定请求编码字符编码，则此方法返回null
public void setCharacterEncoding(String env) throws UnsupportedEncodingException; // 覆盖此请求正文中使用的字符编码的名称。 在读取请求参数或使用`getReader()`读取输入之前，必须先调用此方法。 否则，它无效。
public int getContentLength(); // 返回请求主体的长度，以字节为单位，该长度可由输入流提供；如果未知，则返回-1
public long getContentLengthLong();
public String getContentType(); // 返回请求正文的MIME类型；如果类型未知，则返回null
public ServletInputStream getInputStream() throws IOException; // 使用ServletInputStream以二进制数据的形式检索请求的主体
public String getParameter(String name); // 以字符串形式返回请求参数的值，如果参数不存在，则返回null
public Enumeration<String> getParameterNames(); // 返回包含此请求中包含的参数名称的String对象的Enumeration
public String[] getParameterValues(String name); // 返回一个String对象数组，其中包含给定请求参数具有的所有值；如果该参数不存在，则返回null
public Map<String, String[]> getParameterMap(); // 返回此请求的参数的java.util.Map
public String getProtocol(); // 返回请求使用的协议的名称和版本，例如HTTP / 1.1
public String getScheme(); // 返回用于发出此请求的方案的名称，例如，http，https或ftp
public String getServerName(); // 返回请求发送到的服务器的主机名。
public int getServerPort(); // 返回请求发送到的端口号
public BufferedReader getReader() throws IOException; // 使用BufferedReader检索请求的正文作为字符数据
public String getRemoteAddr(); // 返回发送请求的客户端或最后一个代理的Internet协议（IP）地址
public String getRemoteHost(); // 返回发送请求的客户端或最后一个代理的标准名称
public int getRemotePort(); // 返回发送请求的客户端或最后一个代理的Internet协议（IP）源端口。
public void setAttribute(String name, Object o); // 在此请求中存储属性。 在请求之间重置属性。 此方法最常与RequestDispatcher结合使用
public void removeAttribute(String name); // 从此请求中删除属性。 通常不需要此方法，因为仅在处理请求时属性才持久存在。
public Locale getLocale(); // 根据Accept-Language标头返回客户端将在其中接受内容的首选语言环境。 如果客户端请求未提供Accept-Language标头，则此方法返回服务器的默认语言环境。
public Enumeration<Locale> getLocales(); // 返回一个Locale对象的Enumeration，以从首选语言环境开始的降序指示，基于Accept-Language标头，客户端可以接受的语言环境。
public boolean isSecure(); // 返回一个布尔值，指示此请求是否使用安全通道（例如HTTPS）发出
public String getLocalName(); // 返回接收请求的Internet Protocol (IP)接口的主机名
public String getLocalAddr(); // 返回接收请求的接口的Internet协议（IP）地址
public int getLocalPort(); // 返回接收请求的接口的Internet协议(IP)端口号
public ServletContext getServletContext(); // 获取servlet请求最后被分派到的servlet上下文
public AsyncContext startAsync() throws IllegalStateException; // 将此请求置于异步模式
public boolean isAsyncStarted(); // 检查此请求是否已置于异步模式
public boolean isAsyncSupported(); // 检查此请求是否支持异步操作
public AsyncContext getAsyncContext(); // 获取通过对此请求最近一次调用startAsync或startAsync（ServletRequest，ServletResponse）创建或重新初始化的AsyncContext。
public DispatcherType getDispatcherType(); // 获取此请求的调度程序类型
获取表单值
JSP
<body>
<form action="<%=request.getContextPath()%>/getFormValue" method="get" name="info">
<p>用户名：<input type="text" name="username"></p>
<p>密码：<input type="password" name="password"></p>
<p>性别：
<input type="radio" name="gender" value="man" checked>男
<input type="radio" name="gender" value="woman">女
</p>
<p>爱好：
<input type="checkbox" name="hobbies" value="eat">吃
<input type="checkbox" name="hobbies" value="drink">喝
</p>
<p>居住地：
<select name="city">
<option value="beijing">北京</option>
<option value="shanghai">上海</option>
</select>
</p>
<p><input type="submit" value="提交"><input type="reset"></p>
</form>
</body>
Servlet
@Override
protected void doGet(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException {
// request.setCharacterEncoding("utf-8");
Enumeration<String> parameterNames = request.getParameterNames();
while (parameterNames.hasMoreElements()) {
// username、password、gender、hobbies、city
System.out.println(parameterNames.nextElement());
}
String username = request.getParameter("username");
String password = request.getParameter("password");
String gender = request.getParameter("gender");
String[] hobbies = request.getParameterValues("hobbies");
String city = request.getParameter("city");
System.out.println("username："+ username);
System.out.println("password："+ password);
System.out.println("gender："+ gender);
System.out.println("hobbies："+ Arrays.toString(hobbies));
System.out.println("city："+ city);
}
tomcat8.0开始，URIEncoding默认值不再是ISO8859-1，而变成了UTF-8，Get请求方式不用再转换编码，post方式仍需要