我正在按照设计优先的方法在 Java/Spring MVC 堆栈上构建 REST API。
我有一个手写的 Swagger 架构,我想在我的 Maven 构建中验证它,如果架构不符合 Swagger 架构规范,我希望该构建失败。
我已经尝试通过使用swagger-codegen
来生成一些静态文档来做到这一点;但是 1) 它没有捕获捕获的错误swagger-editor
;和2)输出不是很好(但这不是重点;-))。
有没有人自己满意地解决了这个问题?
我正在按照设计优先的方法在 Java/Spring MVC 堆栈上构建 REST API。
我有一个手写的 Swagger 架构,我想在我的 Maven 构建中验证它,如果架构不符合 Swagger 架构规范,我希望该构建失败。
我已经尝试通过使用swagger-codegen
来生成一些静态文档来做到这一点;但是 1) 它没有捕获捕获的错误swagger-editor
;和2)输出不是很好(但这不是重点;-))。
有没有人自己满意地解决了这个问题?
您可以在 Maven 构建系统中创建一个额外的步骤,以根据Swagger 2.0 Schema验证 Swagger 文档。
我创建了一个示例 Maven 项目,用于验证/src/main/resources/swagger
.
您可以在此处克隆项目:https ://github.com/navidsh/maven.swagger.validator