为什么RESTful Web服务设计可以帮你思考正确的事情

1. RESTful是资源丰富的

我很欣赏RESTful服务如何迫使我在资源方面进行思考。资源只是API中表示的内容。它不是数据库表，甚至不必是域模型的实体。它构成了整个API的框架。将你的API视为消费者可以操纵的一组资源。RESTful思维模式鼓励你思考真正重要的事项。

除此之外，只有一系列有限的方法可以对这些资源起作用：GET、POST、PUT、PATCH和DELETE。它还有一些其他用途，但这些是较大的。这并不意味着你的整个API将变为CRUD（Create, Read, Update, Delete，中译：增删改查）。 这意味着在关注其执行的操作之前，你将首先关注系统中的内容。

2.形式高于功能

在采用HTTP服务时，采用已知模式(如JSON模式)也是有益的。基于restful的服务真正打开了一扇门，可以选择一个健壮的模式规范，它周围有很多工具。在向消费者展示数据方面，我发现这比我自己的系统要好得多。使用JSON模式这样的已知数据建模，消费者可以很容易地知道他们要返回的数据的形状。您还可以让他们知道是否需要请求字段。 您的消费者甚至可以从中创建验证器。

3.RestFUL,不是REST

通常情况下，完全REST和使用超媒体并不常见。然而，使用RESTful服务可以帮助我考虑我的消费者将如何使用我的API。即使链接没有拼写出来，我也经常从入口点出发，通过连接的资源链来理解我的消费者可能如何使用我的API。这可以帮助我找到丢失的资源或没有意义的资源。

4.RESTful有助于填补这些空白

一旦我有了资源，我发现浏览一下主要的方法很有帮助:GET、POST、PUT、PATCH和DELETE。这让我看到资源是否为只读的。我可以编辑现有的还是只创建新的?也许资源足够大，需要通过补丁进行部分更新。消费者应该能够移除它吗?这些是我经常思考的问题。

5.想想那些不幸的道路

我发现查看HTTP状态代码对了解在资源操作上时会很有用。无法找到资源吗?我如何知道是消费者犯了错误(4xx)而不是服务器(5xx)?这个资源(409)可能存在并发问题吗?我把状态代码列表当作一个指南，引发诸如此类的问题，并引导我的思想走向一个健壮的API。

6.告诉世界怎么停止给你打电话

啊,缓存。你知道，当我阅读HTTP规范时，它让我大吃一惊，我意识到我们可以在客户端缓存，但让服务器告诉我们如何做。现在看来很明显，但这仍然很强大。在HTTP工作中自然会让我认识到我的资源有很多可以缓存，并让我专注于如何教消费者缓存它们。

你可以花很多时间来确定自己的习惯。您可以为诸如“我如何告诉我的消费者如何缓存”或“我如何告诉我的消费者他们犯了错误?”或者你可以屈服于老板的压力，“把事情做好”。但是如果你真的想要一个好的设计，看看RESTul web服务。如果这个范例符合您的需求，那么就让它来引导您的思维，让它为您的API提供健康的特性。解放你的思想，专注于真正重要的事情。RESTful web服务让您关注如何使您的API可用且简单。