Servlet HTTP 状态码
关键要点
- HTTP 状态码是服务器对客户端请求的响应状态代码，分为 1xx（信息）、2xx（成功）、3xx（重定向）、4xx（客户端错误）和 5xx（服务器错误）五大类。
- 在 Servlet 中，通过
HttpServletResponse对象设置状态码，如setStatus()、sendError()和sendRedirect()。 - 研究表明，常见状态码包括 200 OK、404 Not Found 和 500 Internal Server Error，需在写入响应前设置。
HTTP 状态码概述
HTTP 状态码由三个数字组成，用于表示服务器对 HTTP 请求的处理结果。前一位数字定义类别，后两位无分类作用。在 Servlet 中，状态码通过 HttpServletResponse 对象设置，确保客户端了解请求结果。
在 Servlet 中的使用
Servlet 使用以下方法设置状态码：
setStatus(int sc)：设置状态码，如response.setStatus(HttpServletResponse.SC_OK)。sendError(int sc, String msg)：发送错误响应，如response.sendError(HttpServletResponse.SC_NOT_FOUND, "资源未找到")。sendRedirect(String location)：重定向，如response.sendRedirect("newURI")，默认状态码为 302。
处理中文字符
为避免乱码，需设置响应编码为 UTF-8，例如 response.setContentType("text/html;charset=UTF-8")。
详细报告
背景与定义
HTTP 状态码是 HTTP 协议的一部分，用于表示服务器对客户端请求的响应状态。它们由三个数字组成，前一位数字定义状态码的类别，后两位数字没有分类作用。状态码分为五类：1xx（信息性状态码）、2xx（成功状态码）、3xx（重定向状态码）、4xx（客户端错误状态码）和 5xx（服务器错误状态码）。
在 Servlet 中，HTTP 状态码通过 HttpServletResponse 对象来设置，用于向客户端返回请求处理的结果。HttpServletResponse 是 Servlet API 中的核心接口，扩展了 ServletResponse 接口，提供 HTTP 特定的响应功能。
HTTP 状态码分类与常见示例
以下是 HTTP 状态码的分类及常见示例，基于多个权威中文技术资料的总结（如 “菜鸟教程”、”CSDN 博客”和 “MDN Web Docs”）：
| 类别 | 描述 | 常见状态码 | 含义 |
|---|---|---|---|
| 1xx | 信息性状态码 | 100 | Continue – 服务器已接收请求头，客户端可继续发送请求体。 |
| 2xx | 成功状态码 | 200 | OK – 请求成功，服务器返回数据。 |
| 201 | Created – 请求成功，并创建新资源。 | ||
| 3xx | 重定向状态码 | 301 | Moved Permanently – 资源永久移动。 |
| 302 | Found – 资源临时移动。 | ||
| 4xx | 客户端错误状态码 | 404 | Not Found – 服务器无法找到请求资源。 |
| 403 | Forbidden – 服务器拒绝授权。 | ||
| 5xx | 服务器错误状态码 | 500 | Internal Server Error – 服务器内部错误。 |
| 503 | Service Unavailable – 服务器当前不可用。 |
这些状态码的定义基于 RFC 2616 等规范，并由互联网号码分配局（IANA）维护。
在 Servlet 中设置 HTTP 状态码
Servlet 提供以下方法通过 HttpServletResponse 对象设置 HTTP 状态码：
setStatus(int sc)：
- 功能：设置响应的状态码。
- 示例：
java response.setStatus(HttpServletResponse.SC_OK); // 设置状态码为 200 - 使用场景：用于设置普通成功响应或自定义状态码。
sendError(int sc, String msg)：
- 功能：发送错误响应，包含指定的状态码和错误消息，并清空缓冲区。
- 示例：
java response.sendError(HttpServletResponse.SC_NOT_FOUND, "资源未找到"); // 设置状态码为 404 - 使用场景：用于发送客户端错误（如 404）或服务器错误（如 500），浏览器通常会显示错误页面。
sendRedirect(String location)：
- 功能：发送重定向响应，默认状态码为 302（Found），也可通过
setStatus()设置为 301（Moved Permanently）。 - 示例：
java response.sendRedirect("newURI"); // 重定向到新位置 - 使用场景：用于资源临时或永久重定向。
注意事项：
- 设置状态码时，应在向响应体写入任何内容之前调用这些方法，尤其是
sendError()，因为它会清空缓冲区。 - 研究表明，状态码设置后，客户端会根据状态码执行相应操作，如浏览器显示错误页面或自动跳转。
处理中文字符
在设置 HTTP 状态码时，若响应包含中文字符，需确保字符编码正确，以避免乱码。推荐做法是：
- 设置响应内容类型和字符编码：
response.setContentType("text/html;charset=UTF-8");- 示例代码：
protected void doGet(HttpServletRequest request, HttpServletResponse response)
throws ServletException, IOException {
response.setContentType("text/html;charset=UTF-8");
response.setStatus(HttpServletResponse.SC_NOT_FOUND);
PrintWriter out = response.getWriter();
out.println("<html><body>");
out.println("<h1>404 资源未找到</h1>");
out.println("<p>请求的资源未找到。</p>");
out.println("</body></html>");
out.close();
}技术细节与扩展
- 线程安全：Servlet 是单实例多线程的，
doGet()和doPost()方法在多线程环境下执行，需确保实例变量线程安全。 - 异常处理：在设置状态码时，需捕获可能的
IOException，并适当处理。 - 性能优化：尽量在设置状态码后一次性写入响应体，以减少 I/O 操作。
- HTTP 头示例：常见的响应头包括 Content-Type、Content-Length、Cache-Control 等，状态码通常与响应头一起发送。
对比与争议
关于状态码的使用，不同资料的建议略有差异。部分资料（如 Runoob）强调 sendError() 用于错误处理，而 W3cschool 更推荐 setStatus() 用于自定义状态码。研究表明，sendError() 更适合标准错误（如 404、500），而 setStatus() 适用于自定义场景，但需注意浏览器对状态码的解释可能不同。
总结与实践建议
HTTP 状态码是 Servlet 中处理 HTTP 响应的重要组成部分，通过 HttpServletResponse 对象设置，确保客户端了解请求结果。常见状态码包括 200 OK、404 Not Found 和 500 Internal Server Error。处理中文字符时，需设置 UTF-8 编码以避免乱码。
建议在开发中：
- 始终在写入响应前设置状态码。
- 测试不同状态码（如 200、404、500），确保客户端响应正确。
- 关注线程安全和性能优化，确保应用程序稳定运行。
参考资料：