系统项目设计

Question

需要开发一个系统A，A系统所需要的数据比较庞杂，需要从B，C，D，E系统分别获取不同的数据组装成自己需要的格式，在使用接口的情况下，BCDE系统的更新，或对接口的修改会导致A系统可用性极差，针对这种场景，A系统如何设计？

Answer 1

这个问题应该更多改为BCDE应该如何设计. BCDE作为服务者, 应该更多考虑如何让消费者更方便地使用, 而不是让消费者来为服务者的随意设计变更.

BCDE需要做好:

• 在设计API的时候就尽量考虑好接口签名, 尽量避免以后频繁变动.
• 接口传输数据的对象DTO要单独设计, 而不是要直接使用持久层的实体类.
• 接口实现变动的时候, 尽量要向后兼容.
• 如果对接口改动较大, 为了向后兼容, 会让代码可读性和可维护性变差, 那么新增一个接口.

• 版本化. 如果大量接口或者整个业务逻辑变动极大, 那么新开类似 v2 这样的版本号.
  版本化的常见方式有:

  • 虚拟路径: api.domain.com/v1, api.domain.com/v2, ...
  • 域名: v1.api.domain.com, v2.api.domain.com, ...