读发布！设计与部署稳定的分布式系统（第2版）笔记31_版本问题

躺柒 / 2023-08-14 / 原文

1. 在软件与外部环境之间的许多交汇点上，版本控制基本上处于混乱状态

1.1. 不应该为了更新自身系统的API，而让服务消费者被迫与你同时发布新版本

1.2. 多数服务新版本的发布应该具有兼容性

2. 分层的“约定”栈

2.1. 连接握手和持续时间

2.2. 请求组帧

2.3. 内容编码

2.4. 消息语法

2.5. 消息语义

2.6. 鉴权和身份验证

3. 对请求要协变

3.1. covariant request

4. 对响应要逆变

4.1. contravariant response

5. 即

5.1. 可以比以往提出的要求更少

5.2. 可以比以往接受的可选信息更多

5.3. 可以比以往返回的响应更多

5.4. 可以类比必填参数和可选参数

6. 安全的变更

6.1. 在参数上强制执行以前所需约束的子集

6.2. 返回以前可返回值的超集

6.3. 接受以前可以接受的参数的超集

6.4. 要求必须填写以前必填参数的一个子集

7. 生成式测试技术

8. 破坏API的变更

8.1. 减少API破坏性变更影响的第一个先决条件是在请求和回复消息格式中添加一个版本号字段

8.2. 为URL添加版本辨别字段，可以用前缀形式或查询参数来实现

8.2.1. 同一实体的不同表示看起来像是不同的资源，而这在REST世界中是禁忌

8.3. 使用PUT和POST上的Content-Type标头指示正在发送的版本

8.3.1. 可以为版本定义一个媒体类型application/vnd.lendzit.loan-request.v1和一个新的媒体类型application/vnd.lendzit.loan-request.v2

8.3.2. 优点

8.3.2.1. 在数据库中存储的所有URL都可以继续工作，客户端无须更改路由就可升级

8.3.3. 缺点

8.3.3.1. 单单凭借URL已经不够区分版本了，像application/json和text/xml这样的通用媒体类型根本提供不了任何帮助

8.3.3.2. 客户端必须事先知道存在这种特殊的媒体类型，以及所有允许的媒体类型

8.3.3.3. 一些框架虽然支持基于媒体类型的路由，但配置起来会有难度

8.4. 仅针对PUT和POST，在请求正文中添加一个字段来指示预期版本

8.4.1. 优点是不需要路由，易于实施

8.4.2. 缺点是无法涵盖所需要的所有场景

8.5. 使用特定于应用程序的自定义标头指示所需的版本

8.5.1. 可以定义一个类似api-version的标头

8.5.2. 优点是具有完全的灵活性，并且与媒体类型和URL正交

8.5.3. 缺点

8.5.3.1. 要为特定框架编写路由处理器

8.5.3.2. 这个标头是另一个必须与服务消费者分享的秘密

8.6. 服务提供方都必须在一段时间内同时支持旧版本和新版本

8.7. 如果要在一些URL中添加版本信息，那么务必同时在所有路由中都添加这个版本

8.7.1. 即使这次变更只涉及一个路由，也不要强制用户记住哪些版本号对应哪些API

8.8. 只要不影响未来进行的变更，尽可能地减少代码重复

9. 处理其他系统的版本问题

9.1. 软件应该保持杞人忧天的状态

9.2. 虽然请求规范中添加了一些新字段，但并不意味着所有人都会遵守新规范

9.3. 请求端与响应端检查自己是否符合规范

9.4. 将测试分为不同的部分，有助于隔离通信中的故障，并能使代码更加稳健

9.4.1. 我们不会再对另一方的行为做出不合理的假设

读发布！设计与部署稳定的分布式系统（第2版）笔记31_版本问题更多相关文章

Redis持久化机制（面试考点）与位图API

爬虫--识别验证码

TZYLT's 2024CSP-S游记

「CSP2024」游记

js模拟构造函数的实现过程

god father

划水

命令拼接技巧

SD NAND 与 SPI NAND

C语言中的编译过程详解

step7 V5.x上的SCL

yolo --- 核心思想

一些学科笑话

NOIP2024模拟赛20 & 11.1 小记

20241101 数据结构与算法期中机试收获

什么是IT技术

即将到来！

舍得-时间-工作是人的一生最重要的事情-自己要有私房钱-人的一生最重要的事情是书写自己的人生

2.TiUP 部署 DM 集群

ubuntu 24.04 部署 mysql 8.4.3 LTS

随机推荐

SD NAND 与 SPI NAND

C语言中的编译过程详解

step7 V5.x上的SCL

yolo --- 核心思想

【游记】CCPC 济南 2024 游记

AJAX & AXIOS-2024/11/1

验证码处理在自动化测试中的应用

一些学科笑话

NOIP2024模拟赛20 & 11.1 小记

20241101 数据结构与算法期中机试收获

Java，启动！

什么是IT技术

即将到来！

2024/11/1日 日志 关于JavaScript简介&引入方式 以及基础语法的学习

舍得-时间-工作是人的一生最重要的事情-自己要有私房钱-人的一生最重要的事情是书写自己的人生

2.TiUP 部署 DM 集群

原型模式的C++实现

python bytecode解析

09-XSS键盘监听、cookie窃取&文件上传绕过

ubuntu 24.04 部署 mysql 8.4.3 LTS

热门话题

Ethernaut Level 11: Elevator Attack and Blockchain Interaction

快速部署开源spug运维平台的Docker安装指南

驱动调试之printk的原理与使用

计算机思维模型及其应用

华为云发布代码大模型PanGu-Coder2，实现高效代码生成

Linux多硬盘数据存储和分区操作

构建高可用架构: 分层冗余与自动故障转移

LoRA：高效调参的大语言模型适应方法

《分布式系统的基本原理及互联网分层架构的本质》

Hadoop写流程解析

Java架构师的系统架构设计方法论中的规范要点

使用observeDOM解决BetterScroll插件在移动端无法滑动的问题

互联网一致性架构设计实践

高并发系统架构与水平扩展

混合应用的崛起：跨平台开发取代原生应用

  穗舟网 （www.seizhou.com）

本站除标明"本站原创"外所有文章版权归创作人所有，本站不承担任何法律责任和连带责任，如有冒犯请直接联系，我们将立即予以纠正并致歉。

Powered by WordPress  ·  v1.0.0-alpha