Al persistir dos clases serán necesarios dos ficheros de persistencia:

• Profesor.hbm.xml
• CorreoElectronico.hbm.xml

El fichero Profesor.hbm.xml quedará de la siguiente forma:

1| Fichero Profesor.hbm.xml

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE hibernate-mapping PUBLIC "-//Hibernate/Hibernate Mapping DTD 3.0//EN" "http://www.hibernate.org/dtd/hibernate-mapping-3.0.dtd">
<hibernate-mapping>
  <class name="ejemplo05.Profesor" >
    <id column="Id" name="id" type="integer"/>
    <property name="nombre" />
    <property name="ape1" />
    <property name="ape2" />
 
    <set name="correosElectronicos"  cascade="all" inverse="true"  >
        <key>
            <column name="idProfesor"  />
        </key>            
        <one-to-many class="ejemplo05.CorreoElectronico" />
    </set>
  </class>
</hibernate-mapping>

El fichero básicamente contiene lo que se ha explicado en las lecciones anteriores excepto por el tag <set> (líneas 10 a 15).

El tag <set> se utiliza para definir una relación uno a muchos desordenada entre las dos clases Java.

• name: Es el nombre de la propiedad Java del tipo Set en la cual se almacenan todos los objetos hijos.En nuestro ejemplo el valor es correosElectronicos ya que es la propiedad que contiene el Set.
• cascade: Como ya hemos explicado en anteriores lecciones, este atributo indica que se realizan las mismas operaciones con el objeto padre que con los objetos hijos, es decir si uno se borra los otros también, etc. Su valor habitual es all.
• inverse: Este atributo se utiliza para minimizar las SQLs que lanza Hibernate contra la base de datos.En este caso concreto debe establecerse a true para evitar una sentencia SQL de UPDATE por cada hijo. Al final de esta sesión se indican enlaces donde intentan explicar (desde mi punto de vista con poco éxito) el funcionamiento del atributo inverse.

• key Este tag contiene otro anidado llamado column con el atributo name que indica el nombre de una columna de la base de datos. Esta columna debe ser de la tabla hijo y ser el nombre de la clave ajena a la tabla padre. En nuestro ejemplo es idProfesor ya que es el nombre de la clave ajena en la tabla CorreoElectronico.
• one-to-many Este tag contiene el atributo class con el FQCN de la clase Java hija. En nuestro ejemplo es el nombre de la clase CorreoElectronico cuyo FQCN es ejemplo05.CorreoElectronico.

org.hibernate.MappingException: Association references unmapped class: null

El fichero CorreoElectronico.hbm.xml quedará de la siguiente forma:

1| Fichero CorreoElectronico.hbm.xml

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE hibernate-mapping PUBLIC "-//Hibernate/Hibernate Mapping DTD 3.0//EN" "http://www.hibernate.org/dtd/hibernate-mapping-3.0.dtd">
<hibernate-mapping>
  <class name="ejemplo05.CorreoElectronico" >
    <id column="IdCorreo" name="idCorreo" type="integer"/>
    <property name="direccionCorreo" />
 
 
    <many-to-one name="profesor">
            <column name="idProfesor"  />
    </many-to-one>
 
 
  </class>
</hibernate-mapping>

El fichero básicamente contiene lo que se ha explicado en las lecciones anteriores excepto por el tag <many-to-one> (líneas 9 a 11).

El tag <many-to-one> se utiliza para definir una relación muchos a uno entre las dos clases Java.

• name: Es el nombre de la propiedad Java que enlaza con el objeto padre. En nuestro ejemplo el valor es profesor ya que es la propiedad que contiene la referencia a la clase Profesor.

• column Este tag contiene el atributo name que indica el nombre de una columna de la base de datos. Esta columna debe ser de la tabla hijo y ser el nombre de la clave ajena a la tabla padre. En nuestro ejemplo es idProfesor ya que es el nombre de la clave ajena en la tabla CorreoElectronico.

Para usar notaciones deberemos modificar el código fuente de las clases Java y no usar los ficheros .hbm.xml.

El código fuente de la clase Profesor queda de la siguiente forma:

