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

CKTIS / Java

Map.containsValue — verificar a presença de um valor

Verifica se alguma chave está associada a um valor e vê por que razão o exemplo com `WeakHashMap` procura `null` antes de chamar `reachabilityFence(t3)`.

Versão: Java SE 21

Sintaxe

boolean containsValue(Object value);

Map.containsValue é um método de instância de java.util.Map<K, V>. Recebe um Object, não um V. Segundo o contrato da interface, devolve true se Objects.equals(value, v) for verdadeiro para pelo menos um valor guardado v, e false caso contrário. Não indica a chave correspondente nem conta as correspondências. IdentityHashMap desvia-se intencionalmente deste contrato e compara os valores com ==.

containsKey(key) procura uma chave; containsValue(value) procura entre os valores. Se o mapa aceitar valores null, containsValue(null) deteta uma entrada com o valor null, não uma entrada em falta. Se null não for permitido ou o tipo for inadequado, a implementação pode devolver false ou lançar, respetivamente, NullPointerException ou ClassCastException. ConcurrentHashMap lança NullPointerException quando se procura o valor null.

Na maioria das implementações, a pesquisa de um valor demora normalmente um tempo linear no número de entradas: pode ser necessário percorrer o mapa inteiro. Não assumes que é tão rápida como a pesquisa de uma chave.

WeakHashMap aceita valores null e mantém as chaves através de referências fracas. Quando uma chave se torna fracamente alcançável, a sua entrada pode desaparecer em consequência da recolha de lixo. Colocar Reference.reachabilityFence(t3) depois da verificação mantém o objeto-chave fortemente alcançável pelo menos até ao fim da chamada. A chamada não inicia a recolha de lixo nem garante que a entrada desapareça mais tarde.

Exemplos

import java.lang.ref.Reference;
import java.util.Map;
import java.util.WeakHashMap;

public class Main {
    public static void main(String[] args) {
        Map<Object, String> map = new WeakHashMap<>();
        Object t3 = new Object();
        map.put(t3, null);

        System.out.println(map.containsValue(null));
        System.out.println(map.containsKey(null));
        System.out.println(map.containsValue("ready"));
        Reference.reachabilityFence(t3);
    }
}

Resultado

true
false
false

A primeira linha é `true` porque `t3` está associado a `null`. A segunda é `false` porque `null` não é uma chave, e a terceira é `false` porque nenhuma entrada tem o valor `"ready"`.

Lições relacionadas

  • Java · Lição 18 · Avançado · Versão: 2

Fontes