在 Maven 构建中验证 Swagger 2.0 规范?

Validate a Swagger 2.0 spec in Maven build?

我正在按照设计优先的方法在 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 下的 swagger JSON 文档。

您可以在此处克隆项目:https://github.com/navidsh/maven.swagger.validator