CKTIS / Java
Map.containsValue — sprawdzanie obecności wartości
Sprawdź, czy co najmniej jeden klucz ma podaną wartość, i zobacz, dlaczego w przykładzie z `WeakHashMap` wyszukiwanie `null` poprzedza wywołanie `reachabilityFence(t3)`.
Wersja: Java SE 21
Składnia
boolean containsValue(Object value);Map.containsValue to metoda instancji interfejsu java.util.Map<K, V>. Przyjmuje Object, a nie V. Zgodnie z kontraktem zwraca true, jeśli dla co najmniej jednej zapisanej wartości v zachodzi Objects.equals(value, v), w przeciwnym razie zwraca false. Nie wskazuje pasującego klucza ani nie liczy trafień. IdentityHashMap celowo odstępuje od tego kontraktu i porównuje wartości za pomocą ==.
containsKey(key) szuka klucza, a containsValue(value) szuka wśród wartości. Jeśli mapa dopuszcza wartości null, containsValue(null) wykrywa wpis z wartością null, a nie brak wpisu. Przy niedozwolonej wartości null lub nieodpowiednim typie implementacja może zwrócić false albo zgłosić odpowiednio NullPointerException lub ClassCastException. ConcurrentHashMap zgłasza NullPointerException dla zapytania o wartość null.
W większości implementacji wyszukiwanie wartości zajmuje zwykle czas liniowy względem liczby wpisów: może wymagać przejrzenia całej mapy. Nie zakładaj, że wyszukiwanie wartości jest równie szybkie jak wyszukiwanie klucza.
WeakHashMap dopuszcza wartości null i przechowuje klucze przez słabe referencje. Gdy klucz staje się słabo osiągalny, jego wpis może zniknąć wskutek działania mechanizmu odzyskiwania pamięci. Umieszczone po sprawdzeniu Reference.reachabilityFence(t3) utrzymuje obiekt klucza silnie osiągalnym co najmniej do zakończenia tego wywołania. Nie uruchamia odzyskiwania pamięci ani nie gwarantuje, że wpis później zniknie.
Przykłady
import java.lang.ref.Reference;
import java.util.Map;
import java.util.WeakHashMap;
public class Main {
public static void main(String[] args) {
Map<Object, String> map = new WeakHashMap<>();
Object t3 = new Object();
map.put(t3, null);
System.out.println(map.containsValue(null));
System.out.println(map.containsKey(null));
System.out.println(map.containsValue("ready"));
Reference.reachabilityFence(t3);
}
}Wynik
true false false
Pierwszy wiersz to `true`, bo kluczowi `t3` przypisano `null`. Drugi to `false`, bo `null` nie jest kluczem, a trzeci to `false`, bo żaden wpis nie ma wartości `"ready"`.
Powiązane lekcje
- Java · Lekcja 18 · Zaawansowany · Wersja: 2
Źródła
- Map (Java SE 21 & JDK 21) — containsValue
- WeakHashMap (Java SE 21 & JDK 21)
- Reference (Java SE 21 & JDK 21) — reachabilityFence
- IdentityHashMap (Java SE 21 & JDK 21) — containsValue
- ConcurrentHashMap (Java SE 21 & JDK 21) — containsValue
- The java Command — Using Source-File Mode to Launch Single-File Source-Code Programs