KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

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.

Bronnen