Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

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.

Viri