【网络】HTTP协议必知必会

1、请求、响应

HTTP协议是以一问一答方式通讯；
客户端向服务器发送请求消息；
服务器向客户端反馈响应消息；
一个请求对应一个响应；

2、特点

1）短连接
短连接可以限制每次连接只处理一个请求。服务器处理完客户的请求，并返回应答后，即断开连接。

2）无状态
HTTP协议是无状态协议。无状态是指协议对于事务处理没有记忆能力。缺少状态意味着如果后续处理需要前面的信息，则它必须重传，这样可能导致每次连接传送的数据量增大。另一方面，在服务器不需要先前信息时它的应答就较快。

3、消息的格式

HTTP消息分为三个部分：

• 首行
• 头部（Header）
• 正文（Body）

GET /simple.html HTTP/1.1<CRLF>     ----- 首行
Accept: text/html<CRLF>             --|
Accept-Language: zh-cn<CRLF>          |
Accept-Encoding: gzip, deflate<CRLF>  |-- 头部
User-Agent: Mozilla/4.0<CRLF>         |
Host: localhost:8080<CRLF>            |
Connection: Keep-Alive<CRLF>        --|
<CRLF>                              ----- 空白行表示头部的结束
----- 接下来的内容是正文部分

1）首行：是必须的，以ASCII编码，首行在请求消息和响应消息中具体格式略有区别
2）头部：表示消息的一些属性，以ASCII编码，键值对Key:Value的形式表示，非必须；
3）正文：也称为消息体，携带实际内容，非必须，对于文本消息，约定以UTF-8格式进行编码和解码；
4）<CRLF>：是回车符和换行符的意思，它们是两个特殊的ASCII字符。CR是回车符（\r），在ASCII中的编码是13；LF是换行符（\n），在ASCII中的编码是10.
5）HTTP消息是基于TCP协议的上层应用协议
6）请求消息的首行基本格式：方法 路径 版本，GET（方法） /simple.html（路径） HTTP/1.1（版本）

4、HTTP请求方法

• GET：GET方法用来获取资源，每次都一样，因此可以在浏览器中缓存，下次请求的时候可能从缓存中去取就够了，服务器不用再重复发送相同的资源；并且GET方法没有消息体。
• POST：创建资源，浏览器端就不会再对资源进行缓存了，即使每次取到的都是同样地内容，都会请求服务器重新发送一遍；POST请求可以包含请求正文
• PUT：全量更新资源
• PATCH：部分更新资源
• DELETE：删除资源
• HEAD：响应消息是不包含消息体的
• OPTIONS：客户端查看服务器的性能
• TRACE：回显服务收到的请求，用于测试

5、HTTP请求路径

基本格式：

basic-path[?query-string]

其中[]中的内容表示可选的。
basic-path形式很像UNIX中绝对路径的样式
问号后面的部分就是query-string。GET方法是不包含请求体的，所以GET方法的HTTP请求想要附加参数只能使用这种方式。
query-string一般以键值对的形式。例如：k1=v1&k2=v2&k3=&k4

6、HTTP响应首行

6.1基本格式

版本号 状态码 状态文本

例如：

HTTP/1.1 200 OK

6.2 五大状态码

HTTP状态码由3个数字表示，其中第一个数字表示一个大状态，后面两个数字表示该大状态的一个子状态。
状态码一共分为五个大状态：

• 1xx：消息
• 2xx：请求成功处理
• 3xx：重定向
• 4xx：客户端出错
• 5xx：服务器出错

6.3 常用状态码

• 200 OK GET/PUT 成功
• 201 Created POST 成功（资源已创建）
• 204 No Content DELETE 成功（无返回内容）
• 400 Bad Request 请求体格式错误
• 401 Unauthorized 未提供身份验证信息
• 403 Forbidden 无权访问资源
• 404 Not Found 资源不存在
• 500 Internal Server Error 服务端未知错误

6.4 全部状态码

1）1xx：消息

• 100 Continue 服务器仅接收到部分请求，但是一旦服务器并没有拒绝该请求，客户端应该继续发送其余的请求。
• 101 Switching Protocols 服务器转换协议：服务器将遵从客户的请求转换到另外一种协议。

2）2xx：请求成功处理

