CKTIS / Java
Map.getOrDefault: consultar com um valor por omissão
Consulta o valor associado a uma chave. O valor por omissão só é devolvido quando não existe uma entrada para a chave, e não quando o valor é `null`.
Versão: Java SE 21
Sintaxe
java.util.Map<K, V>: default V getOrDefault(Object key, V defaultValue)
Call: map.getOrDefault(key, defaultValue)Map.getOrDefault é um método de instância com implementação por omissão na interface java.util.Map<K, V>, disponível desde o Java 8. Map.getOrDefault() é uma forma abreviada de identificar o método, não uma chamada sem argumentos. Usa map.getOrDefault(key, defaultValue): o parâmetro da chave é declarado como Object, e tanto o valor por omissão como o resultado são do tipo V.
Se existir uma entrada para a chave, o método devolve o valor guardado, mesmo que seja null, como permite HashMap. Só devolve o valor por omissão se não existir uma entrada. O método não insere nem substitui nada. Ao contrário de get(key), que devolve null quando a chave está ausente, este método permite indicar um valor alternativo. O Java avalia a expressão desse valor antes da chamada, ainda que depois não o utilize.
Para Map<String, Long>, usa 0L: o Java converte automaticamente este literal long em Long (boxing). Atribuir o resultado a uma variável long faz a conversão inversa (unboxing); se o resultado for null, é lançada uma NullPointerException. Para Map<String, Integer>, podes usar map.getOrDefault("TOTAL", 0).
Consoante a implementação, um tipo de chave inadequado pode causar uma ClassCastException, e uma chave null pode causar uma NullPointerException se o mapa não a aceitar. A implementação por omissão não garante sincronização nem atomicidade; consulta a documentação do mapa que estás a usar.
Exemplos
import java.util.HashMap;
import java.util.Map;
public class Main {
public static void main(String[] args) {
Map<String, Long> counts = new HashMap<>();
counts.put("books", 7L);
counts.put("pending", null);
long books = counts.getOrDefault("books", 0L);
long games = counts.getOrDefault("games", 0L);
Long pending = counts.getOrDefault("pending", 0L);
System.out.println(books);
System.out.println(games);
System.out.println(pending);
System.out.println(counts.containsKey("games"));
}
}Resultado
7 0 null false
`books` tem o valor `7` e a ausência de uma entrada para `games` dá `0`. O resultado para `pending` é `null`, pelo que fica numa variável `Long`. O `false` final mostra que a consulta não inseriu `games`.
Lições relacionadas
- Java · Lição 43 · Avançado · Versão: 2
- Java · Lição 56 · Básico · Versão: 2
- Java · Lição 39 · Intermédio · Versão: 2