1 | Clase Profesor anotada

@Entity
@Table(name="Profesor")
public class Profesor implements Serializable  {
 
    @Id
    @Column(name="Id")
    private int id;
 
    @Column(name="nombre")
    private String nombre;
 
    @Column(name="ape1")
    private String ape1;
 
    @Column(name="ape2")    
    private String ape2;
 
    @OneToMany(mappedBy="profesor",cascade= CascadeType.ALL)
    private Set<CorreoElectronico> correosElectronicos;
 
 
    public Profesor(){ 
    }
 
    public Profesor(int id, String nombre, String ape1, String ape2) {
        this.id = id;
        this.nombre = nombre;
        this.ape1 = ape1;
        this.ape2 = ape2;
    }
}

A la propiedad correosElectronicos se ha añadido una anotación para indicar la relación uno a muchos.

• OneToMany:Como su nombre indica le dice a Hibernate que esta propiedad contendrá la lista de hijos.
  • mappedBy: Este atributo contendrá el nombre de la propiedad Java de la clase hija que enlaza con la clase padre. En nuestro ejemplo es el nombre de la propiedad profesor que se encuentra en la clase CorreoElectronico.
  • cascade: Este atributo tiene el mismo significado que el del fichero de mapeo de Hibernate. Mas información en Cascade.

El código de la clase CorreoElectronico es el siguiente:

1 | Clase CorreoElectronico anotada

@Entity
@Table(name="CorreoElectronico")
public class CorreoElectronico implements Serializable {
 
    @Id
    @Column(name="IdCorreo")    
    private int idCorreo;
 
    @Column(name="DireccionCorreo")
    private String direccionCorreo;
 
    @ManyToOne
    @JoinColumn(name="IdProfesor")
    private Profesor profesor;
 
    public CorreoElectronico() {
 
    }
 
    public CorreoElectronico(int idCorreo,String direccionCorreo,Profesor profesor) {
        this.idCorreo=idCorreo;
        this.direccionCorreo=direccionCorreo;
        this.profesor=profesor;
    }
}

A la propiedad profesor se han añadido dos anotaciones para indicar la relación:

• ManyToOne:Al ser el otro lado de la relación indicamos que desde este lado es una relación muchos a uno.
• JoinColumn: Indicaremos el nombre de la columna que en la tabla hija contiene la clave ajena a la tabla padre. En nuestro ejemplo es la columna de la base de datos IdProfesor que se encuentra en la tabla CorreoElectronico la cual enlaza con la tabla Profesor.

Ahora que ya tenemos preparadas las clase Java para que puedan persistirse veamos el código necesario para persistirlas.

1 | Persistiendo la clase Profesor

Profesor profesor=new Profesor(7, "Sara", "Barrrera", "Salas");
Set<CorreoElectronico> correosElectronicos=new HashSet<>();
correosElectronicos.add(new CorreoElectronico(3, "sara@yahoo.com",profesor));
correosElectronicos.add(new CorreoElectronico(2, "sara@hotmail.com",profesor));
correosElectronicos.add(new CorreoElectronico(1, "sara@gmail.com",profesor));
 
profesor.setCorreosElectronicos(correosElectronicos);
 
Session session=sessionFactory.openSession();
session.beginTransaction();
 
session.save(profesor);
 
 
session.getTransaction().commit();
session.close();

La explicación del código es la siguiente:

• En la línea 1 se crea el objeto Profesor
• En la segunda línea se crea el objeto HashSet que implementa el interfaz Set el cual contendrá la lista de hijos.
• Desde las líneas 3 a la 5 se crean los objetos CorreoElectronico y se añaden al Set.
• En la línea 7 se establece la relación entre la lista de hijos (CorreoElectronico) y el padre (Profesor).
• En la línea 12 se guarda el objeto Profesor y automáticamente se guardan también sus hijos.

• inverse = “true” example and explanation : Explicación en inglés del atributo inverse.
• Hibernate: When is "inverse=true" and when it's not? : Otra explicación en inglés del atributo inverse.
• Different between cascade and inverse : Explicación en inglés de las diferencias entre los atributos cascade e inverse.