AskOverflow.Dev

AskOverflow.Dev Logo AskOverflow.Dev Logo

AskOverflow.Dev Navigation

  • 主页
  • 系统&网络
  • Ubuntu
  • Unix
  • DBA
  • Computer
  • Coding
  • LangChain

Mobile menu

Close
  • 主页
  • 系统&网络
    • 最新
    • 热门
    • 标签
  • Ubuntu
    • 最新
    • 热门
    • 标签
  • Unix
    • 最新
    • 标签
  • DBA
    • 最新
    • 标签
  • Computer
    • 最新
    • 标签
  • Coding
    • 最新
    • 标签
主页 / coding / 问题 / 78820105
Accepted
vladimir_1969_2
vladimir_1969_2
Asked: 2024-08-01 17:17:03 +0800 CST2024-08-01 17:17:03 +0800 CST 2024-08-01 17:17:03 +0800 CST

REST URL 设计注意事项

  • 772

我负责为一个相对较小的应用设计路由系统(以及 URL 结构)。应用本身应提供添加“根”级实体的功能以及从父级上下文添加子(嵌套)实体的能力。

考虑以下示例设置:

  • 根实体:Dogs。
  • 子实体:Vaccinations

我有以下 UI 路由(BE 路由很容易,因为它总是平坦的,而且我可以利用 VERB 来发挥我的优势):

注意:获得超过 1 级嵌套的机会非常小,但如果它们实现,则可能会成为一个问题......

根级别:

  • 得到: /dogs?param1=value1&...
  • 邮政: /dogs/add
  • 放: /dogs/10/update
  • 删除 /dogs/10/delete
  • 风俗 /dogs/10/custom

嵌套级别:

  • 得到: /dogs/10/vaccinations?param1=value1&...
  • 邮政: /dogs/10/vaccinations/add
  • 放: /dogs/10/vaccinations/25/update
  • 删除:/dogs/10/vaccinations/25/delete
  • 风俗:/dogs/10/vaccinations/25/custom

虽然这对我来说有效,但我可以看到另一种可行的方法,即:

/dogs/10/vaccinations/25/add

人们会使用:

/dogs/10/addvaccination/25

这会导致 URL 稍微变短,但会产生与脱离资源符号相关的处理开销 - 即addvaccination需要收敛到vaccinations+ add。

我知道 REST 只是一套建议,所以我想看看人们对我最初的方法有何看法,并可能收集任何其他关注/建议。

rest
  • 1 1 个回答
  • 23 Views

1 个回答

  • Voted
  1. Best Answer
    VoiceOfUnreason
    2024-08-01T20:35:20+08:002024-08-01T20:35:20+08:00
    1. REST 并不关心你为资源标识符选择什么拼写。只要你遵守RFC 3986中的生产规则,你的资源标识符就可以了。具体来说,对于 HTTP,约束要严格一些;请参阅RFC 9110。如果你选择能够支持 URI 模板的拼写,人们的生活就会轻松很多;请参阅RFC 6570

    2. 您的资源模型不是您的域模型或数据模型。想想“关于狗 10 的文档”而不是“狗 10”。

    3. 每种 HTTP 方法都有不同的资源,这使得通用缓存更加困难。如果 HTTP 请求的目的是修改关于狗 10 的文档,那么您确实希望 URI 的拼写与用于获取关于狗 10 的文档副本的拼写相同。

    GET /dogs/10
    PUT /dogs/10
    DELETE /dogs/10
    

    有关不安全方法和缓存的影响的详细信息,请参阅RFC 9111 。

    1. REST 不关心“嵌套”
    /dogs/10
    /dogs/10/vaccinations
    

    就 REST/HTTP 而言,这是两种不同的资源,它们不需要以任何方式相互关联。

    REST 和 HTTP 都为我们设计 URI 提供了很大的自由;我们可以利用其中的一些自由来选择易于人类映射到资源本身的语义的拼写,但机器并不关心。

    机器确实知道引用解析和点段(请参阅RFC 3986),因此考虑简化对相关文档的相对引用的 URI 拼写约定是合理的。例如,比较:

    /dogs/10/vaccinations * .. = /dogs/10
    /vaccinations/dogs/10 * .. = /vaccinations/dogs
    

    /vaccinations/dogs/10很好,机器会做正确的事情,但所提供的选项/dogs/10/vaccinations可能更有用。

    • 1

