深入Jetty源码之HTTP协议

请求消息

POST /index.jsp?articleId=1234&articleName=GoodArticle HTTP/1.1
Host: www.blogjava.com
Content-Length: 74
Content-Type: application/x-www-form-urlencoded
myText1=hello+world&myText2=%E4%BD%A0%E5%A5%BD%E4%B8%96%E7%95%8C

请求方法：

HTTP1.1定义的请求方法有

OPTIONS：
请求查询服务器的性能，或查询与资源相关的选项和需求。

GET：
请求获取Request-URI所标识的资源。

HEAD：
请求获取由Request-URI所标识的资源的响应消息报头。

POST：
在Request-URI所标识的资源后附加新的数据。

PUT：
请求服务器存储一个资源，并用Request-URI作为其标识。

DELETE：
请求服务器删除Request-URI所标识的资源。

TRACE：
请求服务器会送收到的请求信息，主要用于测试或诊断。

CONNECT：
保留将来使用。

扩展的方法：
用户自定义扩展方法。

如果Server能识别某个请求方法但是不允许该请求方法，则应该返回405（Method Not Allowed）响应状态。如果Server无法识别某个请求方法或者当前Server没有实现这个请求方法，则应该返回501（Not Implemented）状态码。

Request－URI支持的值有：＊｜absoluteURI｜abs_path｜authority

1. ＊表示请求不应用于某个特定的资源，并且只对于某些不需要应用于特定资源的请求方法，如：OPTIONS * HTTP/1.1
2. absoluteURI：当客户端是向一个代理发送请求时需要使用absoluteURI，然后这个代理会转发这个请求，并返回响应。虽然按规范，HTTP1.1客户端只发送absoluteURI到代理服务器，但是为了在将来的HTTP版本中可以允许请求都转换成absoluteURI，所有HTTP1.1 Server必须可以解析absoluteURI风格的请求：GET http://www.w3.org/pub/WWW/TheProject.html HTTP/1.1
3. authority只在CONNECT请求方法中使用。
4. abs_path：用于表示Server的资源，而Server本身的信息在Host消息头中表示：

   GET /put/www/TheProject.html HTTP/1.1

   Host: www.w3.org

Resource Identification rules：

1. 如果Request－URI是absoluteURI，并且这个absolute的host和server的host相同，则忽略Host头。
2. 如果Request－URI不是absoluteURI，并且请求消息包含Host头，host由Host消息头决定。
3. 如果1或2中的host不是一个合法的host，则返回400（Bad Request）响应消息。

响应消息

HTTP/1.1 200 OK                                              //请求成功
Server: Microsoft-IIS/5.0                                    //web服务器
Date: Thu,08 Mar 200707:17:51 GMT
Connection: Keep-Alive                                 
Content-Length: 23330
Content-Type: text/html
Expries: Thu,08 Mar 2007 07:16:51 GMT
Set-COOKIE: ASPSESSIOnIDQAQBQQQB=BEJCDGKADEDJKLKKAJEOIMMH; path=/
Cache-control: private

杂记

消息报头详解

通用消息头：

Cache-Control: 

Connection:
客户端通过发送包含close值的Connection头，表达在这次请求结束后，Server可以关闭这个连接，此时Server如果选择发送响应后关闭连接，则在响应消息中需要包含值为close的Connection头。 

Date: 

Pragma: 

Trailer: 

Transfer-Encoding: 

Upgrade: 

Via: 

Warning: 

请求消息头：

请求消息头允许客户端传递一些额外关乎客户端信息给Server，这些字段类似在方法调用中的参数。

Accept: 

Accept-Charset: 

Accept-Encoding: 

Accept-Language: 

Authorization: 

Expect:
客户端发送一个包含100-continue值的Expect字段头，以在不发送真正消息实体的情况下测试服务器是否能接收这个消息。此时Server响应417（Expectation Failed）或100（Continue），然后客户端决定是否要继续发送请求消息体。

From: 

Host: 

If-Match: 

If-Modified-Since: 

If-None-Match: 

If-Range: 

If-Unmodified-Since: 

Max-Forwards: 

Proxy-Authorization: 

Range: 

