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 IntegerEm 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
- Integer (Java SE 21 & JDK 21) — hashCode(int)
- Integer (Java SE 21 & JDK 21) — hashCode()
- Integer (Java SE 21 & JDK 21) — equals(Object)
- Object (Java SE 21 & JDK 21) — hashCode() contract
- The Java Language Specification, Java SE 21 Edition — §5.1.8 Unboxing Conversion
- The java Command — Using Source-File Mode to Launch Single-File Source-Code Programs