旧文档swagger2.0转化为openapi格式方案

旧文档 swagger2.0 转化为 openapi 格式方案

摘要

在项目中,我们整合了swagger2.0语法与自定义返回数据结构,解决了文档描述与参数映射分离问题。通过引入参数定义,统一了文档生成、解析、验证和赋值流程,确保控制器获取准确请求数据。同时,我们调整了路由方案,增加了适配器以兼容旧路由解析方法,并预生成文档结构,实现了gf2与旧版路由的统一。这一改进提升了项目维护效率和对接便捷性。