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.