Инициализация ImmutableMap в Guava с более чем 4 парами

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

Для создания ImmutableMap из библиотеки Guava с небольшим числом элементов (до пяти) удобно использовать метод ImmutableMap.of:

ImmutableMap<String, Integer> map = ImmutableMap.of("a", 1, "b", 2);

при работе с большими коллекциями данных следует применять ImmutableMap.Builder:

ImmutableMap<String, Integer> largeMap = ImmutableMap.builder()
    .put("a", 1).put("b", 2).put("c", 3).put("d", 4).build();

Для преобразования уже существующей карты в неизменяемую используйте метод ImmutableMap.copyOf:

ImmutableMap<String, Integer> copyOfMap = ImmutableMap.copyOf(existingMap);

В случаях требования компактности кода используйте метод .of(). Если нужна большая гибкость, применяйте builder() и его методы .put().build().

Выбор подходящего метода

of() против builder()

В зависимости от контекста может потребоваться выбрать между методами of() и builder(). Оцените требуется ли в вашем случае простота или гибкость:

• ImmutableMap.of(): подходит для небольших наборов данных.
• ImmutableMap.builder(): позволяет работать с большими объемами данных и масштабировать размер коллекции.

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

Добавление множества пар

Если нужно добавить множество пар, примените метод putAll(), который позволит передать билдеру все элементы коллекции:

Map<String, Integer> sourceMap = // ...
ImmutableMap<String, Integer> guavaMap = ImmutableMap.builder()
    .putAll(sourceMap).build();

Гармонизация функциональности и читаемости

Важно найти баланс между функциональными возможностями и читаемостью, особенно при работе с большими данными. Для этого комбинируйте применение методов of() и builder().

Визуализация

Создание ImmutableMap можно сравнить с устройством миниатюрного города, где каждый объект строго зафиксирован на своем месте:

Подготовительный этап:
ImmutableMap.Builder<Key, Value> builder = ImmutableMap.builder();

Планирование расположения объектов:
builder.put("Ратуша", 🏛️);
builder.put("Библиотека", 📚);
builder.put("Парк", 🌳);
builder.put("Музей", 🖼);

Завершение строительства:
ImmutableMap<Key, Value> cityMap = builder.build();

🏙️ Все объекты строго закреплены на своих местах!

Преимущества и области применения ImmutableMap

Кратко о преимуществах

ImmutableMap добавляет стабильность и упрощает программирование на Java:

• Простота: упрощает управление состояниями и уменьшает вероятность ошибок.
• Производительность: обеспечивает оптимизацию за счет неизменности данных.
• Консистентность: гарантирует стабильность в условиях многопоточности.

Создание сложных структур данных

Некоторые примеры использования ImmutableMap.Builder для обработки сложных структур данных:

Вложенные ImmutableMaps

Для структур с вложенными картами процесс создания может выглядеть так:

ImmutableMap<String, ImmutableMap<String, String>> nestedMap =
    new ImmutableMap.Builder<String, ImmutableMap<String, String>>()
        .put("США", ImmutableMap.of("NY", "Нью-Йорк"))
        .put("Канада", ImmutableMap.of("ON", "Онтарио"))
        .build();

ImmutableMap из списков

Если требуется создать карту на основе списков, вам потребуется ImmutableList:

ImmutableMap<String, ImmutableList<String>> citiesMap = ImmutableMap.builder()
    .put("США", ImmutableList.of("Нью-Йорк", "Сан-Франциско"))
    .put("Канада", ImmutableList.of("Торонто", "Ванкувер"))
    .build();

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

1. Документация ImmutableMap (Guava) — официальная документация Guava по ImmutableMap.
2. Исходный код ImmutableMap (GitHub Guava) — исследование исходного кода для более глубокого понимания.
3. UsingAndAvoidingNullExplained (Wiki Guava GitHub) — как избегать null в коде с помощью Guava.
4. Effective Java – Joshua Bloch — советы от Джошуа Блоха о предпочтении неизменяемости объектов.
5. ImmutableCollection (Guava) — подробное руководство по неизменяемым коллекциям от Guava.