12、构建可扩展与可修改的 API 及客户端应用

构建可扩展与可修改的 API 及客户端应用

在当今的软件开发中，API 的设计与使用至关重要。无论是 API 的消息格式设计，还是服务接口的修改，亦或是客户端应用的开发，都需要遵循一定的原则和方法，以确保系统的稳定性、可扩展性和兼容性。

1. 设计可扩展的消息

在设计 API 消息时，需要考虑如何在不破坏现有结构的前提下进行扩展，以适应未来可能的变化。以下是几种常见的扩展方法：
- 添加属性集合 ：在初始设计中包含一个名值对（NVP）集合，这样可以在不破坏现有结构的情况下添加新的属性。

{
  "name": "Merk Muffly",
  "region": "southwest",
  "age": 21,
  "nvp" : [
    {"hatsize" : "3"},
    {"phoneNumbers": ["123-456-7890","980-657-3421"]},
    {"address": {"street":"...","city":"...","state":"...","zip":"..."}}
  ]
}

• 添加并行属性 ：当需要修改或扩展现有属性时，可以添加新的相关属性，而不是替换原属性。这样可以同时支持新旧两种格式。

{
  "givenName": "Merk",
  "familyName": "Muffly",
  "name": "Merk Muf