知识卡片
服务演化的兼容方向
通过服务流动的数据可以做一个简化假设:所有服务器先升级,然后才是所有客户端。因此只需要:
- 请求具有向后兼容性(新服务器能读旧客户端的请求);
- 响应具有向前兼容性(旧客户端能读新服务器的响应)。
兼容性从编码格式继承:Thrift、gRPC(Protobuf)、Avro RPC 按各自格式规则演化;SOAP 用 XML 模式,能演化但有微妙陷阱;RESTful API 通常用无正式模式的 JSON,添加可选请求参数、给响应对象加新字段一般视为兼容的改变。
跨组织时更难:服务提供者无法控制客户、不能强迫其升级,兼容性可能要无限期保持;需要破坏性变更时往往并排维护多个 API 版本。版本如何指定没有共识:RESTful API 常把版本号放在 URL 或 HTTP Accept 头;用 API 密钥识别客户的服务,也可以把客户请求的版本存在服务器上,通过单独的管理界面更新。
REST 与 RPC 的分工:新一代 RPC 框架(gRPC、Finagle、Rest.li)更明确地承认远程调用不同于本地调用——用 future 封装可能失败的异步操作、支持流式调用、提供服务发现;自定义二进制 RPC 性能可以优于 JSON over REST。但 REST 便于实验和调试(浏览器或 curl 即可)、所有主流语言都支持、工具生态庞大。所以 REST 是公共 API 的主要风格,RPC 主要用于同一组织内、通常同一数据中心内的服务之间。
这张卡片看不懂?
这张卡片的反馈已满 10 条,暂时无法继续提交。
已有反馈 · 0 / 10 条
还没有人提交反馈。
在整书笔记中的位置
原书出处 · 1 处
- 第四章:编码与演化 · 查看原书依据
假定所有的服务器都会先更新,其次是所有的客户端。因此,您只需要在请求上具有向后兼容性,并且对响应具有前向兼容性。
参考来源
- 位置:《数据密集型应用系统设计》第04章《第四章:编码与演化》服务中的数据流:REST与RPC·RPC的当前方向;数据编码与RPC的演化(源文件:extracted/数据密集型应用系统设计/_epub-src/ch4_split_003.html,来源项目 book-sources)
- 结论依据:第四章“RPC的当前方向”说明新一代RPC框架的future、流与服务发现及REST与RPC的适用范围;“数据编码与RPC的演化”说明服务器先于客户端升级时请求需向后兼容、响应需向前兼容,各编码的兼容性继承关系,跨组织服务的长期兼容与API版本化方式。
- 原始内容:假定所有的服务器都会先更新,其次是所有的客户端。因此,您只需要在请求上具有向后兼容性,并且对响应具有前向兼容性。