关于HTTP请求你需要知道的一切

2021-07-19 07:43:55

前言

现在几乎所有的客户端（不管是APP也好，H5页面也好），都需要用到网络请求，而绝大多数公司都会把客户端的网络框架封装好，我们直接拿来用就好了，不用管什么原理，只要请求以后能得到正确的返回就可以了，但如果让你从零开始封装一个请求框架，或者你接到了一个别的项目，当前的网络请求框架不合适或者不好用了，这时候你可能就懵了。本文将会讲述请求（Request）和响应（Response）的完整组成部分、Header的关键参数、HTTP 状态码的含义以及如何封装自己的请求框架。

HTTP Request请求报文

先上个图

请求报文 Request

分为三个部分：请求行、Headers和Body。
请求行：又分为三个部分method（下面会详细讲）、path(给服务器看得，如果你会一些后台的知识你会明白这其实就是来找后台的响应方法的)和HTTP version（当前大多数都是1.1，当然2.0会是趋势）
Headers:headers上的信息可以有很多，不止是图中列的这些，比较重点是Content-Type(下面会详细讲，现在知道是指body的类型就可以)，还有很多自己公司后台定义的参数比如token、stamptime等等。
Body:首先body不是一定存在的，这需要根据你请求行里的方法决定，如果是POST或者PUT那么body一定存在；如果是GET或者DELETE那么则没有body，body的类型刚才也提了由headers里面的Content-Type决定。
注意：
以上就是一个完整的Request的组成部分，这里还需要再提一下URL，一个完整的URL组成部分：协议类型、服务器地址和路径。那么根据上图的信息，请求的完整URL就是：http://api.github.com/users
下面我用Retrofit为例，模拟一下上面的请求

 Retrofit retrofit = new Retrofit.Builder()
                .baseUrl("http://api.github.com")
                .build();

    @Headers("Content-Type:text/plain")
    @POST("/users")
    Call<User> getUser(@Field("username")String name,@Field("pwd")String pwd);

retrofit.create(KakaService.class).getUser("kaka","123456");

这一段代码发给服务端过后就会变成上面HTTP Request请求报文，这下关于Request请求的组成应该都明白了吧

HTTP Response响应报文

再上个图

Response响应报文

同样分为三个部分：状态行、Headers和Body
状态行：三个部分，HTTP version、status code和status message。status 是状态码，对请求结果做描述的，下面会详细讲。
Headers：响应返回的头信息，其中比较常见的是Content-Type、Content-Length和Cache-Control等等，响应返回的headers包含的参数很多，这里只举了一小部分，想看更多的可以使用POSTMAN请求一下。
Body:这是我们开发者最最关心的内容，来自服务器的相应信息。返回内容现在一般都是json了（不过还是有一些公司返回的xml），通过json相关的解析工具转成我们想要的数据。

Request 请求Method

GET

⽤于获取资源
对服务器数据不进⾏修改
不发送 Body

HTTP请求报文
GET /users/1 HTTP/1.1
Host: api.github.com

//代码展示
@GET("/users/{id}")
Call<User> getUser(@Path("id") String id);

POST

⽤于增加或修改资源
发送给服务器的内容写在 Body ⾥⾯

HTTP 请求报文
POST /users HTTP/1.1
Host: api.github.com
Content-Type: application/x-www-form-urlencoded
Content-Length: 13
username=kaka&pwd=123456

代码展示
@FormUrlEncoded
@POST("/users")
Call<User> addUser(@Field("username") String username, @Field("pwd") String
pwd)

PUT

⽤于修改资源
发送给服务器的内容写在 Body ⾥⾯

HTTP 请求报文
PUT /users/1 HTTP/1.1
Host: api.github.com
Content-Type: application/x-www-form-urlencoded
Content-Length: 13
pwd=654321

代码展示
@FormUrlEncoded
@PUT("/users/{id}")
Call<User> updateGender(@Path("id") String id, @Field("pwd") String
pwd);

DELETE

⽤于删除资源
不发送 Body

HTTP 请求报文
DELETE /users/1 HTTP/1.1
Host: api.github.com