Referer: 

TE: 

User-Agent: 

响应消息头

响应消息头允许Server传递一些关于响应的额外信息给客户端。

Accept-Ranges: 

Age: 

ETag: 

Location: 

Proxy-Authenticate: 

Retry-After: 

Server: 

Vary:

WWW-Authenticate: 

实体消息头

实体消息头属于实体的一部分，是实体的元数据。

Allow: 

Content-Encoding: 

Content-Language: 

Content-Length: 

Content-Location: 

Content-MD5: 

Content-Range: 

Content-Type: 

Expires: 

Last-Modified: 

响应状态码详解

1xx: Informational - Request received, continuing process

1. 100 - Continue
   
   客户端应该继续它的请求，这个暂时的响应用于通知客户端初始的请求已经被服务器接受，并且暂时没有被拒绝。此时客户端会继续发送剩余的请求，或者当所有请求已经发送完成时忽略该响应码。服务器必须在请求结束时发送一个最终的响应。
2. 101 - Switching Protocols
   
   服务器理解并打算执行客户端的请求，并且使用“Upgrade”字段头用户表示服务器会在这个连接中的协议升级到“Upgrade”头标识的版本号。

2xx: Success - The action was successfully received, understood, and accepted

1. 200 - OK
   
   请求成功处理。
2. 201 - Created
   
   请求成功处理并且新的资源被创建。新创建的资源可以使用URI标识，并且该URI在响应消息的Location头中。服务器在返回201响应时必须保证新的资源已经被创建，如果服务器在返回响应时还没来得及创建新的资源，服务器应该返回202（Accepted）响应。
   201响应还可以包含“ETag”响应头，表示实体标签的当前值。
3. 202 - Accepted
   
   请求被接受并处理，但是处理还未完成。这个请求不一定被成功执行，并且也不会在有结果后重新异步发送响应消息。该响应状态主要用于一些类似batch的操作，当客户发送请求以后，不需要继续保持和服务器的连接。返回的消息实体需要包含请求当前的状态以及一个指向状态监视器或客户能得到结果的估计值。
4. 203 - Non-Authoritative Information
   
   响应消息实体头部返回的元信息不是在原始服务器有效的集合，而是从本地或第三方中拷贝收集。当前的集合可能是原始集合的子集或超集，这个响应码不是必须的，可以使用200（OK）替代。
5. 204 - No Content
   
   服务器已经成功的完成请求，该请求没有消息实体，只是返回一些最新的元信息。
6. 205 - Reset Content
   
   服务器已经成功的完成请求，客户端必须重置由该请求引起的文档视图。该响应主要用于清除用于之前输入的表单。该响应不可以包含消息实体。
7. 206 - Partial Content
   
   服务器已经成功完成“Partial GET”的请求。该响应的请求必须包含“Range”头，以及可选的“If-Range”头。响应必须包含以下头：Content-Range（或值为multipart/byteranges的Content-Type头）、Date、ETag或Content-Location、Expires、Cache-Control、Vary等。

3xx: Redirection - Further action must be taken in order to complete the request

1. 300 - Multiple Choices
   
   当前请求包含多个资源，并且在返回消息中包含每个资源的location信息。客户端可以根据一定的算法自行选择使用那个资源（没有定义算法）。服务器也可以指定一个推荐的选择（在Location头中），客户端可能会使用这个值重定向。
2. 301 - Moved Permanently
   
   请求的资源已经被永久的移动到一个新的URI上。客户端可以自动跳转到新的URI上。新的URI需要在响应消息的Location头中包含。
3. 302 - Found
   
   请求的资源临时的存在于另一个URI中。因为这个重定向还可能会改变，客户端需要继续使用旧的URI。临时的URI需要包含在响应消息的Location头中。
4. 303 - See Other
   
   请求的响应可以使用另一个URI中获得，并且必须使用GET方法获取另一个URI上的响应。该响应码主要用于将一个POST产生的输出重定向到一个新选择的资源上。新的URI需要在Location响应头中给出。
