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

CKTIS / Java

System.identityHashCode — código hash de identidade de um objeto

System.identityHashCode devolve um código hash baseado na identidade do objeto, sem chamar um método hashCode() redefinido. Para null, devolve 0. O resultado não é um identificador único nem substitui a comparação de referências com ==.

Versão: Java SE 21; repository runtime, production runtime not attested

Sintaxe

public static int identityHashCode(Object x)

System.identityHashCode(Object x) é um método estático que devolve um int: o código hash que a implementação predefinida de Object.hashCode() devolveria para o objeto. Não invoca o método hashCode() redefinido pela classe do objeto. Para null, devolve 0 em vez de lançar uma exceção.

Uma chamada normal a x.hashCode() usa a implementação selecionada para a classe real do objeto; esta pode calcular um hash com base no seu conteúdo. System.identityHashCode(x) diz respeito à identidade de uma instância específica, não à igualdade de valor definida por equals(). Dois objetos iguais segundo equals() não têm necessariamente códigos hash de identidade iguais.

Para o mesmo objeto, o resultado mantém-se constante durante uma execução, mas não tem de ser igual em execuções diferentes. Objetos diferentes podem receber o mesmo resultado: as colisões são permitidas. Assim, resultados iguais não provam que as referências apontam para o mesmo objeto; usa == para verificar isso. Não trates o resultado como um identificador único, uma chave persistente ou um endereço de memória garantido.

No exemplo, item e alias referem-se ao mesmo objeto. O método hashCode() redefinido lança deliberadamente um AssertionError, tornando visível qualquer chamada acidental. O programa compara os resultados em vez de imprimir o valor hash imprevisível; o resultado esperado é true, true e 0, cada um numa linha própria.

Exemplos

public class Main {
    static final class Item {
        @Override
        public int hashCode() {
            throw new AssertionError("hashCode override called");
        }
    }

    public static void main(String[] args) {
        Item item = new Item();
        Item alias = item;
        int hash = System.identityHashCode(item);

        System.out.println(item == alias);
        System.out.println(hash == System.identityHashCode(alias));
        System.out.println(System.identityHashCode(null));
    }
}

Resultado

true
true
0

O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.

Fontes