相关问题

  • Heroku 不提供媒体字段

  • 为什么 Kafka 被认为比 REST 更稳定?

  • 在 GET 请求中发送广泛过滤器而不超出标头限制的最佳实践

  • 使用 microsoft graph apirest 设置 sharepoint 驱动器项目的查找字段值

  • GraphQL 能做什么而 REST 不能做什么?[关闭]

Sidebar

Stats

  • 问题 205573
  • 回答 270741
  • 最佳答案 135370
  • 用户 68524
  • 热门
  • 回答
  • Marko Smith

    Vue 3:创建时出错“预期标识符但发现‘导入’”[重复]

    • 1 个回答
  • Marko Smith

    为什么这个简单而小的 Java 代码在所有 Graal JVM 上的运行速度都快 30 倍,但在任何 Oracle JVM 上却不行?

    • 1 个回答
  • Marko Smith

    具有指定基础类型但没有枚举器的“枚举类”的用途是什么?

    • 1 个回答
  • Marko Smith

    如何修复未手动导入的模块的 MODULE_NOT_FOUND 错误?

    • 6 个回答
  • Marko Smith

    `(表达式,左值) = 右值` 在 C 或 C++ 中是有效的赋值吗?为什么有些编译器会接受/拒绝它?

    • 3 个回答
  • Marko Smith

    何时应使用 std::inplace_vector 而不是 std::vector?

    • 3 个回答
  • Marko Smith

    在 C++ 中,一个不执行任何操作的空程序需要 204KB 的堆,但在 C 中则不需要

    • 1 个回答
  • Marko Smith

    PowerBI 目前与 BigQuery 不兼容:Simba 驱动程序与 Windows 更新有关

    • 2 个回答
  • Marko Smith

    AdMob:MobileAds.initialize() - 对于某些设备,“java.lang.Integer 无法转换为 java.lang.String”

    • 1 个回答
  • Marko Smith

    我正在尝试仅使用海龟随机和数学模块来制作吃豆人游戏

    • 1 个回答
  • Martin Hope
    Aleksandr Dubinsky 为什么 InetAddress 上的 switch 模式匹配会失败,并出现“未涵盖所有可能的输入值”? 2024-12-23 06:56:21 +0800 CST
  • Martin Hope
    Phillip Borge 为什么这个简单而小的 Java 代码在所有 Graal JVM 上的运行速度都快 30 倍,但在任何 Oracle JVM 上却不行? 2024-12-12 20:46:46 +0800 CST
  • Martin Hope
    Oodini 具有指定基础类型但没有枚举器的“枚举类”的用途是什么? 2024-12-12 06:27:11 +0800 CST
  • Martin Hope
    sleeptightAnsiC `(表达式,左值) = 右值` 在 C 或 C++ 中是有效的赋值吗?为什么有些编译器会接受/拒绝它? 2024-11-09 07:18:53 +0800 CST
  • Martin Hope
    The Mad Gamer 何时应使用 std::inplace_vector 而不是 std::vector? 2024-10-29 23:01:00 +0800 CST
  • Martin Hope
    Chad Feller 在 5.2 版中,bash 条件语句中的 [[ .. ]] 中的分号现在是可选的吗? 2024-10-21 05:50:33 +0800 CST
  • Martin Hope
    Wrench 为什么双破折号 (--) 会导致此 MariaDB 子句评估为 true? 2024-05-05 13:37:20 +0800 CST
  • Martin Hope
    Waket Zheng 为什么 `dict(id=1, **{'id': 2})` 有时会引发 `KeyError: 'id'` 而不是 TypeError? 2024-05-04 14:19:19 +0800 CST
  • Martin Hope
    user924 AdMob:MobileAds.initialize() - 对于某些设备,“java.lang.Integer 无法转换为 java.lang.String” 2024-03-20 03:12:31 +0800 CST
  • Martin Hope
    MarkB 为什么 GCC 生成有条件执行 SIMD 实现的代码? 2024-02-17 06:17:14 +0800 CST

热门标签

python javascript c++ c# java typescript sql reactjs html

Explore

  • 主页
  • 问题
    • 最新
    • 热门
  • 标签
  • 帮助

Footer

AskOverflow.Dev

关于我们

  • 关于我们
  • 联系我们

Legal Stuff

  • Privacy Policy

Language

  • Pt
  • Server
  • Unix

© 2023 AskOverflow.DEV All Rights Reserve