Packages

  • package root

    Documentation for the Axiell Schema Project

    Documentation for the Axiell Schema Project

    Overview

    The Axiell Schema Project provides a small library for validating JSON documents against a JSON Schema. The library conforms to the JSON Schema Draft #7 specification.

    The library is based on a few simple principles, namely:

    • referential transparency. Each of the methods in the library is referentially transparent, that is if the method is called with the same arguments it will always return the same value and the method does not have any side effect (e.g. update globals, change the operating environment, etc).
    • minimal functionality. The library is designed to be small incorporating a small number of dependencies. The number of methods associated with a class/object is restricted to those that provide a base level of functionality.
    • support multiple JSON libraries. It should be possible to use the library with any number of different JSON library packages (e.g json4s, jackson, etc). The current library only supports json4s, but a facade approach should be added to hide individual library implementations.
    • generic "format" implementations. The JSON Schema specification mandates a standard set of "format" types that can be used to validate string values. Each "format" type is implemented as a class with the components of the type available.
    • full error handling. Error resulting from the validation process are returned as a list of validation failures. All possible errors should be returned for a single call, eliminating the need to fix a single error and then recall a method.

    Package structure

    The com.axiell.schema packages consists of a number of utilities, where each utility provides a single piece of functionality. Since the library validates JSON structures two main components are provided. The first component (com.axiell.schema.Schema) allows JSON documents conforming to the JSON Schema specification to be read. Once read a resolution process may be required to resolve any external references defined in the document.

    The second component (com.axiell.schema.SchemaValidator) takes a resolved schema and allows JSON documents to be validated against that schema. When creating a validator it is also possible to incorporate your own "format" types for validation.

    A set of auxiliary components implement parsers for many of the "format" types and can be used independently of the validator itself.

    Notable utilities are:

    • Schema wrapper around a JSON document containing the document itself, its $id value and resolution mappings for all $id and $ref directives.
    • SchemaValidator takes a Schema and an optional handler for "format" types and provides a validation method for arbitrary JSON documents.
    • Implicits implements implicit methods and classes used to convert one class to another or pimp methods onto existing classes (e.g. same() method to JValue class).
    • various auxiliary classes for handling "format" types including:

    Dependencies

    The list of dependencies are:

    • Axiell Util Library provides error handling classes and methods that allow multilingual error messages to be generated.
    • JSON for Scala Library provides mthods for dealing with JSON structures. The routines work around an AST (Abstract Syntax Tree) used to represent a JSON document.
    • Cats Functional Programming Library provides various traits, classes and methods that simplify functional programming in Scala. Also provides the Validated class used to return lists of validation errors.
    Definition Classes
    root
  • package com
    Definition Classes
    root
  • package axiell
    Definition Classes
    com
  • package schema

    Contains types used by the library.

    Contains types used by the library.

    In order to simplify method signatures a series of types are defined. The types are used throughout the library.

    Definition Classes
    axiell
  • package instances
    Definition Classes
    schema
  • package syntax
    Definition Classes
    schema
  • Assertions
  • Context
  • EmailAddress
  • Formats
  • Hostname
  • Implicits
  • Ipv4Address
  • Ipv6Address
  • JsonPointer
  • RelativeJsonPointer
  • Resolver
  • Schema
  • SchemaValidator
  • SchemaWalker
  • Validator

final case class JsonPointer extends Product with Serializable

Contains the components making up a JSON Pointer.

The components that make up the path in a JSON Pointer are stored as a vector. Each component has had any escape characters replaced with the underlying character (~0 => ~, ~1 => /). A series of methods are provided that allow paths to be built and resolved.

The root path is represented by an empty JSON pointer:

JsonPointer()

Paths can be built up. For example

JsonPointer() / "items" / 0 / "name"

refers to the name property stored in the zeroth element of the items array.

Paths can be resolved against a JSON document:

JsonPointer.fromString("items/0/name").resolve(
  parse("""
    {
      "items": [
        {"name": "spanner"},
        {"name", "hammer"},
        {"name", "chisel"
      ]
    }"""
  )
)

would resolve to the value "spanner".

Source
JsonPointer.scala
Linear Supertypes
Serializable, Product, Equals, AnyRef, Any
Ordering
  1. Alphabetic
  2. By Inheritance
Inherited
  1. JsonPointer
  2. Serializable
  3. Product
  4. Equals
  5. AnyRef
  6. Any
  1. Hide All
  2. Show All
Visibility
  1. Public
  2. Protected

