Servlet 客户端 HTTP 请求

关键要点

• Servlet 通过 HttpServletRequest 对象处理客户端的 HTTP 请求，获取请求方法、请求头和参数等信息。
• 请求处理包括 GET 和 POST 方法，需注意中文字符的编码问题。
• 研究表明，Servlet 容器（如 Tomcat）负责管理请求生命周期，确保每个请求被正确处理。

什么是 Servlet 处理 HTTP 请求？

Servlet 是运行在 Web 服务器上的 Java 程序，用于处理客户端（如浏览器）发送的 HTTP 请求。当用户通过浏览器访问网页时，Servlet 容器会接收请求，并创建一个 HttpServletRequest 对象来封装请求信息。Servlet 然后通过这个对象读取请求的细节，如 HTTP 方法（GET 或 POST）、请求头（如 User-Agent）和请求参数（如表单数据）。

如何处理请求？

• GET 请求：参数通过 URL 的查询字符串传递，Servlet 使用 getParameter() 方法读取。
• POST 请求：参数通过请求体发送，同样使用 getParameter()，但需设置 request.setCharacterEncoding("UTF-8") 处理中文字符。
• Servlet 容器调用 service() 方法，根据请求类型调用 doGet() 或 doPost() 处理。

注意事项

处理中文字符时，需确保请求编码为 UTF-8，以避免乱码。研究显示，GET 请求可能需要额外配置服务器支持 UTF-8。

---

---

详细报告

以下是关于 Servlet 处理客户端 HTTP 请求的全面分析，涵盖其流程、关键对象、方法、字符编码处理以及示例代码，旨在为读者提供深入了解和实践指导。

背景与定义

Servlet（Java Servlet）是一种运行在 Web 服务器或应用服务器上的 Java 程序，主要用于处理 HTTP 请求并生成动态网页内容。客户端 HTTP 请求是指用户通过浏览器或其他 HTTP 客户端（如 Postman）发送的请求，Servlet 通过 HttpServletRequest 对象读取这些请求信息，并根据业务逻辑生成响应。处理 HTTP 请求是 Java Web 开发中的核心功能之一，尤其是在处理中文字符时需注意编码问题。

Servlet 处理 HTTP 请求的流程

当客户端发送 HTTP 请求时，Servlet 容器（如 Tomcat）会执行以下步骤：

1. 接收请求：Servlet 容器接收到客户端的 HTTP 请求。
2. 创建对象：容器为每个请求创建一个 HttpServletRequest 对象（封装请求信息）和一个 HttpServletResponse 对象（用于构建响应）。
3. 调用 Servlet：容器调用 Servlet 的 service() 方法，并传入 HttpServletRequest 和 HttpServletResponse 对象。
4. 处理请求：在 service() 方法中，Servlet 根据 HTTP 方法（如 GET、POST）调用相应的处理方法（如 doGet() 或 doPost()），读取请求信息并执行逻辑。
5. 生成响应：Servlet 通过 HttpServletResponse 对象构建响应，并返回给客户端。
6. 销毁对象：请求处理完成后，HttpServletRequest 和 HttpServletResponse 对象被销毁。

HttpServletRequest 对象详解

HttpServletRequest 是 Servlet 处理 HTTP 请求的核心对象，它提供了许多方法来获取请求的详细信息。以下是关键方法分类：

请求行信息

返回值类型	方法声明	描述
String	getMethod()	获取 HTTP 请求方式（如 GET、POST）。
String	getRequestURI()	获取请求的 URI（资源路径）。
String	getQueryString()	获取 URL 中的查询字符串（如参数）。
String	getContextPath()	返回应用名字（上下文），默认（ROOT）返回空字符串””。
String	getServletPath()	获取 Servlet 映射路径。
String	getRemoteAddr()	获取客户端 IP 地址。
String	getRemoteHost()	获取客户端完整主机名，若无法解析返回 IP 地址。

请求头信息

返回值类型	方法声明	描述
String	getHeader(String name)	获取指定头字段值，若多个返回第一个。
Enumeration	getHeaders(String name)	返回指定头字段所有值的枚举集合。
Enumeration	getHeaderNames()	返回所有头字段名的枚举集合。
String	getContentType()	获取 Content-Type 头字段值。
int	getContentLength()	获取 Content-Length 头字段值。
String	getCharacterEncoding()	返回请求消息字符集编码。

请求参数

返回值类型	方法声明	功能描述
String	getParameter(String name)	返回指定参数名的参数值。
String[]	getParameterValues(String name)	返回指定参数名所有参数值的字符串数组。
Enumeration	getParameterNames()	返回请求中所有参数名的枚举集合。
Map	getParameterMap()	将所有参数名和值装入 Map 对象返回。

这些方法通过 HttpServletRequest 对象调用，需注意参数名称大小写敏感。

处理不同类型的请求

