База знанияИзпитен център
BGБългарски
Избери език13

CKTIS / Java

Достъп до Map: наличие на ключ, четене и запис

Разграничавай липсващ ключ от записана стойност `null`, избирай подходящия метод за четене и кеширай само напълно конструирани singleton инстанции.

Версия: Java SE 21

Синтаксис

// Instance method declarations in java.util.Map<K, V>
boolean containsKey(Object key);
V get(Object key);
default V getOrDefault(Object key, V defaultValue) {
    V value = get(key);
    return (value != null || containsKey(key)) ? value : defaultValue;
}
V put(K key, V value);

В Java SE 21 Map.containsKey(Object key) проверява дали за ключа има запис, дори стойността му да е null. Map.get(Object key) връща записаната стойност или null, ако няма запис. При реализации на Map, които допускат стойности null, само get не разграничава двата случая.

Map.getOrDefault(Object key, V defaultValue) връща резервната стойност само ако за ключа няма запис. Ключ със стойност null продължава да дава null, а четенето не добавя запис. При map.getOrDefault(key, factory()) методът factory() се изпълнява дори ако ключът присъства: Java изчислява аргументите преди извикването на метода.

Map.put(K key, V value) добавя запис или заменя стойността му и връща предишната стойност. Резултат null може да означава, че не е имало запис или че предишната стойност е била null. HashMap поддържа put и допуска ключ null и стойности null, но не всяка реализация го позволява. Неподдържано извикване на put предизвиква UnsupportedOperationException, а запис на недопустим null — NullPointerException. В зависимост от реализацията недопустим тип или свойство на ключа или стойността може да предизвика съответно ClassCastException или IllegalArgumentException. При четене ключ от неподходящ тип може да бъде отхвърлен с ClassCastException, а недопустим ключ null — с NullPointerException.

В регистър, използван от една нишка, дръж фабриките отделно от кеша с готови singleton инстанции. Първо провери кеша; ако няма запис, намери и извикай регистрираната фабрика. Кеширай инстанцията едва след като е напълно конструирана и си проверил, че не е null. Ако фабриката хвърли изключение, нищо не се кешира. Извикванията с един и същ ключ споделят инстанция в рамките на един регистър, а не глобално. При няколко нишки координирай цялата последователност от проверка, конструиране и запис: само смяната на типа на Map не прави тази последователност атомарна.

Примери

import java.util.HashMap;
import java.util.Map;
import java.util.Objects;
import java.util.function.Supplier;

public class Main {
    record Service(String name) {}

    static final class Registry {
        private final Map<String, Supplier<Service>> registrations = new HashMap<>();
        private final Map<String, Service> ready = new HashMap<>();

        Registry() {
            registrations.put("report", () -> {
                System.out.println("construct report");
                return new Service("report");
            });
        }

        Service resolve(String key) {
            if (ready.containsKey(key)) {
                return ready.get(key);
            }
            Supplier<Service> factory = registrations.get(key);
            if (factory == null) {
                throw new IllegalArgumentException("Unknown service: " + key);
            }
            Service service = Objects.requireNonNull(factory.get(), "Factory returned null");
            ready.put(key, service);
            return service;
        }
    }

    public static void main(String[] args) {
        Map<String, String> labels = new HashMap<>();
        labels.put("unset", null);
        System.out.println("containsKey: " + labels.containsKey("unset") + "/" + labels.containsKey("missing"));
        System.out.println("get: " + labels.get("unset") + "/" + labels.get("missing"));
        System.out.println("getOrDefault: " + labels.getOrDefault("unset", "fallback") + "/"
                + labels.getOrDefault("missing", "fallback"));
        labels.put("unset", "configured");
        System.out.println("put returned: " + labels.put("unset", "updated"));
        System.out.println("current value: " + labels.get("unset"));

        Registry registry = new Registry();
        Service first = registry.resolve("report");
        Service second = registry.resolve("report");
        System.out.println("same instance: " + (first == second));
    }
}

Резултат

containsKey: true/false
get: null/null
getOrDefault: null/fallback
put returned: configured
current value: updated
construct report
same instance: true

Първите три реда сравняват запис със стойност `null` и липсващ запис. След това `put` връща `configured`, но в `Map` остава `updated`. Съобщението `construct report` се появява веднъж, а `==` потвърждава, че и двете извиквания връщат една и съща инстанция.

Свързани уроци

  • Java · Урок 59 · Напреднало · Версия: 2

Източници