学胖子的个人博客

Http 学习 v1

发表于 更新于 分类于

Http 学习 v1

HTTP 的定义

⼀种⽹络传输协议，位于 TCP / IP 协议族的最顶层——应⽤层。

Hypertext Transfer Protocol，超⽂本传输协议，和 HTML (Hypertext Markup Language 超⽂本标记语⾔) ⼀起诞⽣，⽤于在⽹络上请求和传输 HTML 内容。

HTTP 的⼯作⽅式

浏览器 :

  • ⽤户输⼊地址后回⻋或点击链接
  • 浏览器拼装 HTTP 报⽂并发送请求给服务器
  • 服务器处理请求后发送响应报⽂给浏览器
  • 浏览器解析响应报⽂并使⽤渲染引擎显示到界⾯

⼿机 App

  • ⽤户点击或界⾯⾃动触发联⽹需求
  • Android 代码调⽤拼装 HTTP 报⽂并发送请求到服务器
  • 服务器处理请求后发送响应报⽂给⼿机
  • Android 代码处理响应报⽂并作出相应处理（如储存数据、加⼯数据、显示数据到界⾯）

URL 和 HTTP 报⽂

URL 格式

三部分：协议类型、服务器地址(和端⼝号)、路径(Path)

协议类型://服务器地址[:端⼝号]路径

http://hencoder.com/users?gender=male

报⽂格式

请求报⽂

  • 请求报文格式：请求行、Headers、Body
  • 请求行：Method、Path、HTTP version
  • Method：GET、POST、PUT、DELETE …
  • Headers：请求的 meta data
  • Body：要发送给服务器的内容

响应报⽂

  • 响应报文格式：状态行、Headers、Body
  • 状态行：HTTP version、Status Code、Status Message
  • Status Code: 1xx(信息)、2xx(成功)、3(重定向)、4(客户端错误)、5(服务器错误)

Request Method 请求⽅法

GET

  • ⽤于获取资源
  • 对服务器数据不进⾏修改
  • 不发送 Body
1
2
GET /users/1 HTTP/1.1
Host: api.github.com

对应 Retrofit 的代码：

1
2
@GET("/users/{id}")
Call<User> getUser(@Path("id") String id, @Query("gender") String gender);

POST

  • ⽤于增加或修改资源
  • 发送给服务器的内容写在 Body ⾥⾯
1
2
3
4
5
POST /users HTTP/1.1
Host: api.github.com
Content-Type: application/x-www-form-urlencoded
Content-Length: 13
name=rengwuxian&gender=male

对应 Retrofit 的代码：

1
2
3
4
@FormUrlEncoded
@POST("/users")
Call<User> addUser(@Field("name") String name, @Field("gender") String
gender);

PUT

  • ⽤于修改资源
  • 发送给服务器的内容写在 Body ⾥⾯
1
2
3
4
5
PUT /users/1 HTTP/1.1
Host: api.github.com
Content-Type: application/x-www-form-urlencoded
Content-Length: 13
gender=female

对应 Retrofit 的代码：

1
2
3
4
@FormUrlEncoded
@PUT("/users/{id}")
Call<User> updateGender(@Path("id") String id, @Field("gender") String
gender);

DELETE

  • ⽤于删除资源
  • 不发送 Body
1
2
DELETE /users/1 HTTP/1.1
Host: api.github.com

对应 Retrofit 的代码：

1
2
@DELETE("/users/{id}")
Call<User> getUser(@Path("id") String id, @Query("gender") String gender);

HEAD

  • 和 GET 使⽤⽅法完全相同
  • 和 GET 唯⼀区别在于，返回的响应中没有 Body

可以在下载文件时，先获取文件长度，是否这次断点续传等

Status Code 状态码

  • 1xx：临时性消息。如：100 （继续发送）、101（正在切换协议）
  • 2xx：成功。最典型的是 200（OK）、201（创建成功）。
  • 3xx：重定向。如 301（永久移动）、302（暂时移动）、304（内容未改变）。
  • 4xx：客户端错误。如 400（客户端请求错误）、401（认证失败）、403（被禁⽌）、404（找不到内容）。
  • 5xx：服务器错误。如 500（服务器内部错误）。

Header

作⽤：HTTP 消息的元数据（ metadata ）。

Host

⽬标主机。注意：不是在⽹络上⽤于寻址的，⽽是在⽬标服务器上⽤于定位⼦服务器的。

Content-Type

指定 Body 的类型。主要有四类：

1. text/html

请求 Web ⻚⾯是返回响应的类型，Body 中返回 html ⽂本。

1
2
3
4
5
6
7
8
HTTP/1.1 200 OK
Content-Type: text/html; charset=utf-8
Content-Length: 853
<!DOCTYPE html>
<html>
<head>
 <meta charset="utf-8">
......

2. x-www-form-urlencoded

Web ⻚⾯纯⽂本表单的提交⽅式

