io.vertx.json.schema

Interface SchemaRepository

public interface SchemaRepository

A repository is a holder of dereferenced schemas, it can be used to create validator instances for a specific schema.

This is to be used when multiple schema objects compose the global schema to be used for validation.

Author:

Paulo Lopes

Method Summary

Modifier and Type	Method and Description
static SchemaRepository	create(JsonSchemaOptions options) Create a repository with some initial configuration.
SchemaRepository	dereference(JsonSchema schema) Dereferences a schema to the repository.
SchemaRepository	dereference(String uri, JsonSchema schema) Dereferences a schema to the repository.
JsonSchema	find(String pointer) Look up a schema using a JSON pointer notation
SchemaRepository	preloadMetaSchema(FileSystem fs) Preloads the repository with the meta schemas for the related @link Draft version.
SchemaRepository	preloadMetaSchema(FileSystem fs, Draft draft) Preloads the repository with the meta schemas for the related draft version.
JsonObject	resolve(JsonSchema schema) Tries to resolve all internal and repository local references.
JsonObject	resolve(String ref) Tries to resolve all internal and repository local references.
Validator	validator(JsonSchema schema) A new validator instance using this repository options.
Validator	validator(JsonSchema schema, JsonSchemaOptions options) A new validator instance overriding this repository options.
Validator	validator(String ref) A new validator instance using this repository options.
Validator	validator(String ref, JsonSchemaOptions options) A new validator instance overriding this repository options.

Method Detail

create

static SchemaRepository create(JsonSchemaOptions options)

Create a repository with some initial configuration.

Parameters:

options - the initial configuration

Returns:

a repository

dereference

SchemaRepository dereference(JsonSchema schema)
                      throws SchemaException

Dereferences a schema to the repository.

Parameters:

schema - a new schema to list

Returns:

a repository

Throws:

SchemaException - when a schema is already present for the same id

dereference

SchemaRepository dereference(String uri,
                             JsonSchema schema)
                      throws SchemaException

Dereferences a schema to the repository.

Parameters:

uri - the source of the schema used for de-referencing, optionally relative to JsonSchemaOptions.getBaseUri().

schema - a new schema to list

Returns:

a repository

Throws:

SchemaException - when a schema is already present for the same id

preloadMetaSchema

SchemaRepository preloadMetaSchema(FileSystem fs)

Preloads the repository with the meta schemas for the related @link Draft version. The related draft version is determined from the JsonSchemaOptions, in case that no draft is set in the options an IllegalStateException is thrown.

Parameters:

fs - The Vert.x file system to load the related schema meta files from classpath

Returns:

a repository

preloadMetaSchema

SchemaRepository preloadMetaSchema(FileSystem fs,
                                   Draft draft)

Preloads the repository with the meta schemas for the related draft version.

Parameters:

fs - The Vert.x file system to load the related schema meta files from classpath

draft - The draft version of the meta files to load

Returns:

a repository

validator

Validator validator(JsonSchema schema)

A new validator instance using this repository options.

Parameters:

schema - the start validation schema

Returns:

the validator

validator

Validator validator(String ref)

A new validator instance using this repository options.

Parameters:

ref - the start validation reference in JSON pointer format

Returns:

the validator

validator

Validator validator(JsonSchema schema,
                    JsonSchemaOptions options)

A new validator instance overriding this repository options.

Parameters:

schema - the start validation schema

options - the options to be using on the validator instance

Returns:

the validator

validator

Validator validator(String ref,
                    JsonSchemaOptions options)

A new validator instance overriding this repository options.

Parameters:

ref - the start validation reference in JSON pointer format

options - the options to be using on the validator instance

Returns:

the validator

resolve

JsonObject resolve(JsonSchema schema)

Tries to resolve all internal and repository local references. External references are not resolved.

The result is an object where all references have been resolved. Resolution of circular references is shallow. This should normally not be a problem for this use case.

Returns:

a new JsonObject representing the schema with $refs replaced by their value.

Throws:

SchemaException - when the resolution is impossible.

resolve

JsonObject resolve(String ref)

Tries to resolve all internal and repository local references. External references are not resolved.

The result is an object where all references have been resolved. Resolution of circular references is shallow. This should normally not be a problem for this use case.

Parameters:

ref - the start resolution reference in JSON pointer format

Returns:

a new JsonObject representing the schema with $refs replaced by their value.

Throws:

SchemaException - when the resolution is impossible.

find

JsonSchema find(String pointer)

Look up a schema using a JSON pointer notation

Parameters:

pointer - the JSON pointer

Returns:

the schema