知识卡片
破坏性版本路由的取舍
破坏性API更新需要显式辨别消息格式版本。URL或查询参数易于路由、记录和人工识别;媒体类型能保留实体URL但增加协商与中间件配置;自定义标头灵活但需约定和框架支持;正文版本主要覆盖写请求。版本字段描述消息格式,不应直接等同于应用版本;所有路由采用一致方案可降低调用方记忆负担。
这张卡片看不懂?
这张卡片的反馈已满 10 条,暂时无法继续提交。
已有反馈 · 0 / 10 条
还没有人提交反馈。
在整书笔记中的位置
原书出处 · 1 处
- 处理版本问题 · 查看原书依据
(1) 为URL添加版本辨别字段,可以用前缀形式或查询参数来实现,这是实践中最常见的方法。这种方法的优点是,能轻易地路由到正确的行为;无须任何特殊处理就能共享、存储和通过邮件发送URL;可以通过查询日志,查看随着时间的推移,每个版本使用者的数量;对服务消费者来说,浏览一下URL就能快速确认其正在使用的版本。
参考来源
- 位置:《发布!设计与部署稳定的分布式系统(第2版)》第14章《处理版本问题》(来源项目:book-sources;源文件:extracted/发布!设计与部署稳定的分布式系统(第2版)/_epub-src/OEBPS/Text/epub_0023.html)
- 结论依据:原文以为URL添加版本辨别字段为定位说明上述机制、对比或案例;本卡依据已读正文解释,未把原包缺失图片当作已观察证据。
- 原始内容:(1) 为URL添加版本辨别字段,可以用前缀形式或查询参数来实现,这是实践中最常见的方法。这种方法的优点是,能轻易地路由到正确的行为;无须任何特殊处理就能共享、存储和通过邮件发送URL;可以通过查询日志,查看随着时间的推移,每个版本使用者的数量;对服务消费者来说,浏览一下URL就能快速确认其正在使用的版本。