@DELETE("/users/{id}")
Call<User> getUser(@Path("id") String id);

HEAD

和 GET 使⽤⽅法完全相同
和 GET 唯⼀区别在于，返回的响应中没有 Body
一般用在多线程下载的时候，header里面返回Range / Accept-Range里的数据可以判断下载范围
注意：
本文只讲一些常用的重点方法，像HEAD、PATCH等方法不讲可以自行百度。

Header ⾸部

Content-Type

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

text/html
请求 Web ⻚⾯是返回响应的类型， Body 中返回 html ⽂本。格式如下：

HTTP/1.1 200 OK
Content-Type: text/html; charset=utf-8
Content-Length: 853
<!DOCTYPE html>
<html>
<head>
<meta charset="utf-8">
......

x-www-form-urlencoded
Web ⻚⾯纯⽂本表单的提交⽅式。

纯文本提交方式

POST /users HTTP/1.1
Host: api.github.com
Content-Type: application/x-www-form-urlencoded
Content-Length: 27
name=kaka&pwd=123456

multitype/form-data

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

含有二进制文件时的提交

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......对应 Retrofit 的代码：
4. application/json , image/jpeg , application/zip ...
单项内容（⽂本或⾮⽂本都可以），⽤于 Web Api 的响应或者 POST / PUT 的请求
请求中提交 JSON
对应 Retrofit 的代码：
响应中返回 JSON
------WebKitFormBoundary7MA4YWxkTrZu0gW

application/json , image/jpeg , application/zip ...
单项内容（⽂本或⾮⽂本都可以），⽤于 Web Api 的响应或者 POST / PUT 的请求

注意：header里面的这个content-type还是非常重要的，这决定于你和后台商量好的请求格式，以上的这些请牢记！

Content-Length

指定 Body 的⻓度（字节）

Location

指定重定向的⽬标 URL

User-Agent

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

Range / Accept-Range

按范围取数据
Accept-Range: bytes 响应报⽂中出现，表示服务器⽀持按字节来取范围数据
Range: bytes=<start>-<end> 请求报⽂中出现，表示要取哪段数据
Content-Range:<start>-<end>/total 响应报⽂中出现，表示发送的是哪段数据
作⽤：断点续传、多线程下载。

其他 Headers

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

Status Code 状态码

三位数字，⽤于对响应结果做出类型化描述（如「获取成功」「内容未找到」）。
1xx：临时性消息。如： 100 （继续发送）、 101（正在切换协议）
2xx：成功。最典型的是 200（ OK）、 201（创建成功）。
3xx：重定向。如 301（永久移动）、 302（暂时移动）、 304（内容未改变）。
4xx：客户端错误。如 400（客户端请求错误）、 401（认证失败）、 403（被禁⽌）、 404（找不到内容）。
5xx：服务器错误。如 500（服务器内部错误）
注意：为什么会有status code？status code的出现是为了开发者调试的，其中200我们最喜欢也最常见，返回正常，一切OK。其中最主要记得分清楚4XX和5XX的区别，但凡是4XX的这种移动端的同事就不要找后台的麻烦，指定是客户端的问题了，1XX临时性消息一般是迅雷多线程下载会返回的，3XX是重定向，一般用的比较少。

如何封装自己的网络框架

其实，我相信你只要认真学习了上面的知识，封装自己的网络请求框架应该不是什么问题了，下面我们就来总结一下，都需要注意封装是什么：
1.headers：这个是必须要注意的，因为现在的网络请求越来越注意安全性，有一些中小型的创业公司为了信息安全，经常在headers传一系列的加密信息，因为对headers的封装是必不可少的
2.body：body里面的内容封装主要取决于headers里的Content-type，根据不同的Content-type生成不同的body可以让我们的网络框架使用更加方便。
3.status code：对status code的封装是方便当我们网络发生错误时，给我们开发者更快地定位问题所在。
最后给大家提供一个我自己封装的例子，用的是当前比较流行的Retrofit+RxJava,https://www.jianshu.com/p/b5546905ccbc

码农公寓

前言