RESTful必须知道的那些事

为什么会出现RESTful

先不要急着知道RESTful到底是什么,它没那么高深的。要想清楚的知道RESTful,首先回顾下HTTP协议,以及API(Application Programming Interface,应用程序编程接口)。这样可以知道RESTful的来历及意义所在。

  • API

    应用程序编程接口,说白了就是预定义一些功能,供其他调用,从而做到提供服务的作用。

  • HTTP
    在这里不说具体HTTP的含义,及相关基础的概念。想了解可以参考《图解HTTP》这本书,讲的很详细也很生动。在这里只想说说HTTP协议的基本构成。

HTTP协议工作于客户端-服务端架构为上。浏览器作为HTTP客户端通过URL向HTTP服务端即WEB服务器发送所有请求。Web服务器根据接收到的请求后,向客户端发送响应信息。这里就涉及到HTTP请求Request)和响应(Response),对于一个完整的请求(Request)、响应(Response)来说,还是有一定规范的(有套路的),这里我们看一下HTTP请求和响应的一些基本信息。

举个栗子:

我们用Fiddler抓了一下360浏览器的任务中心的API接口信息,如下是它的请求信息:

GET http://task.browser.360.cn/online/setpoint HTTP/1.1
Accept: */*
User-Agent: Mozilla/4.0 (compatible; MSIE 6.0; Windows NT 5.1)
Pragma: no-cache
Content-Type: application/x-www-form-urlencoded
Host: task.browser.360.cn
Content-Length: 449
Cookie:__guid=91251416.3523784108665864700.1520256100246.427D%25PO%25QR%25P9%25R1%25P0%25RS%25O5%25P4%25PO%25N7%25

得到的服务器响应结果,如下所示:

```
HTTP/1.1 200 OK
Server: nginx/1.6.3
Date: Sat, 10 Mar 2018 03:37:00 GMT
Content-Type: text/html; charset=utf-8
Transfer-Encoding: chunked
Connection: close
{"errno":"10003","errmsg":"\u7b7e\u540d\u9519\u8bef"}
    ```

我们可以看到:

  • 请求Request :

    1. 请求的方式 GET
    2. 请求的地址 URL(http://task.browser.360.cn/online/setpoint
    3. 版本号(HTTP/1.1)
    4. 请求的头部信息,headers(Accept,Host,cookie等在于此处存着)
    5. 附属体信息 (通常为自定义传的参数,这里并没有体现)
  • 响应Response :

    1. 版本号
    2. 状态码 (http协议的状态码)
    3. 相应头部信息headers (时间、数据格式、编码等信息)
    4. 附属体信息(通常为相应的自定义数据体)

那么问题来了,既然HTTP协议是有其规则的,那么我们在设计API的时候,也应该有一定的规则。这里头最有名的就是RESTful API规范了。

RESTful为何物?

首先来解释下它的直面意思,它是Representational State Transfer的缩写,翻译过来就是“表现层状态转换”。(直面意思都这么高深的样子)其实这里省略了它的主语resource(资源),即resource representational state transfer(资源表现层状态转换)。那资源指的又是什么呢?表现层又是什么?状态转化是做了什么呢?

  • resource(资源):其实就是网络上的某个信息,例如一段文本、一张图片、一首歌曲等。每个资源对应一个特定的URL。要获取这个资源,访问它的URL就可以,因此URI就成了每一个资源的地址或独一无二的识别符。

  • representation(表现层):"资源"是一种信息实体,它可以有多种外在表现形式。比如,一段文本我们可以用md格式或者txt等格式表现;图片可以用JPG格式表现,也可以用PNG格式表现。我们把"资源"具体呈现出来的形式,叫做它的"表现层"。因此所说的表现层是建立在资源上的。

  • state transfer(状态转换):我们知道,客户端与服务端是一种互动的关系,这就意味着,客户端的操作会改变服务端资源的状态,这种状态的变换叫做state transfer(状态转换),而这种状态转换是基于表现层,也就是说是对资源表现层的状态转换。所以就是"表现层状态转化"。

我们知道客户端操作是通过HTTP请求对服务端资源操作的,HTTP/1.1中,请求方法有(GET, POST, PUT, PATCH, DELETE)这些,并且有具体的含义。

GET(SELECT):从服务器取出资源(一项或多项)。
POST(CREATE):在服务器新建一个资源。
PUT(UPDATE):在服务器更新资源(客户端提供改变后的完整资源)。
PATCH(UPDATE):在服务器更新资源(客户端提供改变的属性)。
DELETE(DELETE):从服务器删除资源。

介绍上面基本概念后,总结下RESTful到底是什么,它就是:利用HTTP的请求方法去操作URL定位的资源,它是一种客户端与服务端交互的一种规范。它的核心思想就是:URL只负责描述需要操作的资源,所以URL里头不应该有动词,应该是名词。HTTP负责描述操作。

RESTful示例

例如一个关于组织机构的API设计应该这样:

http://www.organization.com/orgs
http://www.organization.com/departments
http://www.organization.com/staffs

基于请求的方式和路径来作为常见的CURD(增删改查)

GET /orgs 列出所有组织
POST /orgs 新增一个或多个组织
GET /orgs/ID 查询某个组织
PUT /orgs/ID 更新某个组织
DELETE /orgs/ID 删除某个组织
GET /orgs/ID/departments 查询某个组织下的所有部门
DELETE /orgs/ID/departments/ID/staffs 查询某个组织下的某个部门的所有员工

对于请求后的响应结果,RESTful也做了一个很好得定义:

GET /orgs:返回资源对象的列表(数组)
GET /orgs/resource:返回单个资源对象
POST /orgs:返回新生成的资源对象
PUT /orgs/resource:返回完整的资源对象
DELETE /orgs/resource:返回一个空文档

RESTful设计误区

最常见的一种设计错误,就是URI包含动词。因为"资源"表示一种实体,所以应该是名词,URL不应该有动词,动词应该放在HTTP协议中。

RESTful优点

  • URL具有很强可读性的,具有自描述性
  • 可提供OpenAPI,便于第三方系统集成,提高互操作性;

RESTful的缺点

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

推荐阅读更多精彩内容

  • Spring Cloud为开发人员提供了快速构建分布式系统中一些常见模式的工具(例如配置管理,服务发现,断路器,智...
    卡卡罗2017阅读 134,647评论 18 139
  • 一说到REST,我想大家的第一反应就是“啊,就是那种前后台通信方式。”但是在要求详细讲述它所提出的各个约束,以及如...
    时待吾阅读 3,421评论 0 19
  • API定义规范 本规范设计基于如下使用场景: 请求频率不是非常高:如果产品的使用周期内请求频率非常高,建议使用双通...
    有涯逐无涯阅读 2,526评论 0 6
  • 一篇好的关于RESTFUL API的文章(对英文进行了简单的翻译,方便英文阅读困难的朋友),共读,阅读时间约10分...
    CC先生之简书阅读 2,556评论 0 7
  • 学习体会: 1、双轮矩阵可以帮助客户总结已经做了哪些事情,确定更详细具体的方案,列出行动计划。 2、教练在每个工具...
    传习录每日60秒阅读 476评论 0 1