Десериализация JSON в обобщенный класс Jackson в Java

Быстрый ответ

Для осуществления десериализации JSON в обобщенные классы при помощи Jackson можно использовать TypeReference. Рассмотрим пример:

String jsonList = "[{\"prop\":\"value\"}]"; 
ObjectMapper mapper = new ObjectMapper();
List<MyClass> myList = mapper.readValue(jsonList, new TypeReference<List<MyClass>>() {});

Вместо MyClass вы можете подставить что угодно.

Работа со сложными обобщениями

Сложные типы, такие как Map<String, List<MyClass>>, требуют создания JavaType:

JavaType javaType = mapper.getTypeFactory().constructParametricType(
   Map.class, String.class, mapper.getTypeFactory().constructCollectionType(List.class, MyClass.class));
Map<String, List<MyClass>> myMap = mapper.readValue(jsonMap, javaType);

Применяйте аналогичный метод для десериализации ваших обобщенных типов, например Data<MyClass>:

JavaType dataType = mapper.getTypeFactory().constructParametricType(Data.class, MyClass.class);
Data<MyClass> data = mapper.readValue(json, dataType);

Десериализацию можно значительно упростить, включив информацию о типе в JSON с помощью аннотации @JsonTypeInfo.

Расширенная десериализация обобщённых типов

Обработка множественных параметров типа

Если у вас есть классы с несколькими параметрами типа, вам пригодится TypeFactory.constructParametricType:

JavaType customType = mapper.getTypeFactory().constructParametricType(CustomClass.class, KeyClass.class, ValueClass.class);
CustomClass<KeyClass, ValueClass> customObject = mapper.readValue(json, customType);

Подробнее об этом расскажет наш спикер на видео

Обеспечение точного разрешения типов

При десериализации необходимо точно определить Type:

JavaType mapType = mapper.getTypeFactory().constructMapType(HashMap.class, String.class, MyClass.class);
HashMap<String, MyClass> myMap = mapper.readValue(jsonMap, mapType);

Использование ограничений обобщённого типа

Для работы с ограниченными обобщенными типами можно создать специализированный TypeReference:

public class BoundedTypeReference<T extends MyBound> extends TypeReference<T> {}
BoundedTypeReference<MyClass> typeRef = new BoundedTypeReference<>() {};
MyClass myObject = mapper.readValue(jsonString, typeRef);

Использование разрешения типов в Jackson

Работа с параметризованным JavaType

Для параметризованных типов используйте подход с созданием JavaType:

JavaType resolvedType = objectMapper.getTypeFactory().constructParametricType(Container.class, ActualType.class);
Container<ActualType> container = objectMapper.readValue(jsonData, resolvedType);

Осуществление обобщённых подтипов

Если вам необходим BaseClass<SubClass>, обращайтесь следующим образом:

JavaType baseType = mapper.getTypeFactory().constructParametricType(BaseClass.class, SubClass.class);
BaseClass<SubClass> myGenericObject = mapper.readValue(jsonString, baseType);

Осознание контекста

Гарантируйте, что тип класса передается правильно, даже в нестатическом контексте. Здесь могут потребоваться дополнительные усилия.

Визуализация: Деконструкция процесса

Представьте кусок JSON как набор символов { и }. ObjectMapper ведет себя как переводчик, декодируя структуру JSON и переводя ее в Generic<T> Class при помощи Type Reference:

Raw JSON 👾 → 🤖 Jackson 🤖 → 🎩 Generic<T> Class ✨

Raw JSON 👾 = `{"name":"Widget","quantity":5}`
Type Ref. 🎩 = `new TypeReference<Generic<Widget>>() {}`
Translated 🎉 = Widget{name='Widget', quantity=5}

Type Reference в этом процессе выступает в роли волшебной палочки, трансформирующей JSON в Java-объект.

Рекомендации для разработчика

Структурируйте ваши JSON-данные

Обеспечьте четкую структуру JSON, соответствующую ожиданиям обобщенных классов. Неупорядоченный JSON может усложнить десериализацию.

Активно внедряйте аннотации

Определенные аннотации, такие как @JsonTypeInfo, помогают Jackson обрабатывать сложные случаи наследования. Их использование может быть весьма полезным.

Не экономьте на тестировании

Протестируйте процесс десериализации на различных наборах данных и в разных сценариях. Это поможет заранее выявить возможные слабые места ваших работа.

Полезные материалы

1. How do I get a class instance of generic type T? – Stack Overflow — Подробности об обобщениях в Java.
2. Jackson JSON Java Parser API Guide — Руководство по использованию Jackson в Java.
3. GitHub – FasterXML/jackson-annotations: Core annotations for Jackson data processor — Справочник по аннотациям Jackson.
4. ObjectMapper (jackson-databind-2.7.0 API) — Документация по ObjectMapper.
5. Medium: Jackson Advanced Polymorphic Type Handling — Руководство по работе с полиморфными типами в Jackson.