成熟度模型
正如前文所述,正确、完整地使用REST是困难的,关键在于RoyFielding所定义的REST只是一种架构风格,它并不是规范,所以也就缺乏可以直接参考的依据。好在Leonard Richardson补充了这方面的不足。
他提出的关于REST的成熟度模型(Richardson Maturity Model),将REST的实现划分为不同的等级。图8-1展示了不同等级的成熟度模型。
添加图片注释,不超过 140 字(可选)
图8-1 REST成熟度模型
第0级:使用HTTP作为传输方式
在第0级中,Web服务只是使用HTTP作为传输方式,实际上只是远程方法调用(RPC)的一种具体形式。SOAP和XML-RPC都属于此级别。比如,在一个医院挂号系统中,医院会通过某个URI来暴露出该挂号服务端点(Service Endpoint)。然后患者会向该URI发送一个文档作为请求,文档中包含了请求的所有细节。
添加图片注释,不超过 140 字(可选)
POST /appointmentService HTTP/1.1 [省略了其他头的信息……] <openSlotRequest date = "2010-01-04" doctor = "mjones"/>
然后服务器会传回一个包含了所需信息的文档。
HTTP/1.1 200 OK [省略了其他头的信息……] <openSlotList> <slot start = "1400" end = "1450"> <doctor id = "mjones"/> </slot> <slot start = "1600" end = "1650"> <doctor id = "mjones"/> </slot> </openSlotList>
在这个例子中我们使用了XML,但是内容实际上可以是任何格式,比如JSON、YAML、键值对等,或者其他自定义的格式。
有了这些信息,下一步就是创建一个预约。这同样可以通过向某个端点发送一个文档来完成。
POST /appointmentService HTTP/1.1 [省略了其他头的信息……] <appointmentRequest> <slot doctor = "mjones" start = "1400" end = "1450"/> <patient id = "jsmith"/> </appointmentRequest>
如果一切正常,那开发者能够收到一个预约成功的响应。
HTTP/1.1 200 OK [省略了其他头的信息……]<appointment> <slot doctor = "mjones" start = "1400" end = "1450"/> <patient id = "jsmith"/> </appointment>
如果发生了问题,比如有人在我前面预约上了,那我会在响应体中收到某条错误信息。
HTTP/1.1 200 OK [省略了其他头的信息……] <appointmentRequestFailure> <slot doctor = "mjones" start = "1400" end = "1450"/> <patient id = "jsmith"/> <reason>Slot not available</reason> </appointmentRequestFailure