Contact Us 1-800-596-4880

JSON Module Reference - Mule 4

JSON Module v2.1

The JSON module provides extra functionality for processing JSON documents. Although DataWeave is the tool that Mule uses to access data in JSON documents, this module provides extra functionality that falls outside of DataWeave’s scope, like schema validation.

Release Notes: JSON Module Release Notes

Configurations


Default Configuration

Default configuration

Parameters

Name Type Description Default Value Required

Name

String

The name for this configuration. Connectors reference the configuration with this name.

x

Operations

Validate Schema

<json:validate-schema>

Validates that the input content is compliant with a given schema. This operation supports referencing many schemas (using comma as a separator) which include each other.

This connector supports JSON Schema Validation Drafts 3 and 4 only.

Parameters

Name Type Description Default Value Required

Schema

String

The location in which the schema to validate against is to be found. This attribute supports URI representations such as http://org.mule/schema.json or "resource:/schema.json". It also supports a most common classpath reference such as simply "schema.json".

x

Content

Any

The JSON document to be validated

#[payload]

Schema Redirects

Array of Schema Redirect

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

Dereferencing

Enumeration, one of:

  • CANONICAL

  • INLINE

Draft v4 defines two dereferencing modes: canonical and inline. CANONICAL will be the default option but INLINE can also be specified. When validating a v3 draft this attribute is ignored.

CANONICAL

Allow Duplicate Keys

Boolean

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

true

Throws

  • JSON:INVALID_INPUT_JSON

  • JSON:INVALID_SCHEMA

  • JSON:SCHEMA_NOT_FOUND

  • JSON:SCHEMA_NOT_HONOURED

Types

Schema Redirect

Field Type Description Default Value Required

From

String

The original location

x

To

String

The redirection location

x

View on GitHub