Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

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

Fontes