CKTIS / Java
Object.hashCode — pogodba zgoščevalne kode
Object.hashCode vrne int, ki ga uporabljajo zgoščevalne tabele. Objekti, ki so po equals enaki, morajo imeti enaki kodi; obratno ne velja.
Različica: Java SE 21; repository runtime, production runtime not attested
Sintaksa
public int hashCode()Object.hashCode() je javna instančna metoda, ki vrne int in jo uporabljajo zgoščevalne tabele, kot je HashMap. Privzeta implementacija poskuša objekte razlikovati, vendar ne zagotavlja njihove edinstvenosti.
Če velja a.equals(b), mora veljati tudi a.hashCode() == b.hashCode(). Trki so dovoljeni: enaki kodi ne dokazujeta, da sta objekta enaka. Rezultat mora ostati nespremenjen med enim izvajanjem, dokler se podatki, ki jih uporablja equals, ne spremenijo; med izvajanji se lahko razlikuje.
Pri prepisu metode equals je običajno treba prepisati tudi hashCode, da se ta pogodba ohrani. Primer obe metodi določi na podlagi nespremenljivega polja id: ločeni primerki Key(7) so enaki in vrnejo kodo 7.
Primeri
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());
}
}Rezultat
false true 7 true
Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.