当我们谈论RESTful时,我们在谈论什么

博客原文传送门:当我们谈论RESTful时,我们在谈论什么   

标题好像有点噱头,山人在此先检讨。去知乎了一下,发现这种句式叫做卡佛句式,好像村上春树也用过,看来是雅俗共赏的。且回正文,最近Team要做一个Service,负责一些全局资源的管理,并为Internal的其他Services提供通用资源访问接口。想着之前一直是用一些RPC-style的架构,不如来试试RESTful的吧。虽然关于什么才是真正的REST一直有很多争论

I- Web服务的架构风格

就像面向对象与面向过程编程模型一样,Web Service应用服务中也有两种典型的架构模式,Remote Procedure Call(即,RPC,还有一种类似的叫法Remote Method Invocation细微的不同之处在于,RPC通过调用远程的过程函数,而RMI侧重于通过获取远程的对象引用,而通过对象引用调用其内部的方法。)与REpresentational State Transfer(即REST)。通常RPC是Operation Oriented,其通过暴露内部的操作接口,提供与之相应的不同编程语言的Client API来实现客户端与服务器的交互。通常与服务器的通信基于HTTP协议,但主要利用其作为一种传输媒介,把通讯的方法,信息以及状态都封装在HTTP协议的URI或是Body内部。且大多使用GET或是POST等单一方法。而REST则是一种Resource Oriented架构,就像面向对象编程一样,其把一个对象实体视为一种数据资源,针对每一种数据资源都会有相应的Service Endpoint,其也用HTTP协议,但不同于RPC,REST充分利用了HTTP协议在WWW上取得的成功,直接视HTTP协议为一种应用层协议,重用其各种HTTP方法,以及统一响应码定义,为全网范围内分布式系统通信提供了统一规范标准。

严格来说REST本身并不是一种具体架构,而是一种更高level的标准规范。初见于Roy Fielding的论文中,文中试图提出一种针对分布式超媒体(Hypermedia)系统架构,具有丰富表达能力的应用程序状态转换(即REST)Web应用服务的软件工程设计原则。以及依照这些原则下,规定客户端与服务器交互时应该遵守的一些限制。比如客户端与服务器的交互需是无状态的;为了提高Service性能而引入缓存机制;为了简化整个系统架构,提高交互的可见性提出的Uniform Interface的限制等论文中主要有如下constrains:

。论文是在2000年写的,开创性和预见性可想而知。而正是因为其不是具体的某个实现架构,也不是真正如RFC那样的定义清晰的业界标准。这么多年来,对REST的解读自然是仁者见仁智者见智了。

随着近几年RESTful Service越来越热,几乎每一个人在设计Web Service架构时都声称自己是遵照REST原则来设计的。因而诞生了好多RESTful Service API。但其实大多数系统的设计都是不伦不类的RPC与REST混合体。正如Richardson在他的那本经典的RESTful Web Services中所说,其实多数人设计的都是RESTful-RPC混合架构模式。但既然我们的主要争论点在RPC和REST这两者身上,不妨通过特征比较法来看看二者的主要不同点。

II- RPC vs REST

RPC和REST都是基于HTTP协议的,我们不妨先看看他们使用HTTP请求的方式有什么不同。当Client发起一个基本的HTTP请求,首先需要确定两个内容,即

HTTP Verb(Method)

URI(Resources Endpoint)

1- HTTP Verb

对于RPC而言,常用的HTTP方法只是POST和GET,尤其对于POST的使用比较依赖。且很多时候决定是使用GET还是POST的主要依据就是是否请求含有数据。而对于经典的RPC架构的产物,如XML-RPC或是SOAP-RPC,由于关于调用服务的所有信息,如操作类型,数据等都被封装在XML或是SOAP协议体Envelope内,而该协议本身又只被作为HTTP协议体封装传输。

XML RPC示例代码

POST /RPC2 HTTP/1.0User-Agent: Frontier/5.1.2 (WinNT)Host: betty.userland.comContent-Type: text/xmlContent-length: 181examples.getStateName41

SOAP RPC示例代码

POST /StockQuote HTTP/1.1Host: www.stockquoteserver.comContent-Type: text/xml; charset="utf-8"Content-Length: nnnnSOAPAction: "Some-URI"DIS

我们来分析下该SOAP请求,其目的很简单,就是得到上次的交易价格,其Operation是SOAP体中的GetLastTradePrice方法,从方法名我们不难看出,其实就是一个简单的查询。但是却封装成复杂的SOAP协议体,且本来基于HTTP协议的查询请求,GET语义就能够满足,但其却用POST方法来做。我们知道从HTTP协议的角度,各个HTTP Verb都有其标准规范,如下图所示:

