GSON. Добавим ему немного строгости и решаем проблему переполнения памяти при обработки больших JSON файлов

… GSON позволяет буквально двумя строчками преобразовать JSON в Java объекты. Очень часто используется для интеграции между разными платформами и системами, сериализации и десериализации, а также для взаимодействия между вебчастью на javascript и беком на Java.

Итак, у нас есть скажем такой json, полученный от другого приложения:

{
  "summary": {
    "test1_id": "1444415",
    "test2_id": "4444935"
  },
  "results": {
    "details": [
      {
        "test1_id": "1444415",
        "test2_id": "4444935"
      },
      {
        "test1_id": "1444415",
        "test2_id": "4444935"
      }
    ]
  }
}

Описываем аналогичную структуру в Java объектах (гетеры и сетеры и т.п. для простоты писать не буду):

    static class JsonContainer {
        DataContainer summary;
        ResultContainer results;
    }

    static class ResultContainer {
        List<DataContainer> details;
    }

    static class DataContainer {
        String test1_id;
        String test1_id;
    }

И буквально двумя строчками преобразуем одно в другое.

       Gson gson = new GsonBuilder().create();
        JsonContainer jsonContainer = gson.fromJson(json, JsonContainer.class);// из Json в Java
        ... // что-то делаем 
         String json = gson.toJson(jsonContainer);// обратно из Java в json

Как можно видеть, все очень просто. Если нам не нравятся неправильные для Java имена, используем аннотацию SerializedName, то есть пишем:

    static class JsonContainer {
        DataContainer summary;
        ResultContainer results;
    }

    static class ResultContainer {
        List<DataContainer> details;
    }

    static class DataContainer {
        @SerializedName("test1_id")
        String test1Id;
        @SerializedName("test2_id")
        String test2Id;
    }

В качестве типов полей, естественно, автоматически могут использоваться не только String, но и любые примитивные и их обертки, enum, дата (формат даты можно задать), объекты с дженериками и многое другое. Для значений enum также можно указать SerializedName, если значение в json не совпадает с именем константы enum. Также можно, естественно, добавить свои обработчики для отдельных классов, например так:

Gson gson = new GsonBuilder().registerTypeAdapter(DataContainer.class, new DataContainerDeserializer<DataContainer>()).create();

class DataContainerDeserializer<T> implements JsonDeserializer<T> {       
        @Override
        public T deserialize(JsonElement json, Type type,
                             JsonDeserializationContext context)
                throws JsonParseException { 
	    ... // сам преобразуем JsonElement в нужный нам объект             
            return /* возвращаем полученный Java объект */
        }
}

Чуть ниже, покажу подробнее пример использования JsonDeserializer . В общем, вступление о GSON'е на пальцах закончилось можно переходить к самому интересному.

package com.test;

import com.google.common.collect.ObjectArrays;
import com.google.gson.*;
import com.google.gson.annotations.SerializedName;
import gnu.trove.set.hash.THashSet;
import javax.validation.constraints.NotNull;
import java.lang.annotation.Annotation;
import java.lang.reflect.Field;
import java.lang.reflect.Type;
import java.util.*;

public class TestGson {
    private static String json = "{n" +
            "  "summary": {n" +
            "    "test1_id": "1444415",n" +
            "    "test2_id": "4444935"n" +
            "  },n" +
            "  "results": {n" +
            "    "details": [n" +
            "      {n" +
            "        "test1_id": "1444415",n" +
            "        "test2_id": "4444935"n" +
            "      },n" +
            "      {n" +
            "        "test1_id": "1444415",n" +
            "        "test2_id": "4444935"n" +
            "      }n" +
            "    ]n" +
            "  }n" +
            "}";


    public static void main(String [ ] args)
    {
        Gson gson = new GsonBuilder()
                .registerTypeAdapter(DataContainer.class, new VaidateDeserializer<DataContainer>()) // устанавливаем валидатор на объект DataContainer
                .create();
        JsonContainer jsonContainer = gson.fromJson(json, JsonContainer.class);
    }

    static class JsonContainer {
        DataContainer summary;
        ResultContainer results;
    }

    static class ResultContainer {
        List<DataContainer> details;
    }

    static class DataContainer {
        @NotNull
        @SerializedName("test1_id")
        String test1Id;
        @SerializedName("test2_id")
        String test2Id;
    }

    static class VaidateDeserializer<T> implements JsonDeserializer<T> {
        private Set<String> fields = null; // Массив имен всех полей класса
        private Set<String> notNullFields = null; // Массив имен всех полей с аннотацией NotNull

        private void init(Type type) {
            Class cls = (Class) type;
            Field[] fieldsArray = ObjectArrays.concat(cls.getDeclaredFields(), cls.getFields(), Field.class); // Объединяем все поля класса (приватные, публичные, полученные в результате наследования в один массив
            fields = new THashSet<String>(fieldsArray.length);
            notNullFields = new THashSet<String>(fieldsArray.length);
            for(Field field: fieldsArray) {
                String name = field.getName().toLowerCase(); // учитываем возможность разных регистров
                Annotation[] annotations = field.getAnnotations(); // получаем все аннотации поля

                boolean isNotNull = false;
                for(Annotation annotation: annotations) {
                    if(annotation instanceof NotNull) { // получаем все поля помеченные NotNull
                        isNotNull = true;
                    } else if(annotation instanceof SerializedName) {
                        name = ((SerializedName) annotation).value().toLowerCase(); // если аннотация SerializedName задана используем её вместо поля класса в fields и notNullFields
                    }
                }
                fields.add(name);
                if(isNotNull) {
                    notNullFields.add(name);
                }
            }
        }

        @Override
        public T deserialize(JsonElement json, Type type,
                             JsonDeserializationContext context)
                throws JsonParseException {
            if(fields == null) {
                init(type); // Получаем структуру каждого класса через рефлексию только один раз для производительности
            }
            Set<Map.Entry<String, JsonElement>> entries = json.getAsJsonObject().entrySet();
            Set<String> keys = new THashSet<String>(entries.size());
            for (Map.Entry<String, JsonElement> entry : entries) {
                if(!entry.getValue().isJsonNull()) { // Игнорируем поля json, у которых значение null
                    keys.add(entry.getKey().toLowerCase()); // собираем коллекцию всех имен полей в json
                }
            }
            if (!fields.containsAll(keys)) { // поле есть в json, но нет в Java классе - ошибка
                throw new JsonParseException("Parse error! The json has keys that isn't found in Java object:" + type);
            }
            if (!keys.containsAll(notNullFields)) { // поле в Java классе помечено как NotNull, но в json его нет  - ошибка
                throw new JsonParseException("Parse error! The NotNull fields is absent in json for object:" + type);
            }
            return new Gson().fromJson(json, type); // запускаем стандартный механизм обработки GSON
        }
    }
}