Generate JSON schema from Java class

Question

I have a POJO class:

public class Stock {
 int id;
 String name;
 Date date;
}

Are there any annotations or development framework/API that can convert POJO to JSON schema like below:

{"id":
      {             
        "type" : "int"
      },
"name":{   
        "type" : "string"
       }
"date":{
        "type" : "Date"
      }
}

And also I can expand the schema to add information like "Required" : "Yes", description for each field, etc., by specifying some annotations or configurations on POJO and can generate JSON Schema like below:

{"id":
      {             
        "type" : "int",
        "Required" : "Yes",
        "format" : "id must not be greater than 99999",
        "description" : "id of the stock"
      },
"name":{   
        "type" : "string",
        "Required" : "Yes",
        "format" : "name must not be empty and must be 15-30 characters length",
        "description" : "name of the stock"
       }
"date":{
        "type" : "Date",
        "Required" : "Yes",
        "format" : "must be in EST format",
        "description" : "filing date of the stock"
      }
}

IS this what you are looking for? stackoverflow.com/questions/9593409/convert-pojo-to-json — eri0o
– eri0o, Commented Oct 5, 2014 at 5:01
No, that converts pojo to json object. I am looking for generating JSON schema as meta [information about the input form fields mapped to pojo fields like datatype, whether it is required or not, etc., ] to the end users). — user3587174
– user3587174, Commented Oct 5, 2014 at 14:23
Here is an online site that will produce json schema from json: jsonschema.net — DwB
– DwB, Commented Oct 6, 2014 at 19:07
possible duplicate of Tool to generate JSON schema from JSON data — DwB
– DwB, Commented Oct 6, 2014 at 19:09
Actually, I am not looking for any tools. I need an api that can have helper classes or annotations to describe the behavior of fields in a pojo. E.g. i recently found today that jackson 2.4.1 has new annotation @JsonPropertyDescription to add the description to the field in a pojo; [link]stackoverflow.com/questions/24515917/…. Is there a possible way to achieve the example in my post through reflection? — user3587174
– user3587174, Commented Oct 6, 2014 at 19:32

Edgar Domingues · Accepted Answer · 2021-03-15 22:24:55Z

16

Java JSON Schema Generator: https://github.com/victools/jsonschema-generator

Creates JSON Schema (Draft 6, Draft 7 or Draft 2019-09) from Java classes using Jackson.

answered Mar 15, 2021 at 22:24

Edgar Domingues

9902 gold badges8 silver badges18 bronze badges

Sign up to request clarification or add additional context in comments.

Comments

StaxMan · Accepted Answer · 2023-03-16 16:17:42Z

15

EDIT: as pointed out by commenters, module is being deprecated, not maintained. So, Caveat Emptor etc

One such tool is Jackson JSON Schema module:

https://github.com/FasterXML/jackson-module-jsonSchema

which uses Jackson databind's POJO introspection to traverse POJO properties, taking into account Jackson annotations, and produces a JSON Schema object, which may then be serialized as JSON or used for other purposes.

edited Mar 16, 2023 at 16:17

answered Oct 23, 2014 at 21:00

StaxMan

117k35 gold badges215 silver badges241 bronze badges

4 Comments

StormeHawke Over a year ago

The module you specify doesn't work if you have complex objects containing enum types that need to stay enums. See my answer below for a better tool (Still Jackson, but jackson-mapper.) The instructions at your link result in Enums being rendered as simple strings in the schema

StaxMan Over a year ago

Yes, I saw a bug report. I hope we get more contributors for the module -- it's external contribution, quite widely used, but no dedicated owner at this point.

Robert Over a year ago

Downvoted... not because it was a bad answer, just because it's a bad answer for today. This library is not being maintained anymore.

kane Over a year ago

Unmaintained and does not support draft 4, 6, 7 github.com/FasterXML/jackson-module-jsonSchema/issues/141

Drona · Accepted Answer · 2015-11-07 03:51:06Z

2

Use JJschema. It can generate draft 4 compliant JSON schemas. Refer this post http://wilddiary.com/generate-json-schema-from-java-class/ for details.

Though Jackson Json Schema module can too generate schema but it can, as of today, only generate draft 3 compliant schemas only.

edited Nov 7, 2015 at 3:51

answered Nov 5, 2015 at 18:55

Drona

7,2741 gold badge31 silver badges35 bronze badges

1 Comment

mbknor Over a year ago

github.com/mbknor/mbknor-jackson-jsonSchema can generate Draft 4 schema based on Jackson annotations

P Rajesh · Accepted Answer · 2018-10-29 10:30:20Z

2

