Swagger 2.0离线验证

Question

我知道有一种工具可以进行在线验证：

http://online.swagger.io/validator?url=http://petstore.swagger.io/v2/swagger.json

我正在编写一个< code>JUnit测试来验证项目的< code>swagger.json文件。这种验证可以离线完成，这一点很重要，因为测试是以< code>localhost的身份运行的，并且验证工具不能访问本地主机服务器。

那么，是否可以离线验证Swagger 2.0 JSON文件？

Answer 1

我用fge/json模式验证器和Jackson完成了一个Swagger验证器。它使用Swagger 2.0模式进行验证。

https://gist.github.com/mariosotil/e1219d4e946c643fe0e5

@Singleton
public class SwaggerValidator {

    public ArrayNode validate(JsonNode jsonNode) {
        return Optional.of(jsonNode)
                .map(this::validateWithinSwaggerSchema)
                .map(this::getMessagesAsJsonArray)
                .get();
    }

    // [...]
}

Answer 2

我已经创建了一个Maven项目，如果您决定使用Maven来运行您的测试，它将验证swagger JSON文档。

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

Answer 3

我对这个来自亚特兰蒂斯的验证者非常满意：https://bitbucket.org/atlassian/swagger-request-validator

仍然有积极的开发，所以我想他们也会为 OpenAPI 3 提供一些东西。