优雅地管理 api 版本控制下的文件结构
在 api 版本控制中，如何设置文件结构以避免代码重复和混乱，是一项常见挑战。两种常见的解决方案，即完全复制粘贴或继承已有代码，都存在一定限制。
针对这一问题，推荐采用以下优雅的文件结构：
src |-- api | |-- v1 | | |-- controllers | | | |-- user.js | | | |-- movie.js | | |-- routes | | |-- index.js | |-- v2 | |-- controllers | | |-- user.js (继承 v1 user 控制器并覆盖必要方法) | | |-- movie.js (继承 v1 movie 控制器并覆盖必要方法) | |-- routes | |-- index.js |-- services | |-- user.js | |-- movie.js |-- models | |-- user.js | |-- movie.js |-- config |-- db
该结构结合了两种先前解决方案的优点，通过以下特性实现优雅的文件管理：
- 清晰的目录结构: 版本化的 api 路由、控制器、服务和模型文件被组织到各自的子目录中。
- 最小重复代码: 继承机制允许 v2 控制器仅覆盖必需的方法，从而最大程度地减少代码重复。
- 易维护性: 各个版本的文件明确隔离，便于维护和更新。
- 版本化的路由: 每个 api 版本都有自己的路由文件，允许同时运行多个版本。
通过采用这种文件结构，您可以轻松管理不同版本的 api，最大程度地减少代码重复，同时保持工程结构清晰简洁。
