doPost()方法具有什么功能呢?

doPost()方法简介

`doPost()`是`HttpServlet`类中一个受保护方法
  用于处理客户端发送HTTP POST请求
  它是Servlet开发中另一个最常用方法
  适用于提交数据、执行操作、修改服务器状态等场景。

`doPost()`方法功能

`doPost()`方法调用流程

当用户提交一个表单
  或
   前端通过AJAX发送POST 请求时
     Web 容器会自动调用对应`doPost()`方法
 
浏览器发起 POST请求→ 
    Web容器定位到对应Servlet→
	调用service()→
	 分发到doPost()

`doPost()`方法定义

protected void doPost(HttpServletRequest request, HttpServletResponse response)
        throws ServletException, IOException {
    // 处理 POST 请求的逻辑
}

- `HttpServletRequest`：封装了客户端请求的信息（如参数、请求体等）
- `HttpServletResponse`：用于向客户端返回响应内容（如重定向、JSON 数据等）

1. 接收 HTML 表单提交

 HTML 表单示例：
 
<form action="login" method="post">
    用户名：<input type="text" name="username"><br>
    密码：<input type="password" name="password"><br>
    <input type="submit" value="登录">
</form>

对应Servlet：
 
@WebServlet("/login")
public class LoginServlet extends HttpServlet {

    @Override
    protected void doPost(HttpServletRequest request, HttpServletResponse response)
            throws IOException {

        // 设置字符编码（防止中文乱码）
        request.setCharacterEncoding("UTF-8");

        // 获取表单参数
        String username = request.getParameter("username");
        String password = request.getParameter("password");

        // 简单验证逻辑
        if ("admin".equals(username) && "123456".equals(password)) {
            // 登录成功，重定向到主页
            response.sendRedirect("home");
        } else {
            // 登录失败，返回错误信息
            response.setContentType("text/html");
            PrintWriter out = response.getWriter();
            out.println("<h1>登录失败，请检查用户名或密码</h1>");
        }
    }
}
 
 2.接收 JSON 数据（构建 API）
 
@WebServlet("/api/user")
public class UserApiServlet extends HttpServlet {

    @Override
    protected void doPost(HttpServletRequest request, HttpServletResponse response)
            throws IOException {

        // 读取请求体中的 JSON 数据
        BufferedReader reader = request.getReader();
        StringBuilder json = new StringBuilder();
        String line;
        while ((line = reader.readLine()) != null) {
            json.append(line);
        }

        // 输出接收到的 JSON（实际开发中可解析为对象）
        System.out.println("Received JSON: " + json.toString());

        // 返回响应
        response.setContentType("application/json");
        PrintWriter out = response.getWriter();
        out.println("{\"status\":\"success\",\"message\":\"Data received\"}");
    }
}

doPost使用注意事项

 设置字符编码
  使用`request.setCharacterEncoding("UTF-8")`防止乱码
   不要重复提交响应
   当调用`getWriter()` 
     或 
	`getOutputStream()`
	无需再调用 `sendRedirect()`  
    不适合缓存或书签
 	POST 请求默认不缓存，也不能收藏为书签 
    适合修改服务器状态
	如新增、更新、删除操作 

doPost适用场景

 
 用户登录/注册
  接收表单提交的用户名和密码 
  文件上传
  使用 `Part` 
    或 
   Apache Commons FileUpload 解析 multipart 数据 
  构建 RESTful API
    接收 JSON/XML 数据并返回处理结果 |
 提交订单 
    向服务器发送订单信息 
 修改数据
    如更新用户资料、配置信息等