redmitry/jaronuinga

Java JSON Schema Validator

THE PROJECT HAS BEEN MOVED TO THE elixir-europe/java-json-schema-validator

Java Json Schema validation library based on JSONP v1.1 Json parser.

import via maven:

<dependencies>
  <dependency>
    <groupId>es.elixir.bsc.json.schema</groupId>
    <artifactId>jaronuinga</artifactId>
    <version>0.5.1</version>
  </dependency>
...
<repositories>
  <repository>
    <id>jaronuinga</id>
    <url>https://inb.bsc.es/maven</url>
  </repository>

The simplest usage:

JsonSchema schema = JsonSchemaReader.getReader().read(url); // parse JsonSchema from the URL location
List<ValidationError> errors = new ArrayList<>(); // array to collect errors
schema.validate(json, errors); // validate JsonObject

Note that instead of URL users could provide their own schema locators. JsonSchemaLocator object is used for JsonSchema URI resolution and as a cache for local Schemas' definitions - to resolve "$ref" Json Pointers.

To provide flexibility it is possible to get callbacks during the validation process.

schema.validate(json, errors, (PrimitiveSchema subschema, JsonValue value, JsonValue parent, List<ValidationError> err) -> {
});

Here above we have:

• subschema - current validating Json (sub)schema
• value - current validating Json value
• err - collected validation errors so far.

Note, that providing ExtendedJsonSchemaLocator (which collects all subschemas as originated jsons), we can associate validated JsonValue with corresponding Json Object which describes the schema:

JsonSchema schema = JsonSchemaReader.getReader().read(locator);
schema.validate(json, errors, (PrimitiveSchema subschema, JsonValue value, JsonValue parent, List<ValidationError> err) -> {
    JsonObject subschemaJsonObject = locator.getSchemas(subschema.getId()).get(subschema.getJsonPointer());
});

We can also stop further parsing on error via the callback:

schema.validate(json, errors, (PrimitiveSchema subschema, JsonValue value, JsonValue parent, List<ValidationError> err) -> {
    throw new ValidationException(new ValidationError(subschema.getId(), subschema.getJsonPointer(), ""));
});