org.mule.module.json.internal

Class JsonSchemaValidator.Builder

java.lang.Object

org.mule.module.json.internal.JsonSchemaValidator.Builder

Enclosing class:

JsonSchemaValidator

public static final class JsonSchemaValidator.Builder
extends Object

An implementation of the builder design pattern to create instances of JsonSchemaValidator. This builder can be safely reused, returning a different instance each time build() is invoked. It is mandatory to invoke with a valid value one of the methods that allow setting a value for the schema to be validated against setSchemaLocation(String) or setSchemaContent(String) before attempting to build() an instance

Since:

1.0

Method Summary

Modifier and Type	Method and Description
JsonSchemaValidator.Builder	addSchemaRedirect(String from, String to) Allows to redirect any given URI in the Schema (or even the schema location itself) to any other specific URI.
JsonSchemaValidator.Builder	addSchemaRedirects(Map<String,String> redirects) Allows adding many redirects following the same rules as addSchemaRedirect(String, String)
JsonSchemaValidator.Builder	allowArbitraryPrecision(boolean allowArbitraryPrecision) Determines whether the validator use arbitrary precision when reading floating points values.
JsonSchemaValidator.Builder	allowDuplicateKeys(boolean allowDuplicateKeys) Determines whether the validator should fail when the document contains duplicate keys.
JsonSchemaValidator	build() Builds a new instance per the given configuration.
JsonSchemaValidator.Builder	setDereferencing(JsonSchemaDereferencingMode dereferencing) Sets the dereferencing mode to be used.
JsonSchemaValidator.Builder	setSchemaContent(String schemaContent)
JsonSchemaValidator.Builder	setSchemaLocation(String schemaLocation) A location in which the json schema is present.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Method Detail

setSchemaLocation

public JsonSchemaValidator.Builder setSchemaLocation(String schemaLocation)

A location in which the json schema is present. It allows both local and external resources. For example, all of the following are valid:

schemas/schema.json

/schemas/schema.json

resource:/schemas/schema.json

http://mule.org/schemas/schema.json

Parameters:

schemaLocation - the location of the schema to validate against

Returns:

this builder

setDereferencing

public JsonSchemaValidator.Builder setDereferencing(JsonSchemaDereferencingMode dereferencing)

Sets the dereferencing mode to be used. If not invoked, then it defaults to JsonSchemaDereferencingMode.CANONICAL

Parameters:

dereferencing - a dereferencing mode

Returns:

this builder

Throws:

IllegalArgumentException - if dereferencing is null

allowDuplicateKeys

public JsonSchemaValidator.Builder allowDuplicateKeys(boolean allowDuplicateKeys)

Determines whether the validator should fail when the document contains duplicate keys.

Parameters:

allowDuplicateKeys: - if true, the validator will allow duplicate keys, otherwise it will fail.

Returns:

this builder.

allowArbitraryPrecision

public JsonSchemaValidator.Builder allowArbitraryPrecision(boolean allowArbitraryPrecision)

Determines whether the validator use arbitrary precision when reading floating points values.

Parameters:

allowArbitraryPrecision: - if true, the validator will use arbitrary precision for floating point values.

Returns:

this builder.

addSchemaRedirect

public JsonSchemaValidator.Builder addSchemaRedirect(String from,
                                                     String to)

Allows to redirect any given URI in the Schema (or even the schema location itself) to any other specific URI. The most common use case for this feature is to map external namespace URIs without the need to a local resource

Parameters:

from - the location to redirect. Accepts the same formats as setSchemaLocation(String)

to - the location to redirect to. Accepts the same formats as setSchemaLocation(String)

Returns:

this builder

Throws:

IllegalArgumentException - if from or to are blank or null

addSchemaRedirects

public JsonSchemaValidator.Builder addSchemaRedirects(Map<String,String> redirects)

Allows adding many redirects following the same rules as addSchemaRedirect(String, String)

Parameters:

redirects - a Map with redirections

Returns:

this builder

Throws:

IllegalArgumentException - if redirects is null

setSchemaContent

public JsonSchemaValidator.Builder setSchemaContent(String schemaContent)

Parameters:

schemaContent - the content of the schema against which it is validated

Returns:

this builder

build

public JsonSchemaValidator build()

Builds a new instance per the given configuration. This method can be safely invoked many times, returning a different instance each. There is a mutually exclusive relationship between the attributes schemaLocation and schemaContent. Only one is allowed at a time, you cannot use both at the same time.

Returns:

a JsonSchemaValidator

Throws:

org.mule.runtime.extension.api.exception.ModuleException

org.mule.runtime.api.exception.MuleRuntimeException