Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

CKTIS / Java

Object.hashCode — el contrato del código hash

Object.hashCode devuelve un int que utilizan las tablas hash. Los objetos que son iguales según equals deben tener el mismo código; lo contrario no es necesariamente cierto.

Versión: Java SE 21; repository runtime, production runtime not attested

Sintaxis

public int hashCode()

Object.hashCode() es un método de instancia público que devuelve un int y que utilizan las tablas hash, como HashMap. La implementación predeterminada intenta distinguir los objetos, pero no garantiza que sean únicos.

Si se cumple a.equals(b), también debe cumplirse a.hashCode() == b.hashCode(). Se permiten las colisiones: tener códigos iguales no demuestra que los objetos sean iguales. El resultado debe mantenerse estable durante una ejecución mientras no cambien los datos utilizados por equals; puede variar entre ejecuciones.

Al sobrescribir equals, por lo general también hay que sobrescribir hashCode para respetar este contrato. El ejemplo define ambos métodos a partir del campo inmutable id: distintas instancias de Key(7) son iguales y devuelven el código 7.

Ejemplos

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());
    }
}

Resultado

false
true
7
true

El código mostrado y el resultado declarado se verificaron en un entorno aislado mediante el método registrado en la evidencia de verificación de esta versión exacta.

Fuentes