通过示例了解REST

我唯一真正了解REST的想法是通过Ruby on Rails的RESTful路由.这适合我使用Rails构建的基于CRUD的应用程序,但因此我对RESTfulness的理解有限.

假设我们有一个有限的项集合,每个项目都有一个唯一的ID,以及许多属性,例如颜色,形状和大小(某些项目可能未定义).

客户可以在一段时间内使用项目,但每个项目只能由一个客户端一次使用.对项目的访问由服务器管理.客户端可以请求从服务器临时使用某些项目.

通常,客户端只对访问具有特定属性的多个项目感兴趣,而不是访问特定项目.

当客户端请求使用多个项目时,服务器会使用与请求相对应的ID列表进行响应,或者使用响应来响应所请求的项目当前不可用或不存在.

客户可以提出以下类型的请求:

告诉我有多少绿色三角形项目(总数/可用).

给我使用200个大红色物品.

我已经完成了第21,23,23项.

添加100个新的红色正方形项目.

删除50个小绿色项目.

修改所有大黄色五边形项目为蓝色.

上面的玩具示例就像我最近必须处理的资源分配问题.我应该如何RESTful地思考它？

理解的诀窍是从关注名词而不是动词来思考问题.

在其他世界中,动词都是"预设",名词变得无限灵活.在肥皂或大众世界中,动词是无限灵活的.限制你的思维来锁定动词,然后看看你需要什么样的名词来解决你的问题.

这正是darrel在上面的答案中所做的 - 他为一个满足你的约束的锁定了一个新的名词,然后设置了对它们的访问以实现你想要的.

您的一些问题是搜索或过滤器相关 - 对于那些考虑GET的资源类型,传入查询参数来限制或过滤结果.

如果资源锁定确实是您的方案中的域关注点,那么我建议将锁建模为资源.

以下是关于如何处理您建议的请求的一些建议.

GET /Triangle/Green/Count
GET /Triangle/Green/Available

POST /Item/Red/Large/Locks?quantity=200

DELETE /Item/21/Lock
DELETE /Item/23/Lock
DELETE /Item/25/Lock

POST /Square/Red?quantity=100

DELETE /Item/Green/Small?quantity=100

POST /Pentagon/Blue?url=/Pentagon/Yellow

话虽如此,定义URL有点无关紧要.使用适当的链接关系设计媒体类型是RESTful设计的关键部分.