CKTIS / Java
Objects.hash : un code de hachage à partir de deux champs
Combinez deux champs en un code de hachage de type `int` et découvrez pourquoi Java convertit automatiquement un `int` en `Integer`, ainsi que la différence entre `Objects.hash` et `Objects.hashCode`.
Version : Java SE 21
Syntaxe
import java.util.Objects;
// Java SE 21 — method declaration in java.util.Objects:
// public static int hash(Object... values)
int hash = Objects.hash(label, number); // label: String, number: intDans Java SE 21, la méthode statique Objects.hash(Object... values) de java.util.Objects renvoie un code de hachage de type int pour une séquence ordonnée de valeurs. Dans Objects.hash(label, number), Java convertit automatiquement le champ number de type int en Integer (autoboxing) et transmet les deux valeurs dans un tableau Object[].
Le résultat suit Arrays.hashCode(Object[]) : si le tableau n’est pas null, on part de h = 1 et on applique h = 31 * h + (e == null ? 0 : e.hashCode()) à chaque élément e. L’ordre peut changer le résultat. Objects.hash() renvoie 1, Objects.hash((Object) null) renvoie 31 et Objects.hash((Object[]) null) renvoie 0.
Même avec un seul élément, Objects.hash(x) combine son code de hachage avec la valeur initiale. Objects.hashCode(x) renvoie directement x.hashCode(), ou 0 si x vaut null. Un Object[] existant passé comme seul argument sert lui-même de tableau varargs. Une conversion explicite en Object en fait un seul élément dont le contenu n’est pas haché récursivement.
Dans hashCode(), combinez les champs en tenant compte de la façon dont equals les compare. Deux objets égaux doivent avoir le même code de hachage, mais deux objets différents peuvent aussi avoir le même code. Ne l’utilisez ni comme identifiant persistant ni comme empreinte cryptographique : le contrat général de hashCode() ne garantit pas le même résultat d’une exécution à l’autre.
Exemples
import java.util.Objects;
public class Main {
record Key(String label, int number) {
@Override
public int hashCode() {
return Objects.hash(label, number);
}
}
public static void main(String[] args) {
Key first = new Key("A", 7);
Key second = new Key("A", 7);
System.out.println(first.equals(second));
System.out.println(first.hashCode() == second.hashCode());
System.out.println(first.hashCode());
System.out.println(Objects.hash(7));
System.out.println(Objects.hashCode(7));
}
}Résultat
true true 2983 38 7
La méthode `equals` générée pour `Key` compare les deux composants du record. Les deux premières lignes (`true`) montrent que les objets sont égaux et que leurs codes de hachage coïncident. `2983` combine ceux de `"A"` et de `7` ; `38` et `7` distinguent le code d’une séquence à un élément de celui de l’élément lui-même.
Leçons associées
- Java · Leçon 18 · Avancé · Version : 2
Sources
- Objects — hash(Object...) and hashCode(Object), Java SE 21
- Arrays — hashCode(Object[]), Java SE 21
- List — hashCode(), Java SE 21
- Java Language Specification, Java SE 21 — §5.1.7 Boxing Conversion
- Java Language Specification, Java SE 21 — §15.12.4.2 Evaluate Arguments
- Object — hashCode(), Java SE 21
- Record — equals(Object), Java SE 21
- String — hashCode(), Java SE 21
- Integer — hashCode(), Java SE 21