CKTIS / Java
Map.Entry — para klucz–wartość
Map.Entry<K,V> reprezentuje jedną parę klucz–wartość. Metoda getKey() odczytuje klucz, a getValue() wartość. Wpis może być powiązany z mapą albo istnieć niezależnie od niej.
Wersja: Java SE 21; repository runtime, production runtime not attested
Składnia
Map.Entry<K, V> entry = Map.entry(key, value);
K keyResult = entry.getKey();
V valueResult = entry.getValue();Map.Entry<K,V> to interfejs zagnieżdżony w Map, reprezentujący jedną parę klucz–wartość, nie całą mapę. K określa typ klucza, a V typ wartości. Map.Entry.getKey() zwraca klucz typu K; Map.Entry.getValue() zwraca wartość typu V. Obie metody są bezargumentowe.
Podczas iteracji po map.entrySet() można odczytywać oba elementy każdego wpisu. Tak uzyskanego wpisu nie należy traktować jako trwałej kopii: poza iteracją lub po zmianie mapy jego zachowanie jest niezdefiniowane, z wyjątkiem obsługiwanej zmiany przez setValue() podczas iteracji.
Map.entry(key, value) tworzy niezależny od mapy, niemodyfikowalny wpis, jak w przykładzie. Odrzuca klucze i wartości null; wywołanie setValue() zgłasza UnsupportedOperationException. Ogólnie obsługa setValue() zależy od implementacji wpisu.
Przykłady
import java.util.Map;
public class Main {
public static void main(String[] args) {
Map.Entry<String, Integer> entry = Map.entry("points", 42);
String key = entry.getKey();
Integer value = entry.getValue();
System.out.println(key + " = " + value);
}
}Wynik
points = 42
Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.