深入解析 Servlet 中的 HTTP GET 与 POST 请求处理：从基础到实战

2026-02-06 02:41:01 0条评论 3次阅读 0人点赞

在构建现代化的企业级 Web 应用程序时，掌握服务器端如何处理客户端请求是一项至关重要的技能。作为 Java Web 开发的核心组件，Servlet 扮演着连接用户请求与业务逻辑的桥梁角色。而在日常开发中，我们最常打交道的无疑是 HTTP GET 和 POST 请求。

你是否曾经想过，为什么我们在搜索时浏览器地址栏会发生变化，而在登录密码时却保持不变？又或者，作为开发者，我们该如何在 Servlet 中优雅地处理这些不同类型的请求，确保数据传输既安全又高效？

在这篇文章中，我们将深入探讨 Servlet 处理 HTTP GET 和 POST 请求的机制。我们将不仅仅停留在代码层面，还会剖析它们背后的工作原理、核心差异，并通过丰富的实战案例，向大家展示编写可维护、高性能 Servlet 代码的最佳实践。无论你是刚接触 Java Web 开发，还是希望巩固基础知识的开发者，这篇文章都将为你提供实用的指导。

前置准备

在正式开始编写代码之前，作为专业的开发者，我们需要确保手中的“武器”已经准备就绪。为了能够顺利运行接下来的示例，请确保你的开发环境已经配置好了以下组件：

  • Java 开发工具包 (JDK)：建议使用 JDK 8 或更高版本，这是运行 Java 程序的基础。
  • Web 服务器：我们推荐使用 Apache Tomcat（版本 9 或更高）。Tomcat 是一个成熟的 Servlet 容器，能够完美支持我们要演示的功能。
  • 集成开发环境 (IDE)：像 Eclipse、IntelliJ IDEA 或 NetBeans 这样的工具能极大提高我们的开发效率，特别是在处理部署和调试时。
  • 基础知识：具备一定的 Java 核心语法（如类、方法、异常处理）和 HTML 表单的基础知识将会让你理解起来更加轻松。

理解 HTTP 方法：GET vs POST

HTTP 协议定义了多种请求方法，但在 Servlet 应用程序中，GET 和 POST 无疑是占据统治地位的两种。理解它们的区别是决定何时使用哪种方法的关键。

#### GET 方法：获取数据的窗口

GET 是最常见的一种 HTTP 方法，它的设计初衷是“从服务器获取数据”。

  • 数据可见性：当你使用 GET 请求时，表单数据会以“键值对”的形式附加在 URL 后面，例如 http://example.com/add?num1=5&num2=10。这意味着数据在浏览器地址栏中是可见的。
  • 缓存与书签：由于参数都在 URL 中，GET 请求的结果可以被浏览器缓存，用户也可以轻松地将结果页面加入书签或分享链接。
  • 数据限制：URL 的长度是有限制的（虽然不同浏览器限制不同，但通常在 2048 字符左右），因此 GET 不适合传输大量数据。
  • 安全性：虽然 GET 本身并不比 POST 更不安全（HTTPS 请求两者都是加密的），但由于敏感信息（如密码）会显示在历史记录和服务器日志中，因此绝对不要用 GET 来传输敏感数据。

#### POST 方法：提交数据的保障

POST 方法通常用于向服务器“发送数据”以创建或更新资源。

  • 数据隐蔽性：POST 请求的数据被放置在 HTTP 请求体中，而不是 URL。这意味着用户在地址栏中看不到这些数据，更加适合传输敏感信息。
  • 数据容量：请求体没有 URL 那样的长度限制，我们可以使用 POST 来上传文件或发送包含大量文本的表单。
  • 幂等性：GET 请求是幂等的，即多次相同的 GET 请求不应该改变服务器状态；而 POST 请求通常是非幂等的，每次提交都可能在服务器上创建新记录或产生副作用。

> 注意：如果我们在 HTML 表单中省略 method 属性，浏览器会默认使用 GET 方法。这有时会导致意想不到的错误，特别是在处理登录表单时，所以请务必明确指定 method。

实现步骤：构建一个加法计算器应用

为了直观地演示这两种请求的区别，我们将构建一个简单的 Web 应用，实现两个数字的加法运算。我们将分别演示如何使用 GET 和 POST 来传递这两个数字，并观察 Servlet 如何处理它们。

#### 步骤 1：搭建项目结构

首先，我们需要在 IDE 中创建一个“动态 Web项目”。确保你的项目结构中包含 INLINECODEc2d0f533 文件夹和 INLINECODEef3fdd5d 配置文件（虽然现在流行使用注解 INLINECODE2b455d54，但理解 INLINECODEca664ccd 的配置原理对于排查问题非常有帮助，我们将在示例中结合使用）。

#### 步骤 2：处理 GET 请求

让我们先从 GET 请求开始。我们将创建一个 HTML 页面和一个对应的 Servlet。

用于 GET 请求的 HTML 表单

创建一个名为 INLINECODE089146ba 的文件。在这个文件中，我们定义了一个表单，明确指定 INLINECODEddebf58d。






