RESTful 规范

web 服务交互

我们在浏览器中能看到的每个网站,都是一个web服务器。那么我们在提供每个web服务的时候,都需要前后端交互,前后端交互就一定有一些实现方案,我们通常叫web服务交互方案。
目前主流的三种web服务交互方案:

  • REST (Representational State Transfer) 表征性状态转移
  • SOAP (Simple Object Access Protocol)简单的对象访问协议
  • XML-RPC (XML Remote Procedure Call)基于XML的远程过程调用

XML-RPC 是通过XML将调用函数封装,并使用HTTP协议作为传送机制。
后来在新的功能不断被引入下,这个标准慢慢演变成今日的SOAP协议。
SOAP服务则是以本身所定义的操作集来访问网络上的资源。
SOAP也是基于XML的,但是他不只限于HTTP协议的传输,包括TCP协议,UDP协议都可以传输。
REST是Roy Thomas Fielding博士与2000年在它的博士论文里提出来的。
REST相比SOAP更加简洁,性能和开发效率也有突出的优势。
现在越来越多的web服务开始采用REST风格设计和实现。
例如,amazon.com提供接近REST风格的Web服务进行图书查找;雅虎提供的Web服务也是REST风格的。

如果我们想要理解restful,就要理解Representational State Transfer 这个词组的意思,表征性状态转移(又译:表现层状态转化)。
这里说的表征性,其实就是指资源。通常我们称为资源状态转移。

什么是资源

任何事物,只要有被引用到的必要,它就是资源。
我们在浏览器中看见的文本,视频,图片等等都是资源。这些都是实实在在存在的实体。资源可以是一个实体,也可以是抽象的概念。
比如说:

  • 我的个人信息

  • “妳”的微信号(疯狂暗示)


    害羞
  • 你和我的潜在关系

在我们的网络中,我们要引用资源,资源一定要有一个标识,在web中的唯一标识就是URI,URI我们不经常听说,但我们却经常用URL,那两者区别是什么呢?

什么是URI,URL

URI 统一资源标志符
URlL统一组员定位符
URI 是给我们的资源进行标识的,URL是描述我们资源地址的。

比如说我们每个人都有名字和身份证,名字可能重名,但是身份证是唯一的,

那么身份证号就可以是我们的URI,标识我们每个人,也可以说标识我们每个资源。

你们可以通过身份证号锁定我,也可以通过下面这种方式锁定我.....

我的住址协议://地球/中国/屌丝省/屌丝市/幻想村/温柔乡/233号街道/233号/可笑的黑耀斑

这个就是我们的URL,我们通过这两种方式都可以找到我们的资源,

其实我们的URL可以说是URI的子集,通过定位的方式实现的URI。

这是我们资源的定位有了资源的地址后,我们要去访问资源,那么我们要通过什么方式去访问呢

统一在资源接口

现在我们可以通过URl去访问到资源,那么我们对资源会有很多不同的操作,增删改查,以前我们可能会为了这个增加新设计一个URL,然后这个URL就是对数据增加的,还会为了更新和删除分别设计一个URL,现在我们不用了,我们只有一个URL,然后根据HTTP请求方式的不同,对资源进行不同的操作,这个就是统一资源接口。
我们一定要遵循HTTP请求方法的语义,也就是说POST请求就是在新增数据等.....

资源的表述

资源的表述其实就是资源的展现形式,我们客户端和服务端传输的都是资源的表述,而不是资源本身。
例如文本资源可以采用html、xml、json等格式,图片可以使用png、jpg展现出来。
那么客户端如何知道服务端提供那种表述形式呢?
可以通过HTTP内容协商,客户端可以通过Accept头请求一种特定格式的表述,服务端则通过Content-Type告诉客户端资源的表述形式。

这些资源的表述呈现在页面上,就是我们说的资源状态。

状态转移

我们在看页面的时候,从当前资源的表述(也可以说状态或者表现层)会跳转到其他的资源状态。
服务端通过超媒体告诉客户端当前状态有哪些后续状态可已进入。
这些类似 “下一页” 之类的连接气的就是这种推进状态的作用——指引你如何从当前状态进入下一个可能的状态。

可以得知REST风格的特点如下:

  • 在web中,只要有被引用的必要都叫资源。
  • 每个URI代表一个资源,独一无二的。
  • 客户端通过HTTP的方法,对服务器端资源进行操作。
  • 客户端和服务器之间,传递这种资源的某种表现层
  • 通过超链接的的指引,实现“表现层状态的转移”。

入股一个架构符合REST的约束条件和原则,我们就称它为RESTful架构。
一种软件的架构风格,设计风格,微客户端和服务端的交互提供一组设计原则和约束条件。

restful规范

一 面向资源编程
每个URL代表一种资源,URL中尽量不要用动词,要用名词。

二 根据method不同,进行不同的操作
GET/POST/PUT/DELETE/PATCH

** 三 在URL中体现版本**
https://www.bootcss.com/v1/mycss
https://v1.bootcss.com/mycss

四 在URL中体现是否是API
https://www.bootcss.com/api/mycss

** 五 在URL中的过滤条件
https://www.bootcss.com/v1/mycss?page=3

六 尽量使用HTTPS

七 响应设置状态码
1** 信息,服务器收到请求,需要请求者继续操作
2** 成功,操作被成功接收并处理
3** 重定向,需要进一步的操作以完成请求
4** 客户端错误,请求包含语法错误或无法完成请求
5** 服务器错误,服务器在处理请求的过程中发生了错误

八 返回值
GET请求 返回查到所有或单挑数据
POST请求 返回新增的数据
PUT请求 返回更新数据
PATCH请求 局部更新 返回更新整条数据
DELETE请求 返回值为空

九 返回错误信息
返回值携带错误信息

十 Hypermedia API
如果遇到需要跳转的情况 携带调转接口的URL

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

推荐阅读更多精彩内容