CKTIS / Java
Objects.hash : calculer un code de hachage à partir de plusieurs valeurs
`Objects.hash` combine plusieurs valeurs en un code de hachage de type `int`. Découvrez le rôle de `Object...`, du boxing et du contrat avec `equals`.
Version : Java SE 21
Syntaxe
import java.util.Objects;
// Static method declared in java.util.Objects:
public static int hash(Object... values)
// Example call:
int hash = Objects.hash(42, "A", "B");Objects.hash est une méthode statique de java.util.Objects. Elle renvoie un code de hachage de type int pour une suite ordonnée de valeurs. Dans Objects.hash(42, "A", "B"), le paramètre Object... (varargs) permet de passer les valeurs séparément : Java les regroupe dans un tableau Object[]. La valeur primitive int 42 est convertie en Integer par boxing, tandis que les deux valeurs String sont déjà des références.
Le résultat est celui de Arrays.hashCode(Object[]). Le calcul part de 1 : pour chaque élément, on multiplie le résultat courant par 31, puis on ajoute le code de hachage de l’élément, ou 0 si l’élément vaut null. Changer l’ordre peut modifier le résultat. Pour un objet unique qui n’est pas un tableau, Objects.hash(x) hache une suite à un seul élément. Utilisez Objects.hashCode(x) pour obtenir le code de hachage de l’objet lui-même, ou 0 pour null.
Si vous passez directement un Object[], ses éléments forment la suite. Si un tableau est lui-même un élément de la suite, son contenu n’est pas haché récursivement. Objects.hash((Object[]) null) renvoie 0 parce que le tableau entier est absent, tandis que Objects.hash((Object) null) renvoie 31 parce que la suite contient un élément null.
Lorsque vous implémentez hashCode(), choisissez les valeurs de sorte que des objets égaux selon equals donnent toujours le même résultat. Une approche simple consiste à utiliser les mêmes champs et à tenir compte de la manière dont equals les compare. L’inverse n’est pas vrai : deux objets non égaux peuvent avoir le même code de hachage (collision). N’utilisez pas ce code comme identifiant persistant ni comme empreinte cryptographique.
Exemples
import java.util.Objects;
public class Main {
record Key(int id, String first, String second) {
@Override
public int hashCode() {
return Objects.hash(id, first, second);
}
}
public static void main(String[] args) {
Key left = new Key(42, "A", "B");
Key right = new Key(42, "A", "B");
System.out.println(left.equals(right));
System.out.println(left.hashCode() == right.hashCode());
System.out.println(left.hashCode());
}
}Résultat
true true 72234
La méthode `equals` générée compare les trois composants de `Key`. La méthode `hashCode()` personnalisée passe ces mêmes composants dans un ordre fixe : les deux clés sont donc égales et ont pour code de hachage `72234`.
Leçons associées
- Java · Leçon 28 · Intermédiaire · Version : 2
Sources
- Java SE 21 API — Objects.hash(Object...)
- Java SE 21 API — Objects.hashCode(Object)
- Java SE 21 API — Arrays.hashCode(Object[])
- Java Language Specification, Java SE 21 — §15.12.4.2 Evaluate Arguments
- Java Language Specification, Java SE 21 — §5.1.7 Boxing Conversion
- Java SE 21 API — Object.hashCode()
- Java SE 21 API — Record.equals(Object)
- Java SE 21 API — List.hashCode()
- Java SE 21 API — Integer.hashCode()
- Java SE 21 API — String.hashCode()