『政善治』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
    后来老王觉得考勤卡上,还应该多记录一些内容,才能更好地服务客户,考勤卡上慢慢增加了更多内容。
    会员卡片样例如下:
    image
    小明再次来消费时,不仅可以优惠,还可以根据小明的消费习惯,做出最合理的安排。
    随着服务的精细化,小卡片上描述客户的信息越来越多,卡片越做越大,由于小卡片受4K字节的限制,每次客户前来消费都要携带大大的卡片,这很夸张!
  • Session
    小王寻思着,小卡片一直都是客户携带,为何不在公司的电脑上弄个数据库,记录客户的消费习惯,每个客户有一个数据库明细。
    客户明细如下:
    image
    给小明的小卡片上只要有一个客户代号"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,解释的很精彩。

posted @ 2021-05-06 16:06  繁华似锦Fighting  阅读(519)  评论(0编辑  收藏  举报