CKTIS / Java
Object.hashCode — het hashcodecontract
Object.hashCode retourneert een int die door hashtabellen wordt gebruikt. Objecten die volgens equals gelijk zijn, moeten dezelfde code hebben; het omgekeerde geldt niet.
Versie: Java SE 21; repository runtime, production runtime not attested
Syntax
public int hashCode()Object.hashCode() is een publieke instantiemethode die een int retourneert en wordt gebruikt door hashtabellen zoals HashMap. De standaardimplementatie probeert objecten van elkaar te onderscheiden, maar garandeert geen uniekheid.
Als a.equals(b) geldt, moet ook a.hashCode() == b.hashCode() gelden. Botsingen zijn toegestaan: gelijke codes bewijzen niet dat objecten gelijk zijn. Het resultaat moet tijdens één uitvoering stabiel blijven zolang de gegevens die equals gebruikt niet veranderen; tussen uitvoeringen kan het verschillen.
Wie equals overschrijft, moet doorgaans ook hashCode overschrijven om aan dit contract te voldoen. Het voorbeeld definieert beide methoden op basis van het onveranderlijke veld id: afzonderlijke instanties van Key(7) zijn gelijk en retourneren code 7.
Voorbeelden
public class Main {
static final class Key {
private final int id;
Key(int id) {
this.id = id;
}
@Override
public boolean equals(Object other) {
return other instanceof Key && id == ((Key) other).id;
}
@Override
public int hashCode() {
return id;
}
}
public static void main(String[] args) {
Key a = new Key(7);
Key b = new Key(7);
System.out.println(a == b);
System.out.println(a.equals(b));
System.out.println(a.hashCode());
System.out.println(a.hashCode() == b.hashCode());
}
}Resultaat
false true 7 true
De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.