• 204 No Content DELETE 成功（无返回内容）
• 400 Bad Request 请求体格式错误
• 401 Unauthorized 未提供身份验证信息
• 403 Forbidden 无权访问资源
• 404 Not Found 资源不存在
• 500 Internal Server Error 服务端未知错误
• 200 OK 请求成功（其后是对GET和POST请求的应答文档。）
• 201 Created POST 成功，请求被创建完成，同时新的资源被创建。
• 202 Accepted 供处理的请求已被接受，但是处理未完成。
• 203 Non-authoritative Information 文档已经正常地返回，但一些应答头可能不正确，因为使用的是文档的拷贝。
• 204 No Content 没有新文档。浏览器应该继续显示原来的文档。如果用户定期地刷新页面，而Servlet可以确定用户文档足够新，这个状态代码是很有用的。
• 205 Reset Content 没有新文档。但浏览器应该重置它所显示的内容。用来强制浏览器清除表单输入内容。
• 206 Partial Content 客户发送了一个带有Range头的GET请求，服务器完成了它。

3）3xx：重定向

• 300 Multiple Choices 多重选择。链接列表。用户可以选择某链接到达目的地。最多允许五个地址。
• 301 Moved Permanently 所请求的页面已经转移至新的url。
• 302 Found 所请求的页面已经临时转移至新的url。
• 303 See Other 所请求的页面可在别的url下被找到。
• 304 Not Modified 未按预期修改文档。客户端有缓冲的文档并发出了一个条件性的请求（一般是提供If-Modified-Since头表示客户只想比指定日期更新的文档）。服务器告诉客户，原来缓冲的文档还可以继续使用。
• 305 Use Proxy 客户请求的文档应该通过Location头所指明的代理服务器提取。
• 306 Unused 此代码被用于前一版本。目前已不再使用，但是代码依然被保留。
• 307 Temporary Redirect 被请求的页面已经临时移至新的url。

4）4xx：客户端出错

• 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” 未被定义。如果无此内容，服务器不会接受请求。
• 412 Precondition Failed 请求中的前提条件被服务器评估为失败。
• 413 Request Entity Too Large 由于所请求的实体的太大，服务器不会接受请求。
• 414 Request-url Too Long 由于url太长，服务器不会接受请求。当post请求被转换为带有很长的查询信息的get请求时，就会发生这种情况。
• 415 Unsupported Media Type 由于媒介类型不被支持，服务器不会接受请求。
• 416 服务器不能满足客户在请求中指定的Range头。
• 417 Expectation Failed

5）5xx: 服务器错误

• 500 Internal Server Error 请求未完成。服务器遇到不可预知的情况。
• 501 Not Implemented 请求未完成。服务器不支持所请求的功能。
• 502 Bad Gateway 请求未完成。服务器从上游服务器收到一个无效的响应。
• 503 Service Unavailable 请求未完成。服务器临时过载或当机。
• 504 Gateway Timeout 网关超时。
• 505 HTTP Version Not Supported 服务器不支持请求中指明的HTTP协议版本。

7、HTTP头部

7.1 HTTP Request Header 请求头

7.2 HTTP Responses Header 响应头

8、URI 设计规范

1）参见：
关于URL编码

2）资源命名
使用名词（复数形式），如 /users 而非 /getUsers。
层级关系：用 / 分隔，如 /users/{userId}/orders。
版本控制：在 URI 或 Header 中声明版本，如 /api/v1/users。

9、JSON 消息体设计

9.1 请求体（Request Body）

1）POST 创建资源

POST /api/v1/users
Content-Type: application/json

{
  "name": "Alice",
  "email": "alice@example.com",
  "role": "member"
}

2）PUT 全量更新

PUT /api/v1/users/123
Content-Type: application/json

{
  "name": "Alice Smith",
  "email": "alice.smith@example.com",
  "role": "admin"
}

3）PATCH 部分更新

PATCH /api/v1/users/123
Content-Type: application/json

{
  "role": "admin"
}

9.2 响应体（Response Body）

1）成功响应

{
  "code": 200,
  "data": {
    "id": 123,
    "name": "Alice",
    "email": "alice@example.com"
  },
  "message": "Success"
}

2）错误响应

{
  "code": 404,
  "error": "User not found",
  "details": "No user with ID 456 exists."
}