『政善治』Postman — 4.补充: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的真正意义!

参考:https://www.zhihu.com/question/23202402,解释的很精彩。

(二)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"}]

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

推荐阅读更多精彩内容