Tabla de Contenidos

Equals

El método equals(Object) es de gran importancia al usar las colecciones en Java. En la mayoría de las clases de colecciones Java es importante decidir si dos objetos son iguales y para ello se usa el método equals(Object). En Hibernate tiene aun mas importancia debido a que realmente dos objetos son iguales si hacen referencia a las misma fila de la base de datos aunque los objetos sean distintos. En este tema veremos como implementar correctamente el método equals(Object) y el método hashCode(), ya que éste último está íntimamente relacionado con equals(Object).

La explicación completa sobre los métodos equals(Object) y hashCode() está mas allá del ámbito de este curso, ya que es un tema exclusivamente de Java. Por suerte en internet hay un a extensa documentación sobre éste tema , incluyendo documentación en castellano. Os dejos unos enlaces sobre ello:

Datos a comparar

Como ya hemos comentado , al implementar los dos métodos debemos tener en cuenta que para Hibernate dos objetos serán iguales si hacen referencia a la misma fila de la base de datos. Esto va a hacer que no haya una solución fácil para implementar ambos métodos. Veamos algunas soluciones y sus problemas.

Claves primarias

Una solución fácil sería comparan las claves primarias de los 2 objetos.

En la siguiente unidad está el tema dedicado a las Claves primarias, ahí veremos como hacer que se generen automáticamente pero con el problema de que se hace cuando se va a guardar el objeto, así que la solución de comparar las claves primarias no es buena ya que para nuevos objetos no podríamos compararlos aunque realmente hicieran referencia a la misma fila.

Claves primarias naturales

En el tema Claves primarias también hablaremos de las claves primarias naturales, también llamadas claves de negocio, como son el DNI, el login o el Código Cuenta Cliente. Aunque estas claves no son adecuadas para ser claves primarias si que nos resultarán útiles para ser usadas en los métodos equals(Object) y hashCode().

Las claves primarias naturales ,tienen la caracteristica de que hacen referencia a una única fila de la base de datos y por regla general se sabe su valor antes de crear la fila en la base de datos por lo que dos objetos que hagan referencia a los mismos datos nunca serán iguales.

¿Cual es el problema de las claves primarias naturales? Que quizás la entidad de Hibernate no posea una clave primaria natural con lo que esta técnica no funcionará, aun así es la mejor opción que tenemos 1)

No hacer nada

Una última opción es simplemente no hacer nada. Si nuestra aplicación va a tener el cuidado de no añadir el mismo objeto dos veces a una colección o nunca va a hacer un equals sino que es suficiene con == , etc, etc, entonces no es necesario hacer nada.

Usuario

Para implementar los métodos equals y hashCode vamos a usar como ejemplo la clase Usuario. Esta clase tiene el siguiente código Java:

1 | Usuario.java
public class Usuario implements Serializable {
 
    private int idUsuario;
    private String login;
    private String nombre;
    private String ape1;
    private String ape2;
    private String password;
 
    public Usuario() {
    }
 
    public Usuario(String login, String nombre, String ape1, String ape2, String password) {
        this.login = login;
        this.nombre = nombre;
        this.ape1 = ape1;
        this.ape2 = ape2;
        this.password = password;
    }
 
    @Override
    public String toString() {
        return getLogin() + "-" + getNombre() + " " + getApe1() + " " + getApe2();
    }
 }
En la clase Java Usuario no se han incluido los métodos get/set de cada propiedad para facilitar la lectura, pero deben estar en la clase Java.

El diagrama UML es el siguiente:

Usuarioint idUsuarioString loginString nombreString ape1String ape2String password

La clase Usuario tiene la característica de que la propiedad login es una clave primaria natural y tener valor antes de guardarse en la base de datos y cada valor de login hace referencia una única fila de la base de datos, por lo tanto es una opción correcta para usarlo en los métodos equals y hashCode.

Veamos ahora como se implementan ambos métodos:

1 | Implementación de equals
@Override
public boolean equals(Object obj) {
    if (this == obj) {
        return true;
    }
    if (obj == null) {
        return false;
    }
    if (Hibernate.getClass(this) != Hibernate.getClass(obj)) {
        return false;
    }
 
    Usuario usuario = (Usuario) obj;
    Object dato1=getLogin() ;
    Object dato2=usuario.getLogin();
 
    if (dato1 == null) {
        if (dato2==null) {
            return true;
        } else {
            return false;
        }
    } else if (dato1.equals(dato2) == true) {
        return true;
    } else {
        return false;
    }
}

Pasemos ahora a explicar como funciona el método:

En el famoso libro Effective Java (2nd Edition) se trata el tema de como comparar si dos clases son del mismo tipo. Joshua Bloch 2) indica usar la orden instanceof sin embargo hay otra opción que es usar getClass(). En la siguiente entrevista a Joshua Bloch instanceof versus getClass in equals Methods justifica su decisión indicando que una subclase de la clase también podría ser igual si tienen los mismos valores.

Mi opinión personal es que usando Hibernate al hacer una subclase lo normal es que se añadan campos , por lo tanto estaremos haciendo referencia a mas filas de la base de datos, por ello es preferible usar getClass(). El problema de usar getClass() es que Hibernate puede usar objetos proxy y el método getClass() no funcionará. Por suerte Hibernate nos da la solución a este pequeño problema usando el método Hibernate.getClass(Object obj).

1 | Implementación de hashCode
@Override
public int hashCode() {
    Object dato1=getLogin() ;
    int resultado;
 
    resultado = 31 * resultado + (dato1 == null ? 0 : dato1.hashCode());
 
    return resultado;
}

El código de este método es bastante sencillo aunque el porqué de ello es mas complejo y no entraremos a explicarlo sin embargo en el libro Effective Java (2nd Edition) hay una explicación de ello.

Con toda esta explicación no debería ser difícil crear nuevas funciones equals y hashCode para otras clases que se usen en Hibernate.

Referencias

1)
Realmente hay más opciones con soluciones mas complejas y barrocas pero no vamos a entrar en ello.
2)
autor del libro, creador del framework de colecciones en Java, etc.
3)
Se usa este valor por ser un número primo: Why do hash functions use prime numbers?