Flexibilidad en JPA persistence.xml y orm.xml

Antes de ayer Carlos Oliva un lector de mi blog me preguntó si habría forma de configurar de una manera mas flexible el fichero persistence.xml. Me pareció una pregunta interesante ya que aunque muchas veces con la configuración de JPA por defecto nos es suficiente, existen otras situaciones en las que podemos necesitar una mayor flexibilidad a nivel de persistence.xml. Este fichero se suele ubicar en la  META-INF de nuestra aplicación por lo menos es lo que el standard recomienda.

Ahora bien ¿puede estar  el fichero persistence.xml en algún otro sitio?

Persistence.xml y classpath

La respuesta es SI el fichero de persistence.xml se puede ubicar en cualquier carpeta que pertenezca al classpath siempre que este ubicado dentro de una carpeta META-INF.

ORM.XML

De esa forma podemos ubicar el fichero de persistencia en otras rutas que nos resulten mas interesantes .Ahora bien normalmente esto no es suficiente .Cuando se precisa flexibilidad a nivel de JPA es habitual recurrir al fichero orm.xml .¿Para que sirve este fichero? . Bueno sirve para muchas cosas pero quizás su característica principal es que se usa para eliminar las anotaciones de JPA del código y substituirlas por etiquetas XML . Vamos a ver un ejemplo sencillo de este fichero.

<?xml version="1.0" encoding="UTF-8"?>
<entity-mappings xmlns="http://java.sun.com/xml/ns/persistence/orm"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://java.sun.com/xml/ns/persistence/orm
http://java.sun.com/xml/ns/persistence/orm_2_0.xsd"
version="2.0">

<package>
com.arquitecturajava
</package>

<entity class="Persona">
<attributes>
<id name="nombre"></id>
<basic name="edad"></basic>
</attributes>
</entity>

</entity-mappings>

Como podemos ver el fichero incluye los mismos conceptos elementales de JPA pero en vez de a traves de anotaciones  a traves del uso de etiquetas xml . Esta solución aporta un enfoque “diferente” ya que las clases java no hará falta anotarlas y quedarán mucho mas limpias .

Ahora bien para mapear correctamente el fichero orm.xml .Este debe estar ubicado en el classpath y ser referenciado desde el persistence.xml a traves de la etiqueta <mapping-file></mapping-file>

<persistence xmlns="http://java.sun.com/xml/ns/persistence"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://java.sun.com/xml/ns/persistence
http://java.sun.com/xml/ns/persistence/persistence_2_0.xsd"
version="2.0">
< persistence-unit name="UnidadPersonas">
< mapping-file> orm.xml<  /mapping-file>
<properties>
<property name= "hibernate.show_sql" value="true" />
<property name="hibernate.dialect" value="org.hibernate.dialect.MySQLDialect" />
<property name="javax.persistence.jdbc.driver" value="com.mysql.jdbc.Driver" />
<property name="javax.persistence.jdbc.user" value="root" />
<property name="javax.persistence.jdbc.password" value="jboss" />
<property name="javax.persistence.jdbc.url" value="jdbc:mysql://localhost/jpa" />

</properties>

</persistence-unit>

</persistence>

Vamos a ver el código fuente de la clase Persona para ver como queda en el caso de que nos apoyemos en el fichero orm.xml

package com.arquitecturajava;
public class Persona {

private String nombre;
private int edad;
public Persona() {
super();

}

public Persona(String nombre, int edad) {
super();
setEdad(edad);
setNombre(nombre);
}
public String getNombre() {

return nombre;
}
public void setNombre(String nombre) {
this.nombre = nombre;

}

public int getEdad() {

return edad;
}
public void setEdad(int edad) {
this.edad = edad;

}

}

Podemos ver que ya no necesita de ningún tipo de anotación y se convierte en un objeto de negocio clásico . Creada la clase es momento de ver como la podríamos usar en un programa habitual de JPA que realice una inserción a traves del método persist.

package com.arquitecturajava;

import javax.persistence.EntityManager;
import javax.persistence.EntityManagerFactory;
import javax.persistence.Persistence;

public class Principal01Add {

public static void main(String[] args) {

Persona yo = new Persona("pedro",25);
EntityManagerFactory emf =
Persistence.createEntityManagerFactory("UnidadPersonas");
EntityManager em = emf.createEntityManager();
try {
em.getTransaction().begin();

em.persist(yo);
em.getTransaction().commit();
} catch (Exception e) {

e.printStackTrace();
}finally {
em.close();

}

}

}

El objeto persistirá en la base de datos sin problemas

Hemos terminado de construir un ejemplo de JPA que se apoya en el fichero orm.xml para realizar todos los mareos. Normalmente suele ser mas cómodo usar anotaciones sin embargo si necesitamos una gran flexibilidad en el desarrollo de nuestras aplicaciones es una buena idea utilizar el fichero orm.xml para ello.

Descargar :cursoJpa01ORM