『政善治』Postman工具 — 3、补充:restful风格接口的项目说明
(一)RESTful架构风格特点
1、统一接口风格
http://服务器地址:端口号[/项目名称/版本/资源]
http://
:为我们HTTP协议的访问头标准。服务器地址
:为我们项目服务器IP地址。端口号
:为我们服务器内项目访问的指定编号。[/项目名称/版本]
:可选 。资源
:互联网-图片、音乐、视频、文本、数据。
2、规范的HTTP请求方法
GET
:从服务器取出资源(一项或多项)。POST
:在服务器新建一个资源。(单条或多条)PUT
:在服务器更新资源。DELETE
:从服务器删除资源。
3、HTTP响应码
序号 | 状态码 | 动词 | 说明 |
---|---|---|---|
1 | 200 | GET | 服务器成功返回用户请求的数据 |
2 | 201 | POST | 用户新增数据成功 |
3 | 201 | PUT | 用户修改数据成功 |
4 | 204 | DELETE | 用户删除数据 |
5 | 400 | POST/PUT | 用户发出的请求有错误,服务器没有进行新建或修改数据的操作 |
6 | 404 | GET | 服务器没有返回资源. |
4、什么是无状态
为什么说HTTP协议是无状态的协议呢?
因为它的每个请求都是完全独立的,每个请求包含了处理这个请求所需的完整的数据,发送请求不涉及到状态变更。
而且再次请求也无法判断他是否之前请求过,如果后续处理需要前面的信息,则它必须重传,这样可能导致每次连接传送的数据量增大。
看看下面故事你会有所启发。
- 无状态(Stateless)
魔都的老王开了一个会所,一个开会的地方,有大会议室、小会议室、Cosplay情景会议室。
顾客听说这个会所有特色,于是纷纷前来消费,小明就是其中的一员。
小明上次会议室体验很棒,尽管有点贵,本周又前来消费。
结账时,小明以为老王认识自己,和老王套近乎弄个优惠价:"王老板,我上周刚来过,打个折扣呗"!
老王很茫然地瞅着小明:"上周你来过?我好像一点印象也没有了嘛,很抱歉,无法优惠"!
小明很不爽地付完钱走人... - 有状态(Stateful)
老王有一个助手叫小王,看到这一幕于是和老板有一番对话:
小王:老板,下次客人来消费,咱们给客人发一张小卡片,来一次打卡一次,凡是打过卡的,都有优惠。来的
次数越多,折扣力度越大,这样就能有更多的回头客,您看如何?
老王连说这是好主意,以后就这么干!
小明第一次来领了一张考勤卡,打了卡,夹在钱包里。
第二次来消费埋单时,小明从自己的钱包掏出考勤卡,老王一看原来是回头客,好说好说,88折优惠,小明和老王都笑的合不拢嘴... - Cookie
后来老王觉得考勤卡上,还应该多记录一些内容,才能更好地服务客户,考勤卡上慢慢增加了更多内容。
会员卡片样例如下:
小明再次来消费时,不仅可以优惠,还可以根据小明的消费习惯,做出最合理的安排。
随着服务的精细化,小卡片上描述客户的信息越来越多,卡片越做越大,由于小卡片受4K字节的限制,每次客户前来消费都要携带大大的卡片,这很夸张! - Session
小王寻思着,小卡片一直都是客户携带,为何不在公司的电脑上弄个数据库,记录客户的消费习惯,每个客户有一个数据库明细。
客户明细如下:
给小明的小卡片上只要有一个客户代号"08029snne3e0kekllojeis007"就可以了,查询电脑就可以知道是小明消费信息和消费习惯,消费完还可以从账户余额内扣除。
这个客户代号就是SessionlD,通常保存在客户端浏览器的Cookie里。
总结:
上文故事中的"Stateless"、"Stateful"、"Cookie"、"SessionID"以及"Session"与HTTP协议中这些关键词具有相类似的意思。
HTTP最初的设计是无状态的(stateless),但是无状态的HTTP无法满足互联网日益发展的需求,于是业界扩展了HTTP协议,增加了有状态(stateful)协议头,使之变成一个有状态协议。
这个有状态的协议头,就是依靠Cookie来实现的,Cookie是维系客户端与服务器之间状态同步的纽带。
无论什么类型的Cookie,都是由服务器来一手创建,最终解释权归服务器,只有服务器才理解这些Cookie所代表的真正涵义;客户只负责携带,不需要理解Cookie的真正意义!
(二)JSON数据格式说明
restful风格接口的数据返回格式一般为:JSON数据格式。
1、什么是JSON
JSON 指的是 JavaScript 对象表示法(Java Script Object Notation)。
JSON 是轻量级的文本数据交换格式。
JSON 具有自我描述性,更易理解。
2、JSON格式的特点
JSON 是纯文本,具有"自我描述性"和“层级结构性”。
读写的速度更快,消耗流量少。
3、JSON语法
- 格式1
JSON对象:{"键1":"值1","键2":"值2"}
- 格式2
JSON数组:[值1,值2,值3.....]
- 格式3
对象+数组:{"name":"葫芦娃","age":"8","技能":[" "," "," "]}
- 格式4
数组+对象:[{"name":"葫芦娃","age":"8"},{"name":"葫芦娃","age":"8"}]
参考:https://www.zhihu.com/question/23202402,解释的很精彩。