1
2
3
4
5
POST /users HTTP/1.1
Host: api.github.com
Content-Type: application/x-www-form-urlencoded
Content-Length: 27
name=rengwuxian&gender=male

对应 Retrofit 的代码：

1
2
3
4
@FormUrlEncoded
@POST("/users")
Call<User> addUser(@Field("name") String name, @Field("gender") String
gender);

3. multitype/form-data

Web ⻚⾯含有⼆进制⽂件时的提交⽅式。

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
POST  /users  HTTP/1.1
Host: hencoder.com
Content-Type: multipart/form-data; boundary=----WebKitFormBoundary7MA4YWxkTrZu0gW
Content-Length: 2382

------WebKitFormBoundary7MA4YWxkTrZu0gW
Content-Disposition: form-data; name="name"

rengwuxian
------WebKitFormBoundary7MA4YWxkTrZu0gW
Content-Disposition: form-data; name="avatar"; filename="avatar.jpg"
Content-Type: image/jpeg

JFIFHHvOwX9jximQrWa......
------WebKitFormBoundary7MA4YWxkTrZu0gW--

对应 Retrofit 的代码：

1
2
3
4
5
6
7
8
9
10
@Multipart
@POST("/users")
Call<User> addUser(@Part("name") RequestBody name, @Part("avatar")
RequestBody avatar);
...
RequestBody namePart = RequestBody.create(MediaType.parse("text/plain"),
nameStr);
RequestBody avatarPart = RequestBody.create(MediaType.parse("image/jpeg"),
avatarFile);
api.addUser(namePart, avatarPart);

4. application/json , image/jpeg , application/zip …

单项内容（⽂本或⾮⽂本都可以），⽤于 Web Api 的响应或者 POST / PUT 的请求

1
2
3
4
5
6
7
//请求中提交 JSON

POST /users HTTP/1.1
Host: hencoder.com
Content-Type: application/json; charset=utf-8
Content-Length: 38
{"name":"rengwuxian","gender":"male"}

对应 Retrofit 的代码：

1
2
3
4
5
@POST("/users")
Call<User> addUser(@Body("user") User user);
...
// 需要使⽤ JSON 相关的 Converter
api.addUser(user);
1
2
3
4
5
6
7
8
//响应中返回 JSON
HTTP/1.1 200 OK
content-type: application/json; charset=utf-8
content-length: 234
[{"login":"mojombo","id":1,"node_id":"MDQ6VXNl
cjE=","avatar_url":"https://avatars0.githubuse
rcontent.com/u/1?v=4","gravat......

1
2
3
4
5
6
7
8
//请求中提交⼆进制内容

POST /user/1/avatar HTTP/1.1
Host: hencoder.com
Content-Type: image/jpeg
Content-Length: 1575
JFIFHH9......

对应 Retrofit 的代码：

1
2
3
4
5
6
@POST("users/{id}/avatar")
Call<User> updateAvatar(@Path("id") String id, @Body RequestBody avatar);
...
RequestBody avatarBody = RequestBody.create(MediaType.parse("image/jpeg"),
avatarFile);
api.updateAvatar(id, avatarBody)

相应中返回⼆进制内容

1
2
3
4
HTTP/1.1 200 OK
content-type: image/jpeg
content-length: 1575
JFIFHH9......

Content-Length

指定 Body 的⻓度（字节）

Transfer: chunked (分块传输编码 Chunked Transfer Encoding)

⽤于当响应发起时，内容⻓度还没能确定的情况下。和 Content-Length 不同时使⽤。⽤途是尽早给出响应，减少⽤户等待。

1
2
3
4
5
6
7
8
9
10
HTTP/1.1 200 OK
Content-Type: text/html
Transfer-Encoding: chunked
4
Chun
9
ked Trans
12
fer Encoding
0

Location

指定重定向的⽬标 URL

User-Agent

⽤户代理，即是谁实际发送请求、接受响应的，例如⼿机浏览器、某款⼿机 App。

Range / Accept-Range

按范围取数据

  • Accept-Range: bytes 响应报⽂中出现，表示服务器⽀持按字节来取范围数据
  • Range: bytes=- 请求报⽂中出现，表示要取哪段数据
  • Content-Range:-/total 响应报⽂中出现，表示发送的是哪段数据

作⽤：断点续传、多线程下载。

其他 Headers

  • Accept: 客户端能接受的数据类型。如 text/html
  • Accept-Charset: 客户端接受的字符集。如 utf-8
  • Accept-Encoding: 客户端接受的压缩编码类型。如 gzip
  • Content-Encoding：压缩类型。如 gzip

Cache

作⽤：在客户端或中间⽹络节点缓存数据，降低从服务器取数据的频率，以提⾼⽹络性能。

REST

REST HTTP 即正确使⽤ HTTP。
* 使⽤资源的格式来定义 URL
* 规范地使⽤ method 来定义⽹络请求操作
* 规范地使⽤ status code 来表示响应状态
* 其他符合 HTTP 规范的设计准则