分布式系统核心：REST风格的架构，REST成熟度模型及REST API管理

成熟度模型

正如前文所述，正确、完整地使用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