API 设计中的多类型属性选择：OpenAPI 与 gRPC 的 oneof 与强类型对比
💡
原文中文，约1100字，阅读约需3分钟。
📝
内容提要
本文介绍了在API设计和开发中，如何处理一个属性可以是多种类型中的一个的情况。OpenAPI和gRPC都支持强类型，但在处理oneof时有所不同。无论选择哪种技术，目标都是提供明确、一致和可靠的API描述。
🎯
关键要点
- 在API设计中，一个属性可以是多种类型中的一个，但不能同时是多种类型。
- 常见的接收方式包括范型、key-value形式的map和所有Object接收。
- 这些方式可能导致参数内容不规范、接口维护困难或浪费网络带宽。
- OpenAPI是描述RESTful API的规范，3.0.1版本引入了oneof关键字。
- oneof提供了一种简单、明确的方式来描述一个属性可以是多种类型中的一个。
- gRPC使用Protocol Buffers作为接口定义语言，也有oneof关键字，但用途略有不同。
- gRPC中的oneof为跨语言场景下表示多种数据类型提供了优雅的解决方案。
- 强类型是OpenAPI和gRPC的核心概念，保证数据一致性和提高性能。
- 强类型可以在编译时捕获类型错误，提供清晰的代码信息。
- 尽管OpenAPI和gRPC在处理oneof和强类型时有所不同，但目标是提供明确、一致和可靠的API描述。
➡️
