CKTIS / Java
Map.values() — widok wartości mapy
`Map.values()` zwraca powiązaną z mapą kolekcję wartości. Można po niej iterować, aby zsumować liczniki bez odczytywania kluczy i bez pomijania powtórzeń.
Wersja: Java SE 21
Składnia
Collection<V> values();
// For an instance map of type Map<K, V>:
Collection<V> values = map.values();Map.values to skrócony zapis nazwy metody instancyjnej Map.values() z interfejsu java.util.Map<K, V>. Wywołaj ją bez argumentów na obiekcie mapy: map.values(). Wynik ma typ Collection<V> (gdzie V jest typem wartości) i zawiera po jednym elemencie na każdy wpis. Różne klucze mogą mieć równe wartości, więc takie wartości występują wielokrotnie. Użyj keySet(), gdy potrzebujesz kluczy, a entrySet(), gdy potrzebujesz par klucz–wartość.
To widok, nie kopia: dodanie, zastąpienie lub usunięcie wpisu w mapie jest widoczne w już pobranej kolekcji. Jeśli usuwanie jest obsługiwane, values.remove(x) usuwa jeden pasujący wpis według wartości, nie klucza. Aby usunąć wpis o konkretnym kluczu, użyj map.remove(key). Widok nie obsługuje add ani addAll. Nieobsługiwana próba modyfikacji może zgłosić UnsupportedOperationException.
Nie zakładaj, że iteracja ma określoną kolejność: HashMap jej nie gwarantuje. Widok wartości LinkedHashMap odzwierciedla bieżącą kolejność wpisów w mapie. Konstruktor bez argumentów domyślnie wybiera kolejność wstawiania kluczy, ale putFirst i putLast mogą zmienić pozycję istniejących wpisów. Nie modyfikuj mapy w trakcie iteracji po widoku, chyba że używasz remove() tego samego iteratora i operacja jest obsługiwana. W przeciwnym razie ogólny kontrakt Map nie określa wyniku iteracji.
Gdy potrzebujesz wyłącznie wartości, na przykład do zsumowania czterech liczników, wystarczy pętla for-each. Jeśli późniejsze zmiany mapy nie mają zmieniać elementów kolekcji, użyj new ArrayList<>(map.values()). To płytka kopia: obiekty będące wartościami nie są klonowane.
Przykłady
import java.util.Collection;
import java.util.HashMap;
import java.util.Map;
public class Main {
public static void main(String[] args) {
Map<String, Integer> counters = new HashMap<>();
counters.put("north", 4);
counters.put("south", 7);
counters.put("east", 4);
counters.put("west", 2);
Collection<Integer> values = counters.values();
System.out.println(sum(values));
counters.put("west", 5);
System.out.println(sum(values));
values.remove(7);
System.out.println(counters.containsKey("south"));
}
private static int sum(Collection<Integer> values) {
int total = 0;
for (int value : values) {
total += value;
}
return total;
}
}
Wynik
17 20 false
Pierwsza suma (`17`) uwzględnia obie wartości `4`. Po zmianie licznika `west` z `2` na `5` ten sam widok daje sumę `20`. `values.remove(7)` usuwa wpis `south`, jedyny o wartości `7`, więc sprawdzenie klucza wypisuje `false`.
Powiązane lekcje
- Java · Lekcja 58 · Podstawowy · Wersja: 2
- Java · Lekcja 39 · Średniozaawansowany · Wersja: 2