Is draft-04/hyper-schema supported?

[avalez]

Hi,

First of all, thanks a lot for great tool! I'm trying to use it for validating schemas I'm going to write.. however I've got a few problems, here is first one:

The following simple hyper-schema gets warning:

[ {
  "level" : "warning",
  "schema" : {
    "loadingURI" : "#",
    "pointer" : ""
  },
  "domain" : "syntax",
  "message" : "unknown keyword(s) found; ignored",
  "ignored" : [ "links" ]
} ]

Schema is:

{
    "$schema": "http://json-schema.org/draft-04/hyper-schema#",
    "type": "object",
    "links": [
        {"href": "http://example.org/example", "rel": "describedBy"}
   ]
}

May be misunderstood hyper-schema? Or this is just not supported? Or is it bug?

Thank you.

[fge]

Hello,

As to hyper schema, in 2.0.x, there is no support at all...

In 2.1.x (and note that is this beta), syntax checking is there (but only for draft v4); hyperschema processing by itself is not implemented at all.

So, it depends on what your needs are:

• with 2.0.x, you have the option to add "nop" keywords for all keywords defined by JSON hyperschema (since none of these keywords influence validation, and validation is what this library does);
• with 2.1.x, still under development, you can use syntax validation to spot illegal "hyper schemas" (draft v4+); but hyperschema processing is still not there.

[avalez]

I see, thank you for quick response! I'm using 2.1.8. I don't expect much validation, just why this warning? Because "links" property is defined in hyper-schema. Does the tool interpret "$schema" at all?

Thank you.

[fge]

Uh, it is supposed to do so, and in my tests it does, so it is strange that it should behave this way.

Can you provide your test code?

[avalez]

I reproduce on http://json-schema-validator.herokuapp.com/

[fge]

Ah...

Unfortunately this site is out of date... And this is my fault. I haven't touched it for many months, and in the meanwhile a lot of stuff has happened...

I'll update the site and keep you informed.

[fge]

BUT in the meanwhile, can you confirm that syntax validation on your schema does not produce this warning?

Here is some sample code to do it:

    public static void main(final String... args)
        throws ProcessingException
    {
        final JsonSchemaFactory factory = JsonSchemaFactory.byDefault();

        final JsonNode schema = // your schema here as a JsonNode //;

        final ProcessingReport report = new ConsoleProcessingReport();

        factory.getSyntaxValidator().getProcessor()
            .process(report, ValueHolder.<SchemaTree>hold("schema",
                new CanonicalSchemaTree(schema)));
    }

[avalez]

It seems to have the same problem, the following is printed to stdout:

warning: the following keywords are unknown and will be ignored: [links]
    level: "warning"
    schema: {"loadingURI":"#","pointer":""}
    domain: "syntax"
    ignored: ["links"]

Note, for validation I use 2.1.8 in similar way as herokapp does. I.e.:

JsonSchemaFactory.byDefault().getValidator().validateUnchecked(schemaNode, data);

[fge]

Uh... OK, this looks like a bug.

I'll try and reproduce it and keep you informed.

[avalez]

Ok, thank you a lot!

[fge]

OK, the bug is confirmed. Hyper schema draft v4 is indeed not supported at all, not even syntax wise... The syntax validators are there and they are tested, and that works, unfortunately, they are not integrated. And the API currently does not allow their integration :/

So, this is clearly a bug, and a target for 2.1.9.

[Marumaar]

Hi, fge, I am using the site (http://json-schema-validator.herokuapp.com/) an still getting the error.

[fge]

@Marumaar do you use the correct $schema? By default the implementation uses JSON Schema draft v4, not hyper schema.

You have to use http://json-schema.org/draftv4/hyper-schema as a $schema to identify the schema as a hyper schema.