CKTIS / Java
Přístup k mapě: přítomnost klíče, čtení a zápis
Rozlišujte chybějící klíč od uložené hodnoty `null`, zvolte správnou metodu čtení a do mezipaměti ukládejte jen plně vytvořené singletony.
Verze: Java SE 21
Syntaxe
// 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);V Java SE 21 metoda Map.containsKey(Object key) zjišťuje, zda pro klíč existuje záznam, i když je jeho hodnota null. Map.get(Object key) vrací uloženou hodnotu, nebo null, pokud záznam chybí. U map, které povolují hodnoty null, samotné get tyto dva případy nerozliší.
Map.getOrDefault(Object key, V defaultValue) vrací náhradní hodnotu pouze tehdy, když záznam pro klíč chybí. Klíč s hodnotou null stále vrací null a čtení nic nevkládá. Ve výrazu map.getOrDefault(key, factory()) se factory() zavolá i pro přítomný klíč: Java vyhodnocuje argumenty před voláním metody.
Map.put(K key, V value) přidá záznam nebo nahradí jeho hodnotu a vrátí předchozí hodnotu. Výsledek null může znamenat, že záznam neexistoval nebo měl hodnotu null. HashMap podporuje put a povoluje klíč i hodnoty null, ale ne každá mapa to umožňuje. Nepodporovaná operace put vyvolá UnsupportedOperationException; pokus o zápis nepovoleného null vyvolá NullPointerException. Podle implementace může nepovolený typ nebo vlastnost klíče či hodnoty vyvolat ClassCastException, respektive IllegalArgumentException. Čtení může odmítnout klíč nesprávného typu výjimkou ClassCastException nebo nepovolený klíč null výjimkou NullPointerException.
V registru používaném jedním vláknem uchovávejte továrny odděleně od mezipaměti hotových singletonů. Nejdříve zkontrolujte mezipaměť; pokud záznam chybí, vyhledejte a zavolejte registrovanou továrnu. Instanci uložte až po úplném vytvoření a ověření, že není null. Pokud továrna vyvolá výjimku, nic se do mezipaměti neuloží. Volání se stejným klíčem sdílejí instanci v rámci jednoho registru, nikoli globálně. Při práci s více vlákny koordinujte celou posloupnost kontroly, vytvoření a zápisu; pouhá změna typu mapy ji atomickou neudělá.
Příklady
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));
}
}Výsledek
containsKey: true/false get: null/null getOrDefault: null/fallback put returned: configured current value: updated construct report same instance: true
První tři řádky porovnávají záznam s hodnotou `null` a chybějící záznam. Potom `put` vrátí `configured`, ale v mapě zůstane `updated`. Zpráva `construct report` se zobrazí jednou a `==` potvrdí, že obě volání vracejí stejnou instanci.
Související lekce
- Java · Lekce 59 · Pokročilá · Verze: 2