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

CKTIS / Java

Integer.hashCode: valor primitivo e objeto Integer

Usa `Integer.hashCode(id)` para um `int` primitivo e `boxed.hashCode()` para um objeto `Integer`. Ambos os métodos devolvem o próprio valor numérico como código de hash.

Versão: Java SE 21

Sintaxe

java.lang.Integer (Java SE 21)
public static int hashCode(int value)  // Integer.hashCode(id), where id is an int
public int hashCode()                  // boxed.hashCode(), where boxed is an Integer

Em java.lang.Integer, o nome Integer.hashCode refere-se a dois métodos. O método estático Integer.hashCode(int) está disponível desde o Java 8. Se id for do tipo int, Integer.hashCode(id) devolve exatamente id, sem ser necessário encapsular o valor num objeto. O resultado pode ser negativo.

O método de instância sem argumentos Integer.hashCode() redefine Object.hashCode(). A chamada boxed.hashCode() devolve o valor int guardado em boxed. Invocar o método numa referência null lança uma NullPointerException. Passar ao método estático uma variável do tipo Integer com o valor null também lança essa exceção, mas durante o unboxing para int.

Se a tua classe compara um campo int id em equals, usa Integer.hashCode(id) como contributo desse campo para o código de hash. Objetos iguais têm de ter o mesmo código de hash, mas códigos iguais não provam que os objetos sejam iguais. Em Integer, equals exige que o outro objeto também seja um Integer com o mesmo valor.

Este método não oculta um identificador: devolve-o sem alterações. Não é uma função de hash criptográfica.

Exemplos

public class IntegerHashCodeDemo {
    public static void main(String[] args) {
        int id = -42;
        Integer boxed = Integer.valueOf(id);

        System.out.println(Integer.hashCode(id));
        System.out.println(boxed.hashCode());
    }
}

Resultado

-42
-42

A primeira linha resulta da chamada estática com um `int`; a segunda, da chamada de instância num `Integer`. Ambas escrevem `-42` porque o código de hash é igual ao valor.

Lições relacionadas

  • Java · Lição 5 · Avançado · Versão: 2
  • Java · Lição 17 · Avançado · Versão: 2
  • Java · Lição 5 · Intermédio · Versão: 2

Fontes