5. 304 - Not Modified
   
   如果客户端发送一个“Conditional GET”请求，并且该请求是被允许的，但是它所对应的文档没有改变，则服务器返回该响应。该响应不能包含消息体，但必须包含一些消息头：Date、ETag、Content-Location、Expires、Cache-Control、Vary。
6. 305 - Use Proxy
   
   请求的资源必须通过Proxy使用Location响应头中的URI访问。
   
7. 306 - Unused
   
   以前版本使用，现在已经不使用，但是响应码保留。
8. 307 - Temporary Redirect
   
   请求的资源临时的指向另一个URI，但是由于这个重定向可能会在将来被更改，因而客户端需要继续使用原来的URI。临时的URI在Location响应头中指定。

4xx: Client Error - The request contains bad syntax or connote be fulfilled

1. 400 - Bad Request
   
   语法错误，请求不能被服务器理解。
2. 401 - Unauthorized
   
   请求需要包含用于认证。响应必须包含WWW-Authenticate头，包含请求认证需要的信息。客户端可以使用包含Authorization头重新发送请求。
3. 402 - Payment Required
   
   为将来使用保留。
4. 403 - Forbidden
   
   服务器拒绝该请求。如果服务器希望让客户端知道拒绝的原因，可以将原因放在响应消息体重，如果服务器想暴露该原因，则可以返回404（Not Found）响应。
5. 404 - Not Found
   
   服务器没有发现任何匹配的请求URI。如果服务器知道某些资源已经永久的被移出，并且没有重定向地址，则需要返回410（Gone）响应。该响应也可以用于服务器不想暴露客户请求被拒绝的原因。
6. 405 - Method Not Allowed
   
   请求方法不被对请求的资源允许。在响应消息中必须包含Allow头，指定请求资源允许的请求方法。
7. 406 - Not Acceptable
   
   请求的资源产生的响应包含了不被Accept请求头指定的特性。
8. 407 - Proxy Authentication Required
   
   类似401（Unauthorized），表示客户端必须在Proxy中通过认证。Proxy必须返回Proxy-Authenticate头，包含请求认证需要的信息。
9. 408 - Request Time-out
   
   服务器已经准备好并在等待，但是客户端在指定的时间里没有发送请求。
10. 409 - Conflict
    
    因为和资源当前状态冲突而导致请求没有完成。该响应码只有在用户知道任何解决这个冲突，并且重新提交请求时产生。
11. 410 - Gone
    
    请求的资源已经不在服务器上，并且没有更进一步的重定向地址。
12. 411 - Length Required
    
    请求消息必须包含Content-Length消息头。
13. 412 - Precondition Failed
    
    服务器对一个或多个请求消息头的测试失败。
14. 413 - Request Entity Too Large
    
    请求消息太大。如果这个条件是临时的，则服务器需要包含Retry-After响应头，表示这个响应时临时的，并在指定的时间以后重试。
15. 414 - Request-URI Too Large
    
    请求的URI太长。
16. 415 - Unsupported Media Type
    
    请求消息格式不被支持。
17. 416 - Request range not satisfiable
    
    在请求包含Range头，不包含If-Range头，并且请求的资源不在Range指定的范围中。响应头中需要包含Content-Range表示指定资源当前的长度。
18. 417 - Expectation Failed
    
    Expect请求头指定的值不能匹配服务器的逻辑。

5xx: Server Error - The server failed to fulfill an apparently valid request

1. 500 - Internal Server Error
   
   服务器内部错误。
2. 501 - Not Implemented
   
   服务器没有实现当前请求。如没有实现对应的请求方法。
3. 502 - Bad Gateway
   
   代理或网关服务器从上游服务器中接收到一个不合法的响应。
4. 503 - Service Unavailable
   
   服务器因为临时负载过重或处于维护状态而不能处理请求。该响应暗示服务器当前的状态是临时的，如果服务器知道什么时候恢复可用状态，则可以包含Retry-After响应头，如果没有包含Retry-After头，则客户端可以把它视为500（Internal Server Error）来处理。
5. 504 - Gateway Time-out
   
   代理服务器或网关服务器在指定的时间内没有收到上游服务器的响应。
6. 505 - HTTP Version not supported
   
   服务器不支持或拒绝支持请求消息中指定的HTTP版本。