Servlet 支持多种 HTTP 方法，但最常见的是 GET 和 POST：

• GET 请求：
• 参数通过 URL 的查询字符串传递，例如 http://example.com?name=张三&age=25。
• 使用 getParameter() 方法读取参数，例如 String name = request.getParameter("name");。
• 适合传递少量数据，URL 长度有限（通常 1024 字符），不适合敏感信息。
• POST 请求：
• 参数通过请求体传递，通常用于表单提交。
• 同样使用 getParameter() 方法读取参数，但需注意字符编码问题。
• 适合传递大量数据或敏感信息，如密码。

处理中文字符

中文字符在 HTTP 请求中可能出现乱码，原因在于默认编码为 ISO-8859-1，而中文需要 UTF-8 编码。以下是处理中文字符的常见方法：

• POST 请求：
• 在 Servlet 中设置请求编码：request.setCharacterEncoding("UTF-8")，应在读取参数前调用。
• 示例：
  java protected void doPost(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException { request.setCharacterEncoding("UTF-8"); String username = request.getParameter("username"); // 后续处理 }
• GET 请求：
• Tomcat 8 及以上版本默认支持 UTF-8，Tomcat 7 及以下版本需配置服务器：
  • 修改 tomcat/conf/server.xml：<Connector port="80" protocol="HTTP/1.1" connectionTimeout="20000" redirectPort="8443" URIEncoding="UTF-8"/>。
• 或手动解码：String name = new String(request.getParameter("name").getBytes("ISO-8859-1"), "UTF-8");。

示例代码

以下是一个简单的 Servlet 示例，展示了如何处理客户端的 HTTP 请求并读取请求头信息：

import java.io.IOException;
import java.io.PrintWriter;
import java.util.Enumeration;

import javax.servlet.ServletException;
import javax.servlet.http.HttpServlet;
import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;

public class DisplayHeader extends HttpServlet {
    protected void doGet(HttpServletRequest request, HttpServletResponse response)
            throws ServletException, IOException {
        response.setContentType("text/html;charset=UTF-8");
        PrintWriter out = response.getWriter();
        String title = "HTTP Header 请求实例";
        out.println("<html><head><title>" + title + "</title></head>");
        out.println("<body bgcolor=\"#f0f0f0\"><h1 align=\"center\">" + title + "</h1>");
        out.println("<table width=\"100%\" border=\"1\" align=\"center\">");
        out.println("<tr bgcolor=\"#949494\"><th>Header 名称</th><th>Header 值</th></tr>");

        Enumeration<String> headerNames = request.getHeaderNames();
        while (headerNames.hasMoreElements()) {
            String paramName = headerNames.nextElement();
            out.print("<tr><td>" + paramName + "</td>");
            String paramValue = request.getHeader(paramName);
            out.println("<td>" + paramValue + "</td></tr>");
        }
        out.println("</table></body></html>");
    }

    protected void doPost(HttpServletRequest request, HttpServletResponse response)
            throws ServletException, IOException {
        doGet(request, response);
    }
}

• 访问方式：通过浏览器访问配置的 URL（如 `[invalid url, do not cite] ），显示所有 HTTP 请求头信息。

技术细节与扩展

• 线程安全：Servlet 是单实例多线程的，doGet() 和 doPost() 方法在多线程环境下执行，需确保实例变量线程安全。
• 异常处理：在读取请求数据时，需捕获可能的 IOException 和 ServletException，并适当处理。
• 安全性：对于敏感数据（如密码），应使用 POST 方法，并考虑 HTTPS 加密传输。
• HTTP 头示例：常见的请求头包括 Accept、User-Agent、Cookie 等，具体可参考 HTTP 协议教程。

对比与争议

关于中文字符处理，不同资料的建议略有差异。部分资料（如 Runoob）强调手动转换编码（如 getBytes("ISO-8859-1")），而 W3cschool 更推荐设置 request.setCharacterEncoding("UTF-8")。研究表明，后者更简洁，适用于 Tomcat 9 及以上版本，但需注意 Tomcat 版本兼容性。

总结与实践建议

Servlet 通过 HttpServletRequest 对象处理客户端的 HTTP 请求，提供了丰富的方法来读取请求信息，包括请求方法、请求头、请求参数等。处理请求时，需要特别注意字符编码问题，以确保中文字符正确显示。同时，Servlet 容器负责管理请求的生命周期，确保每个请求都能被正确处理并返回响应。

建议在开发中：

• 始终设置 request.setCharacterEncoding("UTF-8") 以避免乱码。
• 测试不同请求类型（如 GET、POST），确保数据读取正确。
• 关注线程安全和安全性，确保应用程序稳定运行。

参考资料：

• Servlet 客户端 HTTP 请求 | 菜鸟教程
• HttpServletRequest接口详解 – C语言中文网
• Servlet 服务器 HTTP 响应 | 菜鸟教程