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

前言

现在几乎所有的客户端(不管是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 的类型。主要有四类:

  1. 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">
......
  1. 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
  1. 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
  1. 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

最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 158,736评论 4 362
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 67,167评论 1 291
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 108,442评论 0 243
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 43,902评论 0 204
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 52,302评论 3 287
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 40,573评论 1 216
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 31,847评论 2 312
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 30,562评论 0 197
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 34,260评论 1 241
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 30,531评论 2 245
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 32,021评论 1 258
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 28,367评论 2 253
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 33,016评论 3 235
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 26,068评论 0 8
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 26,827评论 0 194
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 35,610评论 2 274
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 35,514评论 2 269

推荐阅读更多精彩内容