REST以及RESTful的理解

这个概念其实对于后端开发人员应该不陌生,简单总结一句话来说

RESTful是一种针对Web,iOS,Android和第三方开发者变为平等的角色通过一套API来共同消费Server提供的服务的协议。

客户端开发人员对于这个概念可能会陌生一点,但是其实一直都在使用或者参与这个协议的实施。

一、 首先为什么要用RESTful结构呢?

  因为在移动互联网真正到来之前,网页是前端后端融在一起的,比如之前的PHP,JSP等。在之前的PC时代问题不大,但是近年来移动互联网的发展,各种类型的Client层出不穷,RESTful可以通过一套统一的接口为 Web,iOS和Android提供服务。另外对于广大平台来说,比如Facebook platform,微博开放平台,微信公共平台等,它们不需要有显式的前端,只需要一套提供服务的接口,于是RESTful更是它们最好的选择。在RESTful架构下:

二、API事例

下面我们来视图写一个例子,来让大家理解下

restful 认为一切皆是资源, API 应该是对资源(比如某视屏网站或者视频软件上的龙妈或者雪诺视频集锦)的状态的转化。

一、基本原则

url 路径中只应该包含资源标识符

比如,获取龙妈视频,非RESTful API可能是这样的

/GetLongma

这个业务中,PO是一种资源(看成龙妈的视频集锦),restful 风格的 API 应该应该是

/Longma

那么,怎么表示这个API是获取的的呢?

利用 http method 定义资源状态转化

上面这个例子,可以用GET定义方法来获得龙妈视频

GET  /longma

restful 一般用http method来标志资源状态的转化,有以下四种方式:

POST 创建

PUT 更新

GET 获取

DELETE 删除

所以,对于视频,它的创,更新,获取,删除,API如下

POST /longma      (比如你上传一个龙妈的视频)

PUT /longma/:id          (比如你修改了之前你上传的那个龙妈的视频,增加了你自己的旁白什么的,然后保存更新)

GET /longma/:id          (比如你自己去网站上搜索你之前上传的那个龙妈的视频)

DELETE /longma/:id    (比如你觉得不好看,然后要删除你之前上传的龙妈视频)

上面的例子,其实实际业务一般不会这么简单,比如该视频的作者或者说上传者都会从属于某一个用户,所以API的结构会是下面这样,以 PUT 为例

PUT /user/:userid/longma/:videoid

这里就引申出一个值得讨论的话题,如何设计从属关系?从业务实体上设计从属关系可能会遇到一些困难,比如,某些情况下,父资源的创建可能会依赖子资源的创建。一般情况下,如果开销不大的话,可以重新设计一下业务。比如,已经上传的视频必须从属于一个user,那么业务上就规定必须先注册(创建user)或者登陆,才能上传视频。

三、大白话图文讲解原理

如果还看不明白,撞墙100下

首先,首先我们假设上海有个女孩叫小美,她是一个龙妈的粉丝,然后有一天小美想用电脑看龙妈的精彩锦集视频。她做了如下四步:

这基本上就是一个传统的电脑软件的架构。现在我们看看如何把这个传统的电脑软件变成RESTful架构的软件。

我们把小美家的电脑主机从上海搬到北京,而小美的显示器则仍然留在家里。


然后我们把之前连接电脑主机和显示器的“电线”换成“互联网”,并且把四个部件(显示器,主机,视频文件,腾讯视频软件)的名字换成:客户端,服务器,资源,浏览器。


为了在茫茫互联网世界中准确快速的找到那台服务器并观看“龙妈集锦”,我们需要给在北京的这台服务器加一个标识符,也就是常说的Url。 同时,为了区分服务器中的“龙妈集锦”和“雪诺集锦”,我们也需要给这两个视频单独加上标识符。

这个服务器当然不只有龙妈和雪诺的视频,还有其他千千万万的视频,以及音乐,表单和网页等等东西。服务器上放不下这么多东西,所以需要把这些东西移到数据库里面放着。

这样,整个RESTFul的架构基本上就成型了。我们来看看小美今天应该如何观看龙妈的视频。

步骤1. 小美打开浏览器。注意此时小美家中的电脑硬盘里面没有存任何视频,视频存在北京的数据库里面。


步骤2.小美输入http://www.youku.cn/longma客户端通过互联网找到http://www.youku.cn的服务器,然后服务器根据longma在数据库里找到了龙妈的视频, 并把视频数据通过互联网传回给了小美的客户端。这个操作就是我们常说的GET。

步骤3. 小美开心地观看传回来的视频,但是她不想在视频中看到龙马的败家老哥。

步骤4. 她通过浏览器或者腾讯视频软件剪掉了败家老哥的部分,点击了”提交“,然后服务器接到这个请求之后把修改保存到数据库里面,并且告诉小美”你的修改已经保存。这个操作就是我们常说的POST。

我们来对比一下之前的单机情况下。

腾讯视频的文件路径 = REST软件的Url

腾讯视频的打开操作 = REST软件HTTP的GET

腾讯视频的保存操作 = REST软件HTTP的POST

当然,还有很多细节,不过这就是REST软件框架的一个大概样子。

四、后记

这边放一个关于RESTful的协议规范定义的详细链接,可以参考

看在画图画到吐血的份上,高抬贵手,点个赞吧

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

推荐阅读更多精彩内容