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.