状态代码概述
Web服务器响应浏览器或其他客户程序的请求时,其应答一般由以下几个部分组成:一个状态行,几个应答头,一个空行,内容文档。下面是一个最简单的应答:
HTTP/1.1 200 OK
Content-Type: text/plain
Hello World
状态行包含HTTP版本、状态代码、与状态代码对应的简短说明信息。在大多数情况下,除了Content-Type之外的所有应答头都是可选的。但Content-Type是必需的,它描述的是后面文档的MIME类型。虽然大多数应答都包含一个文档,但也有一些不包含,例如对HEAD请求的应答永远不会附带文档。有许多状态代码实际上用来标识一次失败的请求,这些应答也不包含文档(或只包含一个简短的错误信息说明)。
Servlet可以利用状态代码来实现许多功能。例如,可以把用户重定向到另一个网站;可以指示出后面的文档是图片、PDF文件或HTML文件;可以告诉用户必须提供密码才能访问文档;等等。这一部分我们将具体讨论各种状态代码的含义以及利用这些代码可以做些什么。
设置状态代码
如前所述,HTTP应答状态行包含HTTP版本、状态代码和对应的状态信息。由于状态信息直接和状态代码相关,而HTTP版本又由服务器确定,因此需要Servlet设置的只有一个状态代码。
Servlet设置状态代码一般使用HttpServletResponse的setStatus方法。setStatus方法的参数是一个整数(即状态代码),不过为了使得代码具有更好的可读性,可以用HttpServletResponse中定义的常量来避免直接使用整数。这些常量根据HTTP 1.1中的标准状态信息命名,所有的名字都加上了SC前缀(Status Code的缩写)并大写,同时把空格转换成了下划线。也就是说,与状态代码404对应的状态信息是“Not Found”,则HttpServletResponse中的对应常量名字为SC_NOT_FOUND。但有两个例外:和状态代码302对应的常量根据HTTP 1.0命名,而307没有对应的常量。
设置状态代码并非总是意味着不要再返回文档。例如,虽然大多数服务器返回404应答时会输出简单的“File Not Found”信息,但Servlet也可以定制这个应答。不过,定制应答时应当在通过PrintWriter发送任何内容之前先调用response.setStatus。
虽然设置状态代码一般使用的是response.setStauts(int)方法,但为了简单起见,HttpServletResponse为两种常见的情形提供了专用方法:sendError方法生成一个404应答,同时生成一个简短的HTML错误信息文档;sendRedirect方法生成一个302应答,同时在Location头中指示新文档的URL。
HTTP 1.1状态代码及其含义
下表显示了常见的HTTP 1.1状态代码以及它们对应的状态信息和含义。
应当谨慎地使用那些只有HTTP 1.1支持的状态代码,因为许多浏览器还只能够支持HTTP 1.0。如果你使用了HTTP 1.1特有的状态代码,最好能够检查一下请求的HTTP版本号(通过HttpServletRequest的getProtocol方法)。 状态代码 状态信息 含义
- 100 Continue 初始的请求已经接受,客户应当继续发送请求的其余部分。(HTTP 1.1新)
- 101 Switching Protocols 服务器将遵从客户的请求转换到另外一种协议(HTTP 1.1新)
- 200 OK 一切正常,对GET和POST请求的应答文档跟在后面。如果不用setStatus设置状态代码,Servlet默认使用202状态代码。
- 201 Created 服务器已经创建了文档,Location头给出了它的URL。
- 202 Accepted 已经接受请求,但处理尚未完成。
- 203 Non-Authoritative Information 文档已经正常地返回,但一些应答头可能不正确,因为使用的是文档的拷贝(HTTP 1.1新)。
- 204 No Content 没有新文档,浏览器应该继续显示原来的文档。如果用户定期地刷新页面,而Servlet可以确定用户文档足够新,这个状态代码是很有用的。
- 205 Reset Content 没有新的内容,但浏览器应该重置它所显示的内容。用来强制浏览器清除表单输入内容(HTTP 1.1新)。
- 206 Partial Content 客户发送了一个带有Range头的GET请求,服务器完成了它(HTTP 1.1新)。
- 300 Multiple Choices 客户请求的文档可以在多个位置找到,这些位置已经在返回的文档内列出。如果服务器要提出优先选择,则应该在Location应答头指明。
- 301 Moved Permanently 客户请求的文档在其他地方,新的URL在Location头中给出,浏览器应该自动地访问新的URL。
- 302 Found 类似于301,但新的URL应该被视为临时性的替代,而不是永久性的。注意,在HTTP1.0中对应的状态信息是“Moved Temporatily”,而HttpServletResponse中相应的常量是SC_MOVED_TEMPORARILY,而不是SC_FOUND。
出现该状态代码时,浏览器能够自动访问新的URL,因此它是一个很有用的状态代码。为此,Servlet提供了一个专用的方法,即sendRedirect。使用response.sendRedirect(url)比使用response.setStatus(response.SC_MOVED_TEMPORARILY)和response.setHeader("Location",url)更好。这是因为:
首先,代码更加简洁。
第二,使用sendRedirect,Servlet会自动构造一个包含新链接的页面(用于那些不能自动重定向的老式浏览器)。
最后,sendRedirect能够处理相对URL,自动把它们转换成绝对URL。
注意这个状态代码有时候可以和301替换使用。例如,如果浏览器错误地请求http://host/~user(缺少了后面的斜杠),有的服务器返回301,有的则返回302。
严格地说,我们只能假定只有当原来的请求是GET时浏览器才会自动重定向。请参见307。
- 303 See Other 类似于301/302,不同之处在于,如果原来的请求是POST,Location头指定的重定向目标文档应该通过GET提取(HTTP 1.1新)。
- 304 Not Modified 客户端有缓冲的文档并发出了一个条件性的请求(一般是提供If-Modified-Since头表示客户只想比指定日期更新的文档)。服务器告诉客户,原来缓冲的文档还可以继续使用。
- 305 Use Proxy 客户请求的文档应该通过Location头所指明的代理服务器提取(HTTP 1.1新)。
- 307 Temporary Redirect 和302(Found)相同。许多浏览器会错误地响应302应答进行重定向,即使原来的请求是POST,即使它实际上只能在POST请求的应答是303时才能重定向。由于这个原因,HTTP 1.1新增了307,以便更加清除地区分几个状态代码:当出现303应答时,浏览器可以跟随重定向的GET和POST请求;如果是307应答,则浏览器只能跟随对GET请求的重定向。
注意,HttpServletResponse中没有为该状态代码提供相应的常量。(HTTP 1.1新)
- 400 Bad Request 请求出现语法错误。
- 401 Unauthorized 客户试图未经授权访问受密码保护的页面。应答中会包含一个WWW-Authenticate头,浏览器据此显示用户名字/密码对话框,然后在填写合适的Authorization头后再次发出请求。
- 403 Forbidden 资源不可用。服务器理解客户的请求,但拒绝处理它。通常由于服务器上文件或目录的权限设置导致。
- 404 Not Found 无法找到指定位置的资源。这也是一个常用的应答,HttpServletResponse专门提供了相应的方法:sendError(message)。
- 405 Method Not Allowed 请求方法(GET、POST、HEAD、DELETE、PUT、TRACE等)对指定的资源不适用。(HTTP 1.1新)
- 406 Not Acceptable 指定的资源已经找到,但它的MIME类型和客户在Accpet头中所指定的不兼容(HTTP 1.1新)。
- 407 Proxy Authentication Required 类似于401,表示客户必须先经过代理服务器的授权。(HTTP 1.1新)
- 408 Request Timeout 在服务器许可的等待时间内,客户一直没有发出任何请求。客户可以在以后重复同一请求。(HTTP 1.1新)
- 409 Conflict 通常和PUT请求有关。由于请求和资源的当前状态相冲突,因此请求不能成功。(HTTP 1.1新)
- 410 Gone 所请求的文档已经不再可用,而且服务器不知道应该重定向到哪一个地址。它和404的不同在于,返回407表示文档永久地离开了指定的位置,而404表示由于未知的原因文档不可用。(HTTP 1.1新)
- 411 Length Required 服务器不能处理请求,除非客户发送一个Content-Length头。(HTTP 1.1新)
- 412 Precondition Failed 请求头中指定的一些前提条件失败(HTTP 1.1新)。
- 413 Request Entity Too Large 目标文档的大小超过服务器当前愿意处理的大小。如果服务器认为自己能够稍后再处理该请求,则应该提供一个Retry-After头(HTTP 1.1新)。
- 414 Request URI Too Long URI太长(HTTP 1.1新)。
- 416 Requested Range Not Satisfiable 服务器不能满足客户在请求中指定的Range头。(HTTP 1.1新)
- 500 Internal Server Error 服务器遇到了意料不到的情况,不能完成客户的请求。
- 501 Not Implemented 服务器不支持实现请求所需要的功能。例如,客户发出了一个服务器不支持的PUT请求。
- 502 Bad Gateway 服务器作为网关或者代理时,为了完成请求访问下一个服务器,但该服务器返回了非法的应答。
- 503 Service Unavailable 服务器由于维护或者负载过重未能应答。例如,Servlet可能在数据库连接池已满的情况下返回503。服务器返回503时可以提供一个Retry-After头。
- 504 Gateway Timeout 由作为代理或网关的服务器使用,表示不能及时地从远程服务器获得应答。(HTTP 1.1新)
- 505 HTTP Version Not Supported 服务器不支持请求中所指明的HTTP版本。(HTTP 1.1新)
原文地址:
http://www.cnblogs.com/meil/archive/2007/03/06/665829.html
分享到:
相关推荐
在这一过程中,HTTP应答码扮演着至关重要的角色,它不仅告知客户端请求的状态,还帮助开发者快速定位问题所在。下面将详细解读HTTP应答码的各类状态及其含义。 #### 1XX:信息性状态码(Information) 这类状态码...
本文将详细介绍SIP中的各种应答状态码及其功能。 #### 二、临时应答(1XX) 临时应答用于通知客户端请求已被接收并正在处理中,但尚未得到最终结果。这些响应是非可靠的,即客户端不需要通过 ACK 来确认接收到临时...
7.1 状态代码概述 Web服务器响应浏览器或其他客户程序的请求时,其应答一般由以下几个部分组成:一个状态行,几个应答头,一个空行,内容文档。下面是一个最简单的应答: ...
- 检查PL2303 USB转串口芯片的工作状态:确保TXD端为高电平且DM端有明显的高低电平变化。 - 验证Q1和Q2两个三极管的脚位是否正确,尤其是对于PNP类型的8550晶体管,其B、E、C引脚的位置可能有所不同。 - 确认BOOT...
无源应答器主要用于提供线路的固定信息,如线路坡度、最大速度限制等,通常处于待机状态,只有在接收到能量时才工作。 有源应答器则通过电缆与地面电子单元(LEU)相连,能够实时发送LEU提供的可变数据报文。例如,...
针对复杂道岔区,提供详细的道岔状态和限速信息,确保列车安全通过。 #### 10. 其它应答器组设置 包括GSM-R网络注册应答器组、长短链应答器组等,服务于通信网络注册、线路长度调整等功能。 ### 三、应答器图纸...
SIP 协议应答码是其通信过程中用来指示请求处理状态的关键部分,它沿袭并扩展了 HTTP/1.1 的应答码体系,同时也新增了一些特有的应答码。 1. **临时应答 (1xx)** - 1xx 应答码表示服务器正在处理请求,但尚未做出...
这些信息涵盖了线路基础数据、速度限制、临时限速、道岔状态、特殊操作指令等,这些都是确保列车安全、高效运行的重要数据。 应答器的设计和布局需要综合考虑多个因素,其中包括车载天线的辐射特性、列车的移动速度...
6. **错误处理和状态通知**:TAPI提供了丰富的错误处理机制和事件通知,使开发者能及时响应各种情况,如通话断开、网络问题等。 描述中提到的“收号”是指接收用户通过电话按键(DTMF)输入的数字。这是IVR系统中...
无源应答器则不需要外接电源,处于休眠状态,直到列车经过时被激活,并发送调制好的数据编码信息。这种应答器安装在轨道中间,当列车接近时,车载查询器天线会向无源应答器发送功率载波能量,激活应答器,使其发送已...
HTTP 返回状态码表 HTTP 返回状态码是 Hypertext Transfer Protocol(超文本传输协议)中的一种机制,用于表示服务器对客户端请求的响应结果。状态码是三位数字,第一个数字定义了响应的类别,后两个数字定义了响应...
SIP 应答码的设计扩展了 HTTP/1.1 的应答码,但不是所有 HTTP 应答码都适用于 SIP。例如,SIP 定义了特有的 1xx 和 6xx 系列应答码。此外,某些应答码如 100 Trying 不会导致 ACK 应答,而成功应答如 200 OK 则表明...
《H248协议附加业务——无应答前转详解》 H248协议,全称为 Megaco/H.248,是电信领域中广泛使用的媒体网关控制协议,用于控制媒体网关(MG)与媒体网关控制器(MGC)之间的交互。该协议在IP电话、VoIP及三网融合等...
2. 确认下机:在用户离开电脑后,系统能自动检测到空闲状态,并自动确认下机,释放资源供其他用户使用。这样既节省了网管的时间,也提高了设备利用率。 二、实现原理 “美萍网管大师自动应答”的实现主要依赖于...
SIP应答码是SIP协议中的一部分,用于表示请求的结果或状态。本文将详细介绍SIP应答码,包括1xx、2xx、3xx、4xx、5xx和6xx系列应答码的定义和使用场景。 1xx临时应答 1xx系列应答码用于表示服务器正在处理请求,但...
应答机的设置包含了识别代码(Mode A code)和飞行状态代码(Mode C code)。 4. 情报区(Flight Information Region,FIR)和管制区(Controlled Airspace):情报区是指提供航空情报服务的空域。管制区则是指在该...
* 100(Trying)应答和其他临时应答不同的是,在这里,它永远不会被有状态 proxy 转发到上行流中。 1.2 180 Ringing * UA 收到 INVITE 请求并且试图提示给用户。 * 这个应答应当出世化一个本地回铃。 1.3 181 Call ...
5. **应答解析**:SMTP服务器对每个命令都会返回一个应答代码,程序需要解析这些应答,判断操作是否成功,如`数据到达`和`上线事件`可能指的是邮件发送或接收过程中的状态变化。 6. **错误处理**:遇到错误时,如4...