GET Request Calculator


  
  
    

GET Method Addition

处理 GET 请求的 Servlet

接下来，我们需要编写一个 Java 类来处理这个请求。核心在于重写 doGet 方法。

package com.learnservlets;

import java.io.IOException;
import java.io.PrintWriter;
import javax.servlet.http.HttpServlet;
import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;

// 继承 HttpServlet 是实现 Servlet 的标准方式
public class AddServlet extends HttpServlet {
    
    // 重写 doGet 方法，专门处理 GET 请求
    public void doGet(HttpServletRequest req, HttpServletResponse res) throws IOException {
        // 设置响应内容类型为 HTML，并使用 UTF-8 编码防止中文乱码
        res.setContentType("text/html;charset=UTF-8");
        
        // 获取 PrintWriter 对象用于向客户端发送响应
        PrintWriter out = res.getWriter();

        try {
            // 从请求参数中获取 num1 和 num2
            // getParameter 方法返回的是 String 类型，需要转换
            String num1Str = req.getParameter("num1");
            String num2Str = req.getParameter("num2");
            
            // 简单的空值检查，生产环境中应做更严谨的校验
            if(num1Str == null || num2Str == null || num1Str.isEmpty() || num2Str.isEmpty()) {
                out.println("
错误：请输入两个数字！
");
                out.println("返回重试");
                return;
            }

            int num1 = Integer.parseInt(num1Str);
            int num2 = Integer.parseInt(num2Str);
            int result = num1 + num2;

            // 输出 HTML 响应
            out.println("");
            out.println("
计算结果 (来自 GET 请求)
");
            out.println("
" + num1 + " + " + num2 + " = " + result + "
");
            // 展示请求 URL，以此证明参数是在 URL 中的
            out.println("
请求 URL: " + req.getRequestURL() + "?" + req.getQueryString() + "
");
            out.println("");
            
        } catch (NumberFormatException e) {
            // 异常处理：如果用户输入的不是数字
            out.println("
输入格式错误：请输入有效的整数。
");
        }
    }
}

在 web.xml 中配置 Servlet 映射

为了让 Web 服务器知道哪个 URL 对应哪个 Servlet，我们需要进行配置。



    
    
        AddServlet
        
        com.learnservlets.AddServlet
    

    
    
        AddServlet
        
        /add

实战测试

  • 将项目部署到 Tomcat 服务器并启动。
  • 打开浏览器访问 index.html。
  • 输入两个数字（例如 10 和 20），点击提交。

观察结果：

请注意浏览器地址栏的变化。你将看到类似 http://localhost:8080/your_project/add?num1=10&num2=20 的 URL。所有的数据都“裸奔”在地址栏中。这就是 GET 请求的典型特征，非常适合搜索页面，但不适合密码。

#### 步骤 3：处理 POST 请求

现在，让我们来优化这个应用，使其更加安全。我们将使用 POST 方法来处理敏感的或更复杂的数据提交。

用于 POST 请求的 HTML 表单

创建一个新文件 INLINECODEcde4a533，或者直接修改 INLINECODEf9c1939b 中的 INLINECODE2b76d24e 属性为 INLINECODE2cf4d80b。





POST Request Example


  
  
    
POST Method Addition

    
注意观察提交后的 URL 地址栏。

更新 Servlet 以处理 POST 请求

如果你现在直接提交上面的表单，而 Servlet 中只有 doGet 方法，你会看到著名的 HTTP 405 "Method Not Allowed" 错误。这是因为 Servlet 容器找不到专门处理 POST 请求的方法。

我们需要在 INLINECODE0e5ae066 类中添加 INLINECODEaf77c0bf 方法。为了避免代码重复，我们可以利用 INLINECODE54928339 调用 INLINECODE1d91db48，或者将核心逻辑提取出来。这里为了展示清晰，我们编写一个新的 doPost 方法，并演示如何设置请求编码，这在处理中文时非常重要。

package com.learnservlets;

import java.io.IOException;
import java.io.PrintWriter;
import javax.servlet.http.HttpServlet;
import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;

public class AddServlet extends HttpServlet {
    
    // 处理 GET 请求的逻辑
    public void doGet(HttpServletRequest req, HttpServletResponse res) throws IOException {
        processRequest(req, res);
    }

    // 处理 POST 请求的逻辑
    public void doPost(HttpServletRequest req, HttpServletResponse res) throws IOException {
        // 关键步骤：在获取参数之前设置请求体的字符编码为 UTF-8
        // 如果不设置这一行，POST 提交的中文可能会变成乱码
        req.setCharacterEncoding("UTF-8");
        
        processRequest(req, res);
    }

    // 公共逻辑处理方法，避免代码重复
    private void processRequest(HttpServletRequest req, HttpServletResponse res) throws IOException {
        res.setContentType("text/html;charset=UTF-8");
        PrintWriter out = res.getWriter();

        try {
            int num1 = Integer.parseInt(req.getParameter("num1"));
            int num2 = Integer.parseInt(req.getParameter("num2"));
            int result = num1 + num2;

            out.println("");
            out.println("
计算结果
");
            out.println("
" + num1 + " + " + num2 + " = " + result + "
");
            // 检查请求方法类型
            out.println("
请求方式: " + req.getMethod() + "
");
            out.println("返回");
            out.println("");
            
        } catch (NumberFormatException e) {
            out.println("
输入格式错误：请输入有效的整数。
");
            out.println("返回");
        }
    }
}

深度解析：POST 中的乱码问题

你可能会注意到，在 INLINECODE3c3c8e5f 方法中，我们特意添加了 INLINECODE43d32035。这是一个非常常见的坑点。

  • GET 请求：参数在 URL 中，Tomcat 通常通过 INLINECODE5cbb196a 中的 INLINECODE05a14233 或 Connector 配置来解析，通常不需要在 Servlet 代码中单独设置（除非高版本 Tomcat 且未配置好）。
  • POST 请求：参数在请求体中。如果没有指定编码，服务器会使用默认的 ISO-8859-1 来解析字节流，导致中文变成乱码。因此，始终在 doPost 的第一行加上这行代码，是养成良好习惯的体现。

进阶思考与最佳实践

现在我们已经掌握了基本的请求处理，但在实际的开发场景中，我们还需要考虑更多。

#### 1. 使用注解简化配置

虽然 INLINECODEdf09ea9c 很经典，但在现代 Java 开发中，我们更倾向于使用注解。我们可以直接在 Servlet 类上添加 INLINECODEd6f74835，从而完全省略 XML 配置。

package com.learnservlets;

import javax.servlet.annotation.WebServlet;
import javax.servlet.http.HttpServlet;

// 使用注解定义 URL 模式，不再需要 web.xml
// 这里的 "/add" 对应了之前在 xml 中配置的 url-pattern
@WebServlet("/add")
public class AddServlet extends HttpServlet {
    // ... doGet 和 doPost 方法 ...
}

#### 2. 常见错误排查

  • 404 Not Found：通常是因为 INLINECODE1d4535b0 或 INLINECODE52529278 配置错误，或者 HTML 表单的 INLINECODE6c227845 路径写错了。请确保路径以 INLINECODE0a728ba6 开头，或者相对于当前页面的相对路径正确。
  • 405 Method Not Allowed：正如我们前面提到的，这意味着 Servlet 中没有对应的处理方法（例如表单用了 INLINECODEcb95b205，但 Servlet 只有 INLINECODE805fcf5a）。
  • NullPointerException：直接调用 INLINECODE15a1e8a2 时，如果用户没有提交该参数（INLINECODE1535b874 返回 INLINECODEb8526e29），程序就会崩溃。一定要先检查是否为 INLINECODE58a2ede1 或空字符串。

#### 3. 性能优化建议

  • 复用 Servlet 实例：Servlet 默认是单例多线程的。容器只会创建一个 Servlet 实例，多个请求会并发执行 INLINECODEd1807b1a 方法。因此，绝对不要在 Servlet 中使用实例变量来存储特定请求的数据（比如 INLINECODEc048881e），这会导致线程安全问题，即用户 A 看到了用户 B 的数据。请始终使用局部变量。
  • 使用 PrintWriter：对于简单的文本响应，PrintWriter 是最方便的。但如果你在构建复杂的 HTML 页面，频繁的字符串拼接会消耗性能。在实际项目中，我们通常会结合 JSP 或模板引擎（如 Thymeleaf、FreeMarker）来分离视图和逻辑，Servlet 仅负责处理数据和控制流转。

总结

在这篇文章中，我们深入探讨了如何在 Java Servlet 中处理 HTTP GET 和 POST 请求。我们学习了如何搭建环境、理解了 GET 与 POST 在数据可见性、安全性及用途上的本质区别，并通过一个完整的计算器案例，亲手实践了从 HTML 表单到 Servlet 逻辑的编写。

我们还进一步探讨了如何解决 POST 请求的中文乱码问题，了解了 @WebServlet 注解的便捷性，并强调了线程安全和异常处理的重要性。

虽然现在 Spring MVC 和 Spring Boot 已经大行其道，它们屏蔽了底层 Servlet 的许多细节，但理解 Servlet 是掌握 Java Web 开发的基石。当你理解了 INLINECODEbbc3aae5 和 INLINECODE0794244d 的本质，你再去学习 Spring 框架时，就会有“看山还是山”的通透感。

希望这篇文章能帮助你更好地构建 Web 应用。下一步，你可以尝试探索 Servlet 生命周期、Session 会话管理以及 Listener 监听器，继续你的 Java 进阶之旅。祝你编码愉快！

声明：本站所有文章，如无特殊说明或标注，均为本站原创发布。任何个人或组织，在未征得本站同意时，禁止复制、盗用、采集、发布本站内容到任何网站、书籍等各类媒体平台。如若本站内容侵犯了原著者的合法权益，可联系我们进行处理。如需转载，请注明文章出处豆丁博客和来源网址。https://shluqu.cn/28732.html
点赞
0.00 平均评分 (0% 分数) - 0 票

相关文章美国1G带宽/1T流量高速vps $17.99/年