即POST请求通常用在资源创建或更新时,而GET则是用在读取一个资源。这样做的一个好处就是HTTP协议是整个WWW都一致使用的协议,全网范围内有着一致的上下文,而不像SOAP示例中其是读取资源还是更新资源只有客户端和服务器自己知道。统一HTTP Verb带来的另一个好处就是,Service缓存机制的实现变得很简单。因为大家都建立在这些Verb规范的共识之上,可以直接通过请求方法来判断是否这些内容该缓存或者应该从缓存读取。

除了HTTP Verb,REST也基于统一的HTTP Response Code,来表示请求响应的状态。把HTTP响应头的语义状态与应用本身的资源请求结果状态统一。如Amazon S3 REST风格的响应码:

便不会再像RPC风格的响应那样,响应码是200/OK,但返回的响应体却是Service specific的错误码。完全的HTTP响应码标准定义可以参考HTTP/1.1协议也有人是这么记的:(

2- URI

利用统一的HTTP Verb, Response Code,也使得Fielding提出的Uniform interface成为可能。另一方面,网络上的资源访问统一接口便是URI,对于Resource-Oriented架构模式而言,便需要一个URI能够清晰无误的描述一个资源对象。且URI应该有层次结构,其改变最好能够以一种客户端用户可预测的方式来进行。按照Richardson的说法,一个好的URI需要self-descriptive和Addressibility。

与之相反,如前面提到的,RPC架构风格往往提供单个Service的全局URI,然后通过SOAP等应用协议来封装方法和所要获取的资源。

3- Stateless

Resource-Oriented架构的另一个重要特征便是无状态性。但就Web

Service而言,状态有两种,一种是应用程序状态,一种是资源状态。资源状态是Service本身内部维持的状态,其通过统一资源接口暴露给

Client。当Client操作一个资源时,如在一个图片分享网站上上传了一幅照片,那么从Service的角度,这个资源新产生了,可以给它赋予一个

URI来让Client进行增删改等资源操作了。这些都是Service需要维护的状态。应用程序状态是指客户端的行为。如其访问了分页资源,其当前所在

的页数,之前访问的是哪儿,需不需要再次认证。这些都属于应用程序状态。REST的风格就是,我不会维持这些状态。所有的状态信息需要Client自己提

供。比如认证,客户端需要每次访问时都提供认证。当然这有利有弊,但使得Web Service变得简单。

III- RESTful该如何评价

前面一章我们试图通过对比的方法来理解REST架构,但我们该如何定义一个Web Services是RESTful的,或不是RESTful的呢?还是Richardson这哥么,他把REST的一些原则特性细化成一系列可执行的步骤,提出了自己的REST成熟度模型。并再一次QCon的演讲中把它形象化为REST荣耀之路

图中把REST成熟度分为0-3级。

第0级是指没有使用REST,仍然淹没在RPC的人流中。把HTTP协议当做一种跟Web上远程系统交互的传输机制,所谓的POX(Plain Old XML)指的就是与SOAP,XML,JSON RPC类似的机制。

第1级是指引入了Resource的概念。交互的方式不再是单一的Endpoint下的传输体中不同方法的封装,而是能够针对每一个独立的资源实体,有相应的URI。我们的操作方法不再是零散的参数传递,而是在这个资源实体上的方法调用。

第2级是指引入了我们前面提到的HTTP Verb和Response Code。我们不依赖于传入自定义的操作方法,而是利用HTTP协议本身的优势。当我们想查询一个资源时候用GET,想更新一个资源时用PUT,想创建一个资源时用POST关于POST和PUT的差别,统一的观点是:当Client知道待更新资源的URI,就用PUT。当Client不知道待更新资源的URI,只是把资源给Service,让它来决定资源的URI,就用POST。

第3级就是Fielding所说的Hypertext As the Enginee of Application State(HATEOAS)。也就指示了State Transfer的含义。通过Hypermedia的响应来引导Client的下一步行为。当Client能够以一种可以预测的方式来探索Service的调用接口。更详细的介绍可以参考末尾的引用。

当然这个成熟度模型可以很好的表达REST,但并不是唯一的标准,也有很多人提出了质疑和自己的看法。但山人认为,它至少能够帮助我们以一种逻辑的方式让我们对什么是RESTful有了更为深入和清晰的理解。

So long, and thanks for all the fish!

参考

[1].Do-You-Really-Know-Why-You-Prefer-Rest-over-Rpc.

[2].Rest Arch Style

[3].Measuring-Rest

[4].Rest in Practice

[5].Richardson Maturity Model

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

推荐阅读更多精彩内容