Servlet的HTTP状态码

Posted Jim

tags:

篇首语：本文由小常识网(cha138.com)小编为大家整理，主要介绍了Servlet的HTTP状态码相关的知识，希望对你有一定的参考价值。

以下内容引用自http://wiki.jikexueyuan.com/project/servlet/http-status-codes.html：

HTTP请求的格式和HTTP响应消息的格式是相似的且都有如下所示结构：

  • 一个初始状态行 + CRLF(回车 + 换行 即新行)

  • 零个或多个标题行 + CRLF

  • 一个空白行，即一个 CRLF

  • 一个可选的消息主体，如文件、查询数据或查询输出

例如，服务器的响应头信息看起来如下所示：

HTTP/1.1 200 OK
Content-Type: text/html
Header2: ...
...
HeaderN: ...
  (Blank Line)
<!doctype ...>
<html>
<head>...</head>
<body>
...
</body>
</html>

状态行包括HTTP版本（例子中的HTTP/1.1）、一个状态码（例子中的200）和一个对应于状态码的短消息（例子中的OK）。

以下HTTP状态码以及可能从Web服务器返回的相关的消息的列表：

代码：消息：描述：
100 Continue 只有请求的一部分已经被服务器接收，但只要它没有被拒绝，客户端应继续该请求。
101 Switching Protocols 服务器切换协议。
200 OK 请求成功。
201 Created 该请求是完整的，并创建一个新的资源。
202 Accepted 该请求被接受处理，但是该处理是不完整的。
203 Non-authoritative Information  
204 No Content  
205 Reset Content  
206 Partial Content  
300 Multiple Choices 链接列表。用户可以选择一个链接，进入到该位置。最多五个地址
301 Moved Permanently 所请求的页面已经转移到一个新的URL。
302 Found 所请求的页面已经临时转移到一个新的URL。
303 See Other 所请求的页面可以在另一个不同的URL下被找到。
304 Not Modified  
305 Use Proxy  
306 Unused 在以前的版本中使用该代码。现在已不再使用它，但代码仍被保留。
307 Temporary Redirect 所请求的页面已经临时转移到一个新的URL。
400 Bad Request 服务器不理解请求。
401 Unauthorized 所请求的页面需要用户名和密码。
402 Payment Required 还不能使用该代码。
403 Forbidden 禁止访问所请求的页面。
404 Not Found 服务器无法找到所请求的页面。
405 Method Not Allowed 在请求中指定的方法是不允许的。
406 Not Acceptable 服务器只生成一个不被客户端接受的响应。
407 Proxy Authentication Required 在请求送达之前，您必须使用代理服务器的验证。
408 Request Timeout 请求需要的时间比服务器能够等待的时间长，超时。
409 Conflict 请求因为冲突无法完成。
410 Gone 所请求的页面不再可用。
411 Length Required "Content-Length"未定义。服务器无法处理客户端发送的不带Content-Length的请求信息。
412 Precondition Failed 请求中给出的先决条件被服务器评估为false。
413 Request Entity Too Large 服务器不接受该请求，因为请求实体过大。
414 Request-url Too Long 服务器不接受该请求，因为URL太长。当转换一个“post”请求为一个带有长的查询信息的“get”请求时发生。
415 Unsupported Media Type 服务器不接受该请求，因为媒体类型不被支持。
417 Expectation Failed  
500 Internal Server Error 未完成的请求。服务器遇到了一个意外的情况。
501 Not Implemented 未完成的请求。服务器不支持所需的功能。
502 Bad Gateway 未完成的请求。服务器从上游服务器收到无效响应。
503 Service Unavailable 未完成的请求。服务器暂时超载或死机。
504 Gateway Timeout 网关超时。
505 HTTP Version Not Supported 服务器不支持“HTTP协议”版本。

一、设置HTTP状态码的方法：

下面是在Servlet程序中可以用于设置HTTP状态码的方法。通过HttpServletResponse对象这些方法是可用的。

方法描述

public void setStatus(int statusCode)

该方法设置一个任意的状态码。setStatus方法接受一个int（状态码）作为参数。如果您的反应包含了一个特殊的状态码和文档，请确保在使用PrintWriter实际返回任何内容之前调用setStatus。

public void sendRedirect(String url)

该方法生成一个302响应，连同一个带有新文档URL的Location头。

public void sendError(int code, String message)

该方法发送一个状态码（通常为404），连同一个在HTML文档内部自动格式化并发送到客户端的短消息。

二、HTTP状态码实例：

下述例子将发送407错误代码到客户端浏览器，且浏览器会显示“需要身份验证！！！”的消息。

// Import required java libraries
import java.io.*;
import javax.servlet.*;
import javax.servlet.http.*;
import java.util.*;
// Extend HttpServlet class
public class ShowError extends HttpServlet { 
  // Method to handle GET method request.
  public void doGet(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException
  {
      // Set error code and reason.
      response.sendError(407, "Need authentication!!!" );
  }
  // Method to handle POST method request.
  public void doPost(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException {
     doGet(request, response);
  }
}

配置web.xml：

    <servlet>
        <servlet-name>ShowError</servlet-name>
        <servlet-class>com.jsoft.testservletbasics.ShowError</servlet-class>
    </servlet>
    <servlet-mapping>
        <servlet-name>ShowError</servlet-name>
        <url-pattern>/ShowError</url-pattern>
    </servlet-mapping>

 

现在调用上述 servlet 会显示如下所示结果：

 

测试工程：https://github.com/easonjim/5_java_example/tree/master/servletbasics/test5

以上是关于Servlet的HTTP状态码的主要内容，如果未能解决你的问题，请参考以下文章

HTTP状态码webview android, WebViewClient

Servlet 之请求，响应，缓存以及乱码

Spring MockMvc 和异步控制器的 HTTP 状态码

http状态码

HTTP状态码大全

JavaWeb chapter3 Servlet处理HTTP响应