Http的Url格式:
https://mp.csdn.net/console/editor/html/106963393
其中https为协议类型://mp.csdn.net为服务器地址[:端⼝号]console/editor/html/106963393为路径
Http的请求报文:
Http的响应报文:
Http的请求方法:
Get请求:
· ⽤于获取资源
· 对服务器数据不进⾏修改
· 不发送 Body
· 幂等(既反复调用多次时会得到相同的结果)
GET /users/1 HTTP/1.1
Host: api.github.com
对应 Retrofit 的代码:
@GET("/users/{id}")
Call<User> getUser(@Path("id") String id,@Query("gender") String gender);
Post请求:
· ⽤于增加或修改资源
· 发送给服务器的内容写在 Body ⾥⾯
· 不幂等(因为每次请求都可能会增加新的数据,所以不幂等)
POST /users HTTP/1.1
Host: api.github.com
Content-Type: application/x-www-form-urlencoded
Content-Length: 13
对应 Retrofit 的代码:
@FormUrlEncoded
@POST("/users")
Call<User> addUser(@Field("name") String name,@Field("gender") String gender);
PUT的请求方法:
· ⽤于修改资源
· 发送给服务器的内容写在 Body ⾥⾯
· 幂等(既反复调用多次时会得到相同的结果)
PUT /users/1 HTTP/1.1
Host: api.github.com
Content-Type: application/x-www-form-urlencoded
Content-Length: 13
对应 Retrofit 的代码:
@FormUrlEncoded
@PUT("/users/{id}")
Call<User> updateGender(@Path("id") String id,@Field("gender") String gender);
DELETE的请求方法:
· ⽤于删除资源
· 不发送 Body
· 幂等(既反复调用多次时会得到相同的结果)
DELETE /users/1 HTTP/1.1
Host: api.github.com
对应 Retrofit 的代码:
@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:
Header:HTTP 消息的 metadata。
Host:⽬标主机。注意:不是在⽹络上⽤于寻址的,⽽是在⽬标服务器上⽤于定位⼦服务
器的。
Content-Type:指定 Body 的类型。主要有四类:
1· text/html
Body 中返回 html ⽂本
2· x-www-form-urlencoded
以纯⽂本表单的提交⽅式
格式如下:
POST /users HTTP/1.1
Host: api.github.com
Content-Type: application/x-www-form-urlencoded
Content-Length: 27
请求body里面的内容的格式:name=rengwuxian&gender=male
对应 Retrofit 的代码:
@FormUrlEncoded
@POST("/users")
Call<User> addUser(@Field("name") String name,@Field("gender") String gender);
3· multipart/form-data
含有⼆进制⽂件时的提交⽅式
格式如下:
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 的代码:
@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 的请求
· 请求中提交 JSON:
POST /users HTTP/1.1
Host: hencoder.com
Content-Type: application/json; charset=utf-8
Content-Length: 38
请求body里面的内容的格式:{"name":"rengwuxian","gender":"male"}
对应 Retrofit 的代码:
@POST("/users")
Call<User> addUser(@Body("user") User user);
响应中返回 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......
· 请求中提交⼆进制内容:
POST /user/1/avatar HTTP/1.1
Host: hencoder.com
Content-Type: image/jpeg
Content-Length: 1575
JFIFHH9......
对应 Retrofit 的代码:
@POST("users/{id}/avatar")
Call<User> updateAvatar(@Path("id") String id, @BodyRequestBody avatar);
...
RequestBody avatarBody =RequestBody.create(MediaType.parse("image/jpeg"),avatarFile);
api.updateAvatar(id, avatarBody
响应中返回⼆进制内容:
HTTP/1.1 200 OK
content-type: image/jpeg
content-length: 1575
JFIFHH9......
Content-Length:指定 Body 的⻓度(字节)。
Transfer-Encoding:
⽤于当响应发起时,内容⻓度还没能确定的情况下。和 Content-Length 不同时使
⽤。⽤途是尽早给出响应,减少⽤户等待。
格式:
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=<start>-<end> 请求报⽂中出现,表示要取哪段数据
· Content-Range:<start>-<end>/total 响应报⽂中出现,表示发送的是哪段数据
作⽤:断点续传、多线程下载。
其他 Headers
1· Accept: 客户端能接受的数据类型。如 text/html
2· Accept-Charset: 客户端接受的字符集。如 utf-8
3· Accept-Encoding: 客户端接受的压缩编码类型。如 gzip
4· Content-Encoding:压缩类型。如 gzip
Cache:在客户端或中间⽹络节点缓存数据,降低从服务器取数据的频率,以提⾼⽹络性能。
REST:
REST 的定义众说纷纭,没有统⼀答案。
REST HTTP 即正确使⽤ HTTP。包括:
使⽤资源的格式来定义 URL
规范地使⽤ method 来定义⽹络请求操作
规范地使⽤ status code 来表示响应状态
其他符合 HTTP 规范的设计准则