KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / Java

System.identityHashCode — de identiteits-hashcode van een object

System.identityHashCode geeft een hashcode terug die is gebaseerd op de identiteit van het object en slaat een overschreven hashCode()-methode over. Voor null geeft de methode 0 terug. Het resultaat is geen unieke identificatie en vervangt een referentievergelijking met == niet.

Versie: Java SE 21; repository runtime, production runtime not attested

Syntax

public static int identityHashCode(Object x)

System.identityHashCode(Object x) is een statische methode die een int teruggeeft: de hashcode die de standaardimplementatie van Object.hashCode() voor het object zou teruggeven. De methode roept de overschreven hashCode()-methode van de klasse van het object niet aan. Voor null geeft ze 0 terug in plaats van een uitzondering te gooien.

Een gewone aanroep van x.hashCode() gebruikt de implementatie die voor de werkelijke klasse van het object is gekozen; die kan een hash berekenen op basis van de inhoud. System.identityHashCode(x) gaat over de identiteit van een bepaalde instantie, niet over waarde-gelijkheid zoals gedefinieerd door equals(). Twee objecten die volgens equals() gelijk zijn, hoeven geen gelijke identiteits-hashcodes te hebben.

Voor hetzelfde object blijft het resultaat binnen één uitvoering gelijk, maar bij verschillende uitvoeringen hoeft dat niet zo te zijn. Verschillende objecten kunnen hetzelfde resultaat krijgen: botsingen zijn toegestaan. Gelijke resultaten bewijzen dus niet dat verwijzingen naar hetzelfde object wijzen; gebruik daarvoor ==. Beschouw het resultaat niet als een unieke identificatie, een blijvende sleutel of een gegarandeerd geheugenadres.

In het voorbeeld verwijzen item en alias naar hetzelfde object. De overschreven hashCode()-methode gooit opzettelijk een AssertionError, zodat een onbedoelde aanroep zichtbaar wordt. Het programma vergelijkt de resultaten in plaats van de onvoorspelbare hashwaarde af te drukken; de verwachte uitvoer is true, true en 0, elk op een eigen regel.

Voorbeelden

public class Main {
    static final class Item {
        @Override
        public int hashCode() {
            throw new AssertionError("hashCode override called");
        }
    }

    public static void main(String[] args) {
        Item item = new Item();
        Item alias = item;
        int hash = System.identityHashCode(item);

        System.out.println(item == alias);
        System.out.println(hash == System.identityHashCode(alias));
        System.out.println(System.identityHashCode(null));
    }
}

Resultaat

true
true
0

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