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

CKTIS / Java

Objects.hash: código hash a partir de dos campos

Combina dos campos en un código hash de tipo `int`, entiende por qué Java convierte automáticamente un `int` en `Integer` y distingue `Objects.hash` de `Objects.hashCode`.

Versión: Java SE 21

Sintaxis

import java.util.Objects;

// Java SE 21 — method declaration in java.util.Objects:
// public static int hash(Object... values)
int hash = Objects.hash(label, number); // label: String, number: int

En Java SE 21, el método estático Objects.hash(Object... values) de java.util.Objects devuelve un código hash de tipo int para una secuencia ordenada de valores. En Objects.hash(label, number), Java convierte automáticamente el campo number de tipo int en Integer (autoboxing) y pasa ambos valores en un array Object[].

El resultado sigue el cálculo de Arrays.hashCode(Object[]): si el array no es null, se empieza con h = 1 y se aplica h = 31 * h + (e == null ? 0 : e.hashCode()) para cada elemento e. El orden puede cambiar el resultado. Objects.hash() devuelve 1, Objects.hash((Object) null) devuelve 31 y Objects.hash((Object[]) null) devuelve 0.

Con un solo elemento, Objects.hash(x) sigue combinando su código hash con el valor inicial. Objects.hashCode(x) devuelve directamente x.hashCode(), o 0 si x es null. Un Object[] existente pasado como único argumento es el propio array de varargs; si lo conviertes explícitamente a Object, se trata como un único elemento y su contenido no se procesa de forma recursiva.

Al implementar hashCode(), combina los campos de forma coherente con cómo los compara equals. Los objetos iguales deben tener el mismo código hash, pero los objetos distintos pueden tenerlo también. No lo uses como identificador persistente ni como hash criptográfico: el contrato general de hashCode() no garantiza el mismo resultado entre ejecuciones.

Ejemplos

import java.util.Objects;

public class Main {
    record Key(String label, int number) {
        @Override
        public int hashCode() {
            return Objects.hash(label, number);
        }
    }

    public static void main(String[] args) {
        Key first = new Key("A", 7);
        Key second = new Key("A", 7);
        System.out.println(first.equals(second));
        System.out.println(first.hashCode() == second.hashCode());
        System.out.println(first.hashCode());
        System.out.println(Objects.hash(7));
        System.out.println(Objects.hashCode(7));
    }
}

Resultado

true
true
2983
38
7

El `equals` generado para `Key` compara ambos componentes del record. Las dos primeras líneas (`true`) muestran que los objetos son iguales y que sus códigos hash coinciden. `2983` combina los códigos de `"A"` y `7`; `38` y `7` muestran la diferencia entre el código de una secuencia de un elemento y el del elemento mismo.

Lecciones relacionadas

  • Java · Lección 18 · Avanzado · Versión: 2

Fuentes