1. 首页
  2. 问题
  3. 我应该对 REST 资源使用单数还是复数名称约定？
小编典典

我应该对 REST 资源使用单数还是复数名称约定？

all

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

  • 创建 -在某些地方使用 / resources 和 POST 方法（观察复数）使用 /resource （单数）
  • 更新 - 使用 /resource/123 和 PUT 方法
  • 获取 - 将 /resource/123 与 GET 方法一起使用

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


阅读 228

收藏
2022-03-03

共1个答案

小编典典

使用的前提/resources是它代表“所有”资源。如果您执行 a GET /resources，您可能会返回整个集合。通过发布到/resources，您正在添加到集合中。

但是，各个资源可在 /resource 中获得。如果你做 a GET /resource，你可能会出错，因为这个请求没有任何意义，而/resource/123完全有道理。

使用/resource而不是/resources类似于在使用文件系统和文件集合时执行此操作的方式，并且是/resource其中包含单个文件的“目录”
。123``456

这两种方式都没有对错，选择你最喜欢的。

2022-03-03