当前位置：首页 > news >正文

HttpServletRequest 和 HttpServletResponse 区别和作用

news 来源：原创 2025/6/19 7:16:13

一、核心作用对比

对象	`HttpServletRequest`（请求对象）	`HttpServletResponse`（响应对象）
本质	客户端发给服务器的 HTTP 请求信息（输入）	服务器返回客户端的 HTTP 响应信息（输出）
生命周期	一次 HTTP 请求中创建，请求处理完成后销毁	同左
获取方式	由 Servlet 容器自动注入（如 `doGet(request, response)`）	同左
核心功能	读取请求参数、头信息、会话数据等	设置响应状态、头信息、返回内容等

二、关键方法与示例

（一）HttpServletRequest - 请求信息读取器

主要方法及使用场景：

方法	作用	示例场景
`String getParameter(String name)`	获取 `URL参数` 或 `表单参数`	用户注册表单的 `username` 字段
`Enumeration<String> getParameterNames()`	获取所有请求参数名	调试时打印全部参数
`String[] getParameterValues(String name)`	获取同名参数的多个值（复选框等）	多选的兴趣爱好
`String getHeader(String name)`	获取请求头信息	获取设备类型 `User-Agent`
`Cookie[] getCookies()`	获取客户端的 Cookies	自动登录功能
`HttpSession getSession()`	获取或创建会话对象	保存用户登录状态
`String getRequestURI()`	获取请求路径（不包含协议和域名）	记录请求日志
`StringBuffer getRequestURL()`	获取完整请求 URL	生成重定向地址

代码示例 - 传统 Servlet 中读取请求参数：

protected void doGet(HttpServletRequest request, HttpServletResponse response) {
    // 获取单个参数
    String username = request.getParameter("username");
    
    // 获取多选参数
    String[] hobbies = request.getParameterValues("hobby");
    
    // 获取请求头
    String userAgent = request.getHeader("User-Agent");
    
    // 获取所有参数名（调试用）
    Enumeration<String> params = request.getParameterNames();
    while (params.hasMoreElements()) {
        String paramName = params.nextElement();
        System.out.println(paramName);
    }
}

（二）HttpServletResponse - 响应信息控制器

主要方法及使用场景：

方法	作用	示例场景
`void setStatus(int sc)`	设置 HTTP 状态码	返回错误码 404
`void sendError(int sc, String msg)`	发送错误状态码及描述信息	参数校验失败时返回 400
`void setHeader(String name, String value)`	设置响应头信息	跨域支持（CORS）
`void addCookie(Cookie cookie)`	添加 Cookie	记住用户语言偏好
`PrintWriter getWriter()`	获取文本输出流	返回 JSON/HTML 内容
`ServletOutputStream getOutputStream()`	获取二进制输出流	返回图片/文件下载
`void sendRedirect(String location)`	重定向到新 URL	登录成功后跳转首页
`void setContentType(String type)`	设置内容类型（MIME 类型）	`application/json` 或 `image/png`

代码示例 - 自定义响应头和返回二进制内容：

protected void doGet(HttpServletRequest request, HttpServletResponse response) {
    // 设置响应类型为图片
    response.setContentType("image/png");
    
    // 设置缓存头（缓存1小时）
    response.setHeader("Cache-Control", "max-age=3600");
    
    // 返回二维码图片字节流
    try (OutputStream out = response.getOutputStream()) {
        byte[] qrCode = generateQRCode("https://example.com");
        out.write(qrCode);
    } catch (IOException e) {
        response.sendError(500, "生成二维码失败");
    }
}

三、Spring MVC 中的实际应用

示例 1：RESTful API 参数接收

@RestController
@RequestMapping("/api")
public class UserApiController {
    
    // 获取查询参数和请求头
    @GetMapping("/user")
    public ResponseEntity<User> getUser(
            @RequestParam("id") Long userId,
            @RequestHeader("Authorization") String token) {
        
        // 验证Token逻辑
        if (!validateToken(token)) {
            return ResponseEntity.status(401).build();
        }
        
        User user = userService.findById(userId);
        return ResponseEntity.ok(user);
    }
}

示例 2：文件上传与重定向

@Controller
public class FileUploadController {
    
    @PostMapping("/upload")
    public String uploadFile(
            @RequestParam("file") MultipartFile file,
            HttpServletRequest request,
            HttpServletResponse response) throws IOException {
        
        // 检查文件大小
        if (file.getSize() > 10_000_000) { 
            response.setStatus(HttpServletResponse.SC_BAD_REQUEST);
            return "error/400"; 
        }
        
        fileService.save(file);
        // 重定向到结果页
        response.sendRedirect("/upload-success");
        return null;
    }
}

四、关键差异总结

对比维度	`HttpServletRequest`	`HttpServletResponse`
数据流向	服务器接收客户端数据	服务器向客户端发送数据
操作方法	信息读取类方法（getXxx）	数据写入类方法（setXxx/sendXxx）
内容处理	解析请求 URL、参数、头信息	设置响应状态、头信息、写入正文内容
生命周期	请求到达时创建，响应结束后销毁	同左

五、常见问题解答

问题 1：为何要同时使用这两个对象？

在一个完整的 HTTP 交互中：

HttpServletRequest: 了解客户端的请求细节（要什么）
HttpServletResponse: 构建服务器返回的响应（给什么）

协作流程示例：

protected void doPost(HttpServletRequest request, HttpServletResponse response) {
    // 1. 通过request获取数据
    String input = request.getParameter("input");

    // 2. 业务处理
    String result = process(input);

    // 3. 通过response返回结果
    response.setContentType("text/plain");
    response.getWriter().write(result);
}

问题 2：如何在 Spring 中优雅地使用它们？

最佳实践原则：优先使用 Spring 的抽象方式（如 @RequestParam、@ResponseBody），必要时再直接操作原生对象。

@RestController
public class ModernController {
    // 通过注解自动映射参数
    @GetMapping("/search")
    public List<Product> searchProducts(
            @RequestParam String keyword,  // 自动从请求参数获取
            @CookieValue("sessionId") String sessionId,
            HttpServletResponse response) { // 需要设置Cookie时使用
        
        response.addCookie(new Cookie("lastSearch", keyword));
        return productService.search(keyword); // 自动转JSON
    }
}