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

CKTIS / Java

Map.compute: recalcular o valor de uma chave

Usa `Map.compute` para aplicar a mesma função quer a chave esteja presente, quer esteja ausente. Devolve `null` a partir da função para remover a entrada.

Versão: Java SE 21

Sintaxe

default V compute(K key, BiFunction<? super K, ? super V, ? extends V> remappingFunction)

Map.compute é um método predefinido de java.util.Map<K, V>, disponível desde o Java 8. Em map.compute(key, (k, v) -> ...), a função é chamada tanto para uma chave presente como para uma chave ausente. Recebe a chave fornecida em k e o valor atual em v.

Na função, v == null tanto quando a chave está ausente como quando está associada a null. Se precisares de distinguir os dois casos, usa containsKey num mapa que aceite valores null, como HashMap. Se o resultado for diferente de null, compute guarda-o e devolve-o. Se o resultado for null, remove a entrada se esta existir ou mantém a chave ausente; em ambos os casos, devolve null.

Em contraste, computeIfAbsent só chama a sua função quando a chave está ausente ou associada a null, passando-lhe apenas a chave. computeIfPresent passa a chave e o valor, mas só chama a sua função quando o valor atual é diferente de null.

Não alteres o mesmo mapa dentro da função. Se a função lançar uma exceção não verificada, compute propaga-a e deixa a associação inalterada. Passar null em vez de uma função provoca uma NullPointerException, e um mapa que não suporte a alteração pode lançar uma UnsupportedOperationException. A implementação predefinida não garante atomicidade; em ConcurrentHashMap.compute, toda a chamada é atómica, pelo que a função deve terminar rapidamente.

Exemplos

import java.util.HashMap;
import java.util.Map;
import java.util.function.BiFunction;

public class Main {
    public static void main(String[] args) {
        Map<String, Integer> counts = new HashMap<>();
        BiFunction<String, Integer, Integer> increment = (k, v) -> v == null ? 1 : v + 1;

        System.out.println(counts.compute("visits", increment));
        System.out.println(counts.compute("visits", increment));
        System.out.println(counts.compute("visits", (k, v) -> null));
        System.out.println(counts.containsKey("visits"));
    }
}

Resultado

1
2
null
false

A primeira chamada inicializa o contador `visits` com `1`, a segunda incrementa-o para `2` e a terceira remove a entrada e devolve `null`. O `false` final confirma que a chave está ausente, e não associada a `null`.

Lições relacionadas

  • Java · Lição 39 · Intermédio · Versão: 2

Fontes