Java library for inferring JSON schema based on sample JSONs.
Here is a simple demo site for this library that showcases some of the things it's capable of.
import java.util.Arrays;
import com.fasterxml.jackson.databind.JsonNode;
import com.fasterxml.jackson.databind.ObjectMapper;
import com.saasquatch.jsonschemainferrer.*;
public class Example {
private static final ObjectMapper mapper = new ObjectMapper();
private static final JsonSchemaInferrer inferrer = JsonSchemaInferrer.newBuilder()
.setSpecVersion(SpecVersion.DRAFT_06)
// Requires commons-validator
.addFormatInferrers(FormatInferrers.email(), FormatInferrers.ip())
.setAdditionalPropertiesPolicy(AdditionalPropertiesPolicies.notAllowed())
.setRequiredPolicy(RequiredPolicies.nonNullCommonFields())
.addEnumExtractors(EnumExtractors.validEnum(java.time.Month.class),
EnumExtractors.validEnum(java.time.DayOfWeek.class))
.build();
public static void main(String[] args) throws Exception {
final JsonNode sample1 = mapper.readTree(
"{\"๐\":\"https://saasquatch.com\",\"๐\":[-1.5,2,\"[email protected]\",false],\"๐\":3,\"weekdays\":[\"MONDAY\",\"TUESDAY\"]}");
final JsonNode sample2 = mapper.readTree(
"{\"๐\":1,\"๐\":{\"๐\":true,\"๐ต\":[2,\"1234:5678::\"],\"๐\":null},\"๐\":null,\"months\":[\"JANUARY\",\"FEBRUARY\"]}");
final JsonNode resultForSample1 = inferrer.inferForSample(sample1);
final JsonNode resultForSample1And2 =
inferrer.inferForSamples(Arrays.asList(sample1, sample2));
for (JsonNode j : Arrays.asList(sample1, sample2, resultForSample1, resultForSample1And2)) {
System.out.println(mapper.writeValueAsString(j));
}
}
}
In the code above, sample1
is:
{
"๐": "https://saasquatch.com",
"๐": [-1.5, 2, "[email protected]", false],
"๐": 3,
"weekdays": ["MONDAY", "TUESDAY"]
}
sample2
is:
{
"๐": 1,
"๐": { "๐": true, "๐ต": [2, "1234:5678::"], "๐": null },
"๐": null,
"months": ["JANUARY", "FEBRUARY"]
}
resultForSample1
is:
{
"$schema": "http://json-schema.org/draft-06/schema#",
"type": "object",
"properties": {
"๐": { "type": "string" },
"๐": { "type": "integer" },
"weekdays": { "type": "array", "items": { "enum": ["MONDAY", "TUESDAY"] } },
"๐": {
"type": "array",
"items": {
"anyOf": [
{ "type": ["number", "boolean"] },
{ "type": "string", "format": "email" }
]
}
}
},
"additionalProperties": false,
"required": ["๐", "๐", "weekdays", "๐"]
}
And resultForSample1And2
is:
{
"$schema": "http://json-schema.org/draft-06/schema#",
"type": "object",
"properties": {
"๐": { "type": ["string", "integer"] },
"months": { "type": "array", "items": { "enum": ["JANUARY", "FEBRUARY"] } },
"๐": { "type": ["null", "integer"] },
"weekdays": { "type": "array", "items": { "enum": ["MONDAY", "TUESDAY"] } },
"๐": {
"anyOf": [
{
"type": "object",
"properties": {
"๐ต": {
"type": "array",
"items": {
"anyOf": [
{ "type": "integer" },
{ "type": "string", "format": "ipv6" }
]
}
},
"๐": { "type": "null" },
"๐": { "type": "boolean" }
},
"additionalProperties": false,
"required": ["๐ต", "๐"]
},
{
"type": "array",
"items": {
"anyOf": [
{ "type": ["number", "boolean"] },
{ "type": "string", "format": "email" }
]
}
}
]
}
},
"additionalProperties": false,
"required": ["๐", "๐"]
}
For more examples, see package com.saasquatch.jsonschemainferrer.examples
.
Maven
<repositories>
<repository>
<id>jitpack.io</id>
<url>https://jitpack.io</url>
</repository>
</repositories>
Gradle
repositories {
maven { url 'https://jitpack.io' }
}
Maven
<dependency>
<groupId>com.github.saasquatch</groupId>
<artifactId>json-schema-inferrer</artifactId>
<version>0.1.4</version>
</dependency>
Gradle
implementation 'com.github.saasquatch:json-schema-inferrer:0.1.4'
This project requires Java 8. The only required transitive dependencies are Jackson and FindBugs (JSR305). If you opt into using some of the built-in FormatInferrers
, Commons Validator will also be needed.
Pre-release versions and snapshots (as well as stable releases) can be obtained through JitPack.
Unless explicitly stated otherwise all files in this repository are licensed under the Apache License 2.0.
License boilerplate:
Copyright 2019 ReferralSaaSquatch.com Inc.
Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.