山西百度网站建设百度知道网页入口
一、核心作用对比
对象 | HttpServletRequest (请求对象) | HttpServletResponse (响应对象) |
---|---|---|
本质 | 客户端发给服务器的 HTTP 请求信息(输入) | 服务器返回客户端的 HTTP 响应信息(输出) |
生命周期 | 一次 HTTP 请求中创建,请求处理完成后销毁 | 同左 |
获取方式 | 由 Servlet 容器自动注入(如 doGet(request, response) ) | 同左 |
核心功能 | 读取请求参数、头信息、会话数据等 | 设置响应状态、头信息、返回内容等 |
二、关键方法与示例
(一)HttpServletRequest - 请求信息读取器
(一)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}
}
总结
HttpServletRequest
:客户端 → 服务器的信息桥梁,用于读取请求数据。HttpServletResponse
:服务器 → 客户端的信息出口,用于构造响应。- 核心技巧:在传统 Servlet 开发中直接使用它们,在 Spring 开发中优先通过注解简化操作,必要时才直接操作原生对象。