Provide builder in SwaggerValidator that takes JsonNode as schema

[dmak]

In case when Swagger YAML contains both schema and examples, it is necessary to keep the reference to a whole document. Currently the only way out is to parse Swagger YAML twice:

JsonNode swaggerSpec;
SwaggerValidator validator;

try (InputStream in = getClass().getResourceAsStream("/htdoc/annotations.yaml")) {
    swaggerSpec = Yaml.mapper().readTree(in);
}

try (InputStream in = getClass().getResourceAsStream("/htdoc/annotations.yaml")) {
    validator = SwaggerValidator.forYamlSchema(new InputStreamReader(in, StandardCharsets.UTF_8));
}

ProcessingReport report = validator.validate(swaggerSpec.at("/components/examples/createRequest"), "/components/schemas/createRequest");

if (!report.isSuccess()) {
  ...
}

Suggestion:

JsonNode swaggerSpec;
SwaggerValidator validator;

try (InputStream in = getClass().getResourceAsStream("/htdoc/annotations.yaml")) {
    swaggerSpec = Yaml.mapper().readTree(in);
    validator = SwaggerValidator.forJsonSchema(swaggerSpec);
}

...