Tutorial Hibernate: Asociación One To One

Introducción

La asociación One To One en Hibernate es uno de los tipos de asociaciones entre entidades que representan una relación uno a uno entre dos tablas en una base de datos. 

Es decir, un registro en la tabla A se relaciona con un solo registro en la tabla B y viceversa.

Configuración en Hibernate

La asociación One To One puede ser unidireccional o bidireccional.

Asociación unidireccional

Supóngase que se tienen dos entidades: Persona y LicenciaConducir.

import jakarta.persistence.*;
@Entity
public class Persona {
    
    @Id
    @GeneratedValue(strategy = GenerationType.IDENTITY)
    private Long id;
    private String nombre;

    @OneToOne
    @JoinColumn(name = "licencia_id")
    private LicenciaConducir licenciaConducir;
    // getters y setters
}

import jakarta.persistence.*;
@Entity
public class LicenciaConducir {

    @Id
    @GeneratedValue(strategy = GenerationType.IDENTITY)
    private Long id;
    private String numeroLicencia;
    // getters y setters
}

La anotación @OneToOne indica que se trata de una relación uno a uno. @JoinColumn especifica qué columna se debe usar como clave foránea. En este caso, la tabla Persona tendrá una columna licencia_id que será una clave foránea que hace referencia a la tabla LicenciaConducir.

Asociación bidireccional

El atributo mappedBy es crucial cuando se trata de relaciones bidireccionales en Hibernate. Sirve para definir el "lado no propietario" de la relación. Es decir, indica cuál de las dos entidades involucradas en una relación bidireccional es la que no controla directamente la asociación en la base de datos, pero aún necesita estar al tanto de ella.

Lado Propietario y Lado No Propietario: En una relación bidireccional, siempre hay un "lado propietario" y un "lado no propietario". El lado propietario es el que se encarga de actualizar la relación en la base de datos. Hibernate sólo considera la configuración del lado propietario cuando detecta cambios en la relación.

No se usa una columna extra: Cuando se usa mappedBy, Hibernate sabe que no tiene que crear una columna adicional en la base de datos para esa relación. Si no se usa, Hibernate podría tratar de crear dos columnas de clave foránea en ambas tablas, lo que no es correcto en una relación One-To-One.

Valor de mappedBy: El valor que se asigna al atributo mappedBy es el nombre del atributo en la entidad propietaria que mantiene la relación. No es el nombre de la columna en la base de datos.

Siguiendo el ejemplo anterior de Persona y LicenciaConducir:

import jakarta.persistence.*;
@Entity
public class Persona {
    
    @Id
    @GeneratedValue(strategy = GenerationType.IDENTITY)
    private Long id;
    private String nombre;

    @OneToOne
    @JoinColumn(name = "licencia_id")
    private LicenciaConducir licenciaConducir;
    // getters y setters
}

import jakarta.persistence.*;
@Entity
public class LicenciaConducir {

    @Id
    @GeneratedValue(strategy = GenerationType.IDENTITY)
    private Long id;
    private String numeroLicencia;

    @OneToOne(mappedBy = "licenciaConducir")
    private Persona persona;
    // getters y setters
}

Aquí, la entidad Persona es el lado propietario de la relación, porque tiene la anotación @JoinColumn. Esto significa que es responsable de gestionar la clave foránea (licencia_id) en la base de datos.

Por otro lado, LicenciaConducir tiene el atributo mappedBy con el valor "licenciaConducir", lo que indica que es el lado no propietario y que debe mirar el atributo licenciaConducir en la entidad Persona para entender la relación.