Value Members

  1. final def !=(arg0: Any): Boolean
    Definition Classes
    AnyRef → Any
  2. final def ##(): Int
    Definition Classes
    AnyRef → Any
  3. def /(index: Int): JsonPointer

    Appends a numeric component to an existing path.

    Appends a numeric component to an existing path.

    A numeric component identifies an entry in a JSON array. The index is zero based. The operator can be chained to build a complex pointer. This method is a synonym for the append method.

    Example:

    JsonPointer() / "items" / 0 / "name"
    index

    to be appended to existing path

    returns

    new JsonPointer with updated path

  4. def /(token: String): JsonPointer

    Appends a string component to an existing path.

    Appends a string component to an existing path.

    A string component identifies a property key in a JSON object. The operator can be chained to build a complex pointer. This method is a synonym for the append method.

    Example:

    JsonPointer() / "person" / "name"
    token

    component to be appended to existing path

    returns

    new JsonPointer with updated path

  5. final def ==(arg0: Any): Boolean
    Definition Classes
    AnyRef → Any
  6. def append(index: Int): JsonPointer

    Appends a numeric component to an existing path.

    Appends a numeric component to an existing path.

    A numeric component identifies an entry in a JSON array. The index is zero based. The operator can be chained to build a complex pointer. This method is a synonym for the append method.

    Example:

    JsonPointer().append("items").append(0).append("name")
    index

    to be appended to existing path

    returns

    new JsonPointer with updated path

  7. def append(token: String): JsonPointer

    Appends a string component to an existing path.

    Appends a string component to an existing path.

    A string component identifies a property key in a JSON object. The operator can be chained to build a complex pointer.

    Example:

    JsonPointer().append("person").append("name")
    token

    component to be appended to existing path

    returns

    new JsonPointer with updated path

  8. final def asInstanceOf[T0]: T0
    Definition Classes
    Any
  9. def clone(): AnyRef
    Attributes
    protected[lang]
    Definition Classes
    AnyRef
    Annotations
    @throws(classOf[java.lang.CloneNotSupportedException]) @native()
  10. final def eq(arg0: AnyRef): Boolean
    Definition Classes
    AnyRef
  11. def finalize(): Unit
    Attributes
    protected[lang]
    Definition Classes
    AnyRef
    Annotations
    @throws(classOf[java.lang.Throwable])
  12. def get(json: JValue): Option[JValue]

    Resolves a JSON Pointer path against a JSON document.

    Resolves a JSON Pointer path against a JSON document.

    The path contained as tokens is resovled against a given JSON document. If the path resolves to a JSON value then the value is returned wrapped in a Some, otherwise None is returned indicating a value does not exist for the path.

    json

    document against which to resolve the path

    returns

    scala.None if the path cannot be resolved to a value otherwise the value wrapped in a Some

  13. final def getClass(): Class[_ <: AnyRef]
    Definition Classes
    AnyRef → Any
    Annotations
    @native()
  14. def getOrElse(json: JValue, default: => JValue): JValue

    Resolves a JSON Pointer against a JSON document.

    Resolves a JSON Pointer against a JSON document.

    If the path resolves to a JSON value then the value is returned otherwise the default JSON value is returned.

    json

    document against which to resolve the path

    default

    value to return if path does not exist

    returns

    JSON value path resolves to, otherwise default value

  15. final def isInstanceOf[T0]: Boolean
    Definition Classes
    Any
  16. final def ne(arg0: AnyRef): Boolean
    Definition Classes
    AnyRef
  17. final def notify(): Unit
    Definition Classes
    AnyRef
    Annotations
    @native()
  18. final def notifyAll(): Unit
    Definition Classes
    AnyRef
    Annotations
    @native()
  19. def productElementNames: Iterator[String]
    Definition Classes
    Product
  20. final def synchronized[T0](arg0: => T0): T0
    Definition Classes
    AnyRef
  21. def toString(): String

    Provides a string representation of a JSON Pointer.

    Provides a string representation of a JSON Pointer.

    The string contains escaped characters if they appear in a path component. The escaped mappings are:

    ~ => ~0
    / => ~1

    Example:

    JsonPointer("one", "two/three").toString

    Output:

    "/one/two~1three"
    returns

    string representation of JSON Pointer

    Definition Classes
    JsonPointer → AnyRef → Any
    See also

    "RFC 6901, section 5"

  22. val tokens: Vector[String]
  23. final def wait(): Unit
    Definition Classes
    AnyRef
    Annotations
    @throws(classOf[java.lang.InterruptedException])
  24. final def wait(arg0: Long, arg1: Int): Unit
    Definition Classes
    AnyRef
    Annotations
    @throws(classOf[java.lang.InterruptedException])
  25. final def wait(arg0: Long): Unit
    Definition Classes
    AnyRef
    Annotations
    @throws(classOf[java.lang.InterruptedException]) @native()

Inherited from Serializable

Inherited from Product

Inherited from Equals

Inherited from AnyRef

Inherited from Any

Ungrouped