public static String getJsonSchema(Class clazz) throws IOException {
         Field[] fields = clazz.getDeclaredFields();
         List<Map<String,String>> map=new ArrayList<Map<String,String>>();
         for (Field field : fields) {
             HashMap<String, String> objMap=new  HashMap<String, String>();
             objMap.put("name", field.getName());
             objMap.put("type", field.getType().getSimpleName());
             objMap.put("format", "");
             map.add(objMap);
         }
         ObjectMapper mapper = new ObjectMapper();
         String json = mapper.writeValueAsString(map);

       return json;
    }

answered Oct 29, 2018 at 10:30

P Rajesh

4011 gold badge4 silver badges11 bronze badges

Comments

nomadus · Accepted Answer · 2024-04-21 13:29:12Z

If you are looking for a custom solution, here is one.

 public static String generateSchema(Class currentClass) {
    StringBuilder schema = new StringBuilder();
    schema.append("{\n");
    buildProperties(currentClass, schema);
    schema.append("}");
    return schema.toString();
}

 private static void buildProperties(Class<?> clazz, StringBuilder schema) {
    for (Field field : clazz.getDeclaredFields()) {
        String fieldName = field.getName();
        field.setAccessible(true);

        if ("object".equals(getFieldType(field.getType()))) {
            if (field.isAnnotationPresent(JsonIncludeProperties.class)) {
                String[] includedProps = field.getAnnotation(JsonIncludeProperties.class).value();
                schema.append("    \"" + fieldName + "\": {\n");
                for (String prop : includedProps) {
                    Optional<Field> innerField = null;
                    if (!field.getType().isPrimitive()) {
                        innerField = Arrays.stream(field.getType().getDeclaredFields())
                                .filter(item -> item.getName().equals(prop))
                                .findFirst();
                    }

                    if (innerField.isPresent()) {
                        schema.append("      \"" + prop + "\":");
                        schema.append("\"" + getFieldType(innerField.get().getType()) + "\"\n"); // Add placeholder for definition
                    }
                }
                schema.append("    },\n");
            } else {
                schema.append("    \"" + fieldName + "\": {\n");
                for (Field innerField : field.getType().getDeclaredFields()) {
                    if (isPrimitive(innerField)) {
                        schema.append("      \"" + innerField.getName() + "\":");
                        schema.append("\"" + getFieldType(innerField.getType()) + "\"\n");
                    }
                }
                schema.append("    },\n");
            }
        } else if ("set".equals(getFieldType(field.getType()))) {
            Type genericType = field.getGenericType();

            if (genericType instanceof ParameterizedType) {
                ParameterizedType parameterizedType = (ParameterizedType) genericType;
                Type[] actualTypeArguments = parameterizedType.getActualTypeArguments();
                if (actualTypeArguments.length == 1 && actualTypeArguments[0] instanceof Class) {
                    Class<?> elementType = (Class<?>) actualTypeArguments[0];

                    schema.append("    \"" + fieldName + "\": [\n");
                    for (Field innerField : elementType.getDeclaredFields()) {
                        if (isPrimitive(innerField)) {
                            schema.append("      \"" + innerField.getName() + "\":");
                            schema.append("\"" + getFieldType(innerField.getType()) + "\"\n");
                        }
                    }
                    schema.append("    ],\n");
                }
            }
        } else {
            schema.append("  \"" + fieldName + "\": \"" + getFieldType(field.getType()) + "\",\n");
        }
    }
}

 private static String getFieldType(Class<?> type) {
    if (type.isPrimitive()) {
        if (type.equals(int.class) || type.equals(Integer.class)) {
            return "integer";
        } else if (type.equals(long.class) || type.equals(Long.class)) {
            return "number";  // Can be "integer" depending on schema needs
        } else if (type.equals(boolean.class) || type.equals(Boolean.class)) {
            return "boolean";
        } else if (type.equals(float.class) || type.equals(Float.class) ||
                type.equals(double.class) || type.equals(Double.class)) {
            return "number";
        } else {
            return "string";
        }
    } else if (type.equals(String.class)) {
        return "string";
    } else if (type.equals(Integer.class)) {
        return "integer";
    } else if (type.equals(Long.class)) {
        return "long";
    } else if (type.equals(UUID.class)) {
        return "UUID";
    } else if (type.isArray()) {
        return "array";
    } else if (Collection.class.isAssignableFrom(type)) {
        return "set";
    } else {
        return "object";
    }
}

Collectives™ on Stack Overflow

Generate JSON schema from Java class

5 Answers 5

Comments

4 Comments

1 Comment

Comments

Comments

Your Answer

Linked

Hot Network Questions

Collectives™ on Stack Overflow

5 Answers 5

Comments

4 Comments

1 Comment

Comments

Comments

Your Answer

Sign up or log in

Post as a guest

Linked

Related