睡觉资源应该使用单数命名约定还是复数命名约定？ [英] Should I use Singular or Plural name convention for REST resources?

问题描述

我是睡觉新手，我观察到在一些基于REST的服务中，它们使用不同的资源URI进行更新/获取/删除和创建。如

• CREATE-在某些地方使用/resource和POST方法(请注意复数)/resource(单数)
• 更新-将/resource/123与PUT方法配合使用
• Get-将/resource/123与GET方法配合使用

我对这个URI命名约定有点困惑。我们应该使用复数还是单数来创建资源？决定这一点的标准应该是什么？

推荐答案

使用/resources的前提是表示"所有"资源。如果执行GET /resources，很可能会返回整个集合。通过发布到/resources，您正在向集合中添加内容。

但是，可以在/resource上找到各个资源。如果您执行GET /resource，则很可能会出错，因为此请求没有任何意义，而/resource/123完全有意义。

使用/resource而不是/resources类似于使用文件系统和文件集合，/resource是包含单个123、456文件的"目录"。

这两种方法都没有对错之分，随你喜欢吧。

这篇关于睡觉资源应该使用单数命名约定还是复数命名约定？的文章就介绍到这了，希望我们推荐的答案对大家有所帮助，也希望大家多多支持IT屋！