Для чего используется TypeReference в Jackson?

TypeReference — это инфраструктурный механизм, а не «магия».

Определение

TypeReference<T> — это класс Jackson, предназначенный для сохранения информации о параметризованном типе.

Почему он работает

Ключевая идея:

• создаётся анонимный подкласс

• generic-тип фиксируется в сигнатуре класса

• информация доступна через reflection

Пример:

TypeReference<List<User>> ref =
    new TypeReference<List<User>>() {};

Где используется

• List<T>

• Map<String, T>

• вложенные generic-типы

Пример:

Map<String, List<User>> data =
    objectMapper.readValue(
        json,
        new TypeReference<Map<String, List<User>>>() {}
    );

Когда он не нужен

• при десериализации в конкретный класс

• при отсутствии generic-параметров

Вывод

TypeReference — стандартный способ корректно передать Jackson информацию о generic-типах.