CKTIS / Java
Objects.hash: calcular un código hash a partir de varios valores
`Objects.hash` combina varios valores en un código hash de tipo `int`. Aprende cómo funcionan `Object...` y el boxing, y cómo mantener la coherencia con `equals`.
Versión: Java SE 21
Sintaxis
import java.util.Objects;
// Static method declared in java.util.Objects:
public static int hash(Object... values)
// Example call:
int hash = Objects.hash(42, "A", "B");Objects.hash es un método estático de java.util.Objects. Devuelve un código hash de tipo int para una secuencia ordenada de valores. En Objects.hash(42, "A", "B"), el parámetro Object... (varargs) permite pasar los valores por separado: Java los agrupa en un array Object[]. El valor primitivo int 42 se convierte en Integer mediante boxing, mientras que los dos valores String ya son referencias.
El resultado coincide con el de Arrays.hashCode(Object[]). Se empieza en 1: por cada elemento se multiplica el resultado acumulado por 31 y se suma el código hash del elemento, o 0 si el elemento es null. Cambiar el orden puede alterar el resultado. Para un único objeto que no sea un array, Objects.hash(x) calcula el hash de una secuencia de un elemento. Usa Objects.hashCode(x) si quieres el código hash del propio objeto, o 0 para null.
Si pasas un Object[] directamente, sus elementos forman la secuencia. Si un array es a su vez un elemento de la secuencia, no se calcula el hash de su contenido de forma recursiva. Objects.hash((Object[]) null) devuelve 0 porque falta el array entero, mientras que Objects.hash((Object) null) devuelve 31 porque hay un elemento null.
Al implementar hashCode(), elige los valores de modo que los objetos iguales según equals produzcan siempre el mismo resultado. Una forma sencilla es usar los mismos campos y tener en cuenta cómo los compara equals. Lo contrario no se cumple: dos objetos no iguales pueden compartir un código hash (colisión). No uses este código como identificador persistente ni como hash criptográfico.
Ejemplos
import java.util.Objects;
public class Main {
record Key(int id, String first, String second) {
@Override
public int hashCode() {
return Objects.hash(id, first, second);
}
}
public static void main(String[] args) {
Key left = new Key(42, "A", "B");
Key right = new Key(42, "A", "B");
System.out.println(left.equals(right));
System.out.println(left.hashCode() == right.hashCode());
System.out.println(left.hashCode());
}
}Resultado
true true 72234
El método `equals` generado compara los tres componentes de `Key`. El método `hashCode()` personalizado pasa esos mismos componentes en un orden fijo, por lo que ambas claves son iguales y tienen el código hash `72234`.
Lecciones relacionadas
- Java · Lección 28 · Intermedio · Versión: 2
Fuentes
- Java SE 21 API — Objects.hash(Object...)
- Java SE 21 API — Objects.hashCode(Object)
- Java SE 21 API — Arrays.hashCode(Object[])
- Java Language Specification, Java SE 21 — §15.12.4.2 Evaluate Arguments
- Java Language Specification, Java SE 21 — §5.1.7 Boxing Conversion
- Java SE 21 API — Object.hashCode()
- Java SE 21 API — Record.equals(Object)
- Java SE 21 API — List.hashCode()
- Java SE 21 API — Integer.hashCode()
- Java SE 21 API — String.hashCode()