NAME
JSON::Schema::Modern::Document - One JSON Schema document
VERSION
version 0.513
SYNOPSIS
use JSON::Schema::Modern::Document;
my $document = JSON::Schema::Modern::Document->new(
canonical_uri => 'https://example.com/v1/schema',
schema => $schema,
);
my $foo_definition = $document->get('/$defs/foo');
my %resource_index = $document->resource_index;DESCRIPTION
This class represents one JSON Schema document, to be used by JSON::Schema::Modern.
ATTRIBUTES
schema
The actual raw data representing the schema.
canonical_uri
When passed in during construction, this represents the initial URI by which the document should be known. It is overwritten with the root schema's $id property when one exists, and as such can be considered the canonical URI for the document as a whole.
specification_version
Indicates which version of the JSON Schema specification is used during evaluation of this schema document. Is normally determined automatically at construction time.
resource_index
An index of URIs to subschemas (json path to reach the location, and the canonical URI of that location) for all identifiable subschemas found in the document. An entry for URI '' is added only when no other suitable identifier can be found for the root schema.
This attribute should only be used by JSON::Schema::Modern and not intended for use externally (you should use the public accessors in JSON::Schema::Modern instead).
When called as a method, returns the flattened list of tuples (path, uri). You can also use resource_pairs which returns a list of tuples as arrayrefs.
canonical_uri_index
An index of json paths (from the document root) to canonical URIs. This is the inversion of "resource_index" and is constructed as that is built up.
errors
A list of JSON::Schema::Modern::Error objects that resulted when the schema document was originally parsed. (If a syntax error occurred, usually there will be just one error, as parse errors halt the parsing process.) Documents with errors cannot be evaluated.
evaluation_configs
An optional hashref of configuration values that will be provided to the evaluator during evaluation of this document. See the third parameter of "evaluate" in JSON::Schema::Modern. This should never need to be set explicitly. This is sometimes populated automatically after creating a document object, depending on the keywords found in the schema, but they will never override anything you have already explicitly set.
METHODS
path_to_canonical_uri
Given a JSON path within this document, returns the canonical URI corresponding to that location. Only fragmentless URIs can be looked up in this manner, so it is only suitable for finding the canonical URI corresponding to a subschema known to have an $id keyword.
contains
Check if "schema" contains a value that can be identified with the given JSON Pointer. See "contains" in Mojo::JSON::Pointer.
get
Extract value from "schema" identified by the given JSON Pointer. See "get" in Mojo::JSON::Pointer.
TO_JSON
Returns a data structure suitable for serialization. See "schema".
SUPPORT
Bugs may be submitted through https://github.com/karenetheridge/JSON-Schema-Modern/issues.
I am also usually active on irc, as 'ether' at irc.perl.org and irc.libera.chat.
AUTHOR
Karen Etheridge <ether@cpan.org>
COPYRIGHT AND LICENCE
This software is copyright (c) 2020 by Karen Etheridge.
This is free software; you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself.