Asociación One To Many

Intermedio
Hibernate
Hibernate
Hoy: 25/10/2025

Introducción

La asociación OneToMany en Hibernate es uno de los conceptos fundamentales en la persistencia orientada a objetos cuando se mapea una relación de uno a muchos entre dos entidades. Una relación OneToMany entre dos entidades implica que una instancia de la entidad A puede tener múltiples instancias de la entidad B asociadas a ella, pero una instancia de la entidad B solo puede estar asociada a una instancia de la entidad A. Un ejemplo clásico de esto es una relación entre Usuario y Telefono. Un usuario puede tener varios números de teléfono, pero un número de teléfono pertenece a un solo usuario.

Anotaciones

Para mapear la relación OneToMany en Hibernate de forma unidireccional, se utiliza la anotación @OneToMany.

Entidad Usuario

import jakarta.persistence.*;

@Entity
public class Usuario {
    
    @Id
    @GeneratedValue(strategy = GenerationType.IDENTITY)
    private Long id;

    private String nombre;

    @OneToMany(cascade = CascadeType.ALL, orphanRemoval = true)
    @JoinColumn(name = "usuario_id")  // Esto especifica la columna de clave foránea en la entidad 'Telefono'
    private List<Telefono> telefonos = new ArrayList<>();

    // getters, setters y otros métodos ...
}

En este código:

  1. Se define una lista de Telefono y se anota con @OneToMany. Dado que no hay una relación inversa @ManyToOne, es necesario especificar la columna de clave foránea usando @JoinColumn.

Operación en cascada

cascade = CascadeType.ALL: Especifica que las operaciones de persistencia (como persistir, actualizar, eliminar) que se realicen en Usuario se cascaden a las entidades Telefono asociadas.

Borrar entidades huérfanas

orphanRemoval = true: Indica que cuando se elimina un Telefono de la colección de telefonos en Usuario, dicho Telefono debe ser eliminado de la base de datos.

En resumen, permiten propagar operaciones de la entidad principal a las entidades relacionadas y eliminar entidades huérfanas de la base de datos, respectivamente.

Ejemplo de uso

Para agregar un nuevo teléfono a un usuario:

Usuario usuario = new Usuario();
usuario.setNombre("Juan");

Telefono telefono = new Telefono();
telefono.setNumero("123-456-789");

usuario.getTelefonos().add(telefono);

session.save(usuario);  // Esto guardará tanto el usuario como el teléfono gracias a la cascada.

Tipo de carga

En el contexto de asociaciones @OneToMany en Hibernate:

FetchType.LAZY (Carga perezosa):

  • Es el tipo de carga por defecto para asociaciones @OneToMany.
  • Las entidades relacionadas no se cargan inmediatamente cuando se carga la entidad principal. En su lugar, se cargan cuando se accede a ellas por primera vez.
  • Ayuda a mejorar el rendimiento al no cargar innecesariamente todas las relaciones.

FetchType.EAGER (Carga temprana):

  • Las entidades relacionadas se cargan inmediatamente junto con la entidad principal.
  • Puede afectar negativamente el rendimiento si no se maneja adecuadamente, ya que puede llevar a la carga de una gran cantidad de datos no deseados.

El tipo de carga (fetch type) puede afectar significativamente el rendimiento y debe seleccionarse cuidadosamente según las necesidades de la aplicación.

Consideraciones

Unidireccionalidad: A diferencia del mapeo bidireccional, en una relación unidireccional @OneToMany no es posible navegar desde Telefono a Usuario directamente a menos que se introduzca otro mapeo o consulta.

Rendimiento: El uso de relaciones OneToMany puede tener un impacto en el rendimiento, especialmente si no se manejan correctamente. Por ejemplo, el uso excesivo de la carga eager (EAGER) puede llevar a problemas como el efecto N+1. Si bien una relación unidireccional puede parecer más simple, aún es necesario tener cuidado con las consideraciones de rendimiento, especialmente con respecto a la carga de datos.

Orden y Duplicados: Las relaciones OneToMany pueden usar colecciones de tipo List o Set. Las listas mantienen el orden y permiten duplicados, mientras que los sets no mantienen el orden y no permiten duplicados.

En conclusión, la anotación @OneToMany en Hibernate facilita la representación de relaciones unidireccionales de "uno a muchos". Aunque es más sencilla que la relación bidireccional, es esencial comprender sus implicaciones para garantizar una correcta persistencia y rendimiento.

Fuentes y referencias

Documentación oficial y recursos externos para profundizar en Hibernate

Documentación oficial de Hibernate
Alan Sastre - Autor del tutorial

Alan Sastre

Ingeniero de Software y formador, CEO en CertiDevs

Ingeniero de software especializado en Full Stack y en Inteligencia Artificial. Como CEO de CertiDevs, Hibernate es una de sus áreas de expertise. Con más de 15 años programando, 6K seguidores en LinkedIn y experiencia como formador, Alan se dedica a crear contenido educativo de calidad para desarrolladores de todos los niveles.

Más tutoriales de Hibernate

Explora más contenido relacionado con Hibernate y continúa aprendiendo con nuestros tutoriales gratuitos.

Aprendizajes de esta lección

  1. Entender el concepto de la asociación OneToMany en Hibernate y cómo representa relaciones "uno a muchos".
  2. Aprender a configurar esta asociación mediante la anotación @OneToMany y @JoinColumn para la clave foránea.
  3. Comprender el uso de las anotaciones cascade y orphanRemoval para administrar operaciones de persistencia y eliminación.
  4. Distinguir entre los tipos de carga (EAGER y LAZY) y cómo afectan el rendimiento de la consulta.
  5. Reconocer que las relaciones OneToMany pueden ser unidireccionales, lo que implica la necesidad de acceder a través de consultas si se requiere navegación desde el lado relacionado.

Cursos que incluyen esta lección

Esta lección forma parte de los siguientes cursos estructurados con rutas de aprendizaje