基本介绍
从 v2.0
版本开始,框架的 Server
组件额外提供了规范化的路由注册方式,更加适合团队规范化的使用场景、业务复杂度更高的项目。规范路由实现了以下特性:
- 规范化
API
按照结构化编程设计 - 规范化
API
接口方法参数风格定义 - 更加简化的路由注册与维护
- 统一接口返回数据格式设计
- 保障代码与接口文档同步维护
- 自动的
API
参数对象化接收与校验 - 自动生成基于标准
OpenAPIv3
协议的接口文档 - 自动生成
SwaggerUI
页面
tip
注意一下哦: 规范路由 与原有的 函数、对象、分组 路由方式都是框架的 HTTP Server
组件并存支持的路由注册方式,是为了解决一些规范化和自动化管理接口的场景,更适用于团队多人协作使用。其他的路由方式,特别是框架 v1
版本的函数、对象注册方式也是在新版本支持的哈!看个人使用习惯进行合理选择哟。
相关文档
📄️ 规范路由-基本示例
配置文件
📄️ 规范路由-如何使用
路由方法定义
📄️ 规范路由-常见问题
在规范路由下,同一接口如何支持多种 HTTP Method 提交方式