Josel Toro: 2. Gestión de la capa de persistencia

¡Bienvenidos a todos! Esta publicación formará parte de una serie de 10 publicaciones que estaré desarrollando para aprender a crear una aplicación web en Java, bajo la plataforma JEE usando los frameworks de JPA y JSF. Este será un curso en forma de guía para todas aquellas personas que estén empezando en el mundo de la programación web.

En este curso aprenderemos a desarrollar aplicaciones web en N-CAPAS utilizando los patrones de diseño JEE, el estilo arquitectónico MVC y las funcionalidades provistas por los framework JSF (Java Server Faces) a nivel de vista-controlador y por JPA (Java Persistence API) a nivel de persistencia.

Este curso estará dividido en dos partes, En la primera parte, aprenderemos a configurar y utilizar el framework JPA mediante el desarrollo de aplicaciones Stand.Alone. En la segunda parte, aprenderemos a utilizar el framework JSF para desarrollar aplicaciones web. Por último, integraremos las funcionalidades de ambos frameworks en una aplicación final.

APLICACIÓN STAND-ALONE

Continuando con el post anterior donde vimos una primera aproximación al uso de JPA implementando un proyecto Stand-Alone que permita realizar un CRUD a una tabla determinada. Hoy, aprenderemos a crear una clase EntityListener para monitorear el ciclo de vida de una entidad.

OBJETIVOS

. Definimos un EntityListener para comprender el Ciclo de Vida de una Entidad.

. Definimos más anotaciones (@Basic, @Column, @Transient).

. Definimos estrategias de generación de llave primaria usando (Identity, table, AUTO).

PASOS

1. Ejecutar el proyecto del post anterior

Paso 1: Importar el proyecto del post anterior

Vamos a crear una copia del proyecto de la sesión anterior y le cambiaremos el nombre a "Aplicacion_JPA_02".

Después de importar nuestro proyecto, ejecutamos el archivo "script1" que se encuentra dentro de la carpeta "bd". Asimismo, es opcional cambiar el nombre a la unidad de persistencia en el archivo "persistence.xml" y también la referencia a ella en el método "setup" de la clase "EmpleadoJPA", las cuales tienen el nombre del proyecto anterior "Aplicacion_JPA_01". Ustedes pueden ponerle el nombre que deseen a su unidad de persistencia, yo le pondré "Aplicacion_JPA_02" para que vaya acorde con el nombre del proyecto.

persistence.xml...

<persistence-unit name="Aplicacion_JPA_02">"

EmpleadoJPA

"emf =Persistence.createEntityManagerFactory("Aplicacion_JPA_02");"

Ver como importar un proyecto JPA aquí.

El proyecto debe tener la siguiente estructura:

Seleccionamos la clase "EmpleadoTest", clic derecho al archivo, Run As/Java Application para ejecutar la aplicación.

Hasta aquí es lo que hemos visto en el post anterior.

2. Comprendiendo el Ciclo de Vida de una Entidad

Paso 1: Creación del Entity Listener

Dentro del paquete "edu.aprender.persistence.entity.listener" creamos la clase “EmpleadoListener.java” con las siguientes propiedades:

Paso 2: Uso del EntityListener

Utilizando anotaciones en la entidad “Empleado.java”.

a) Para asociar un Entity Listener a una Entidad se debe utilizar la anotación @EntityListeners la cual indica la clase que implementa los métodos “callbacks” gestionados por anotaciones como @PrePersist.

En la clase "Empleado.java" añadir la línea de código resaltada:

Paso 3: Probar aplicación

Nos dirigimos a la clase "EmpleadoTest", clic derecho, /Run As/Java Application para ejecutar la aplicación.

3. ORM y Anotaciones

Paso 1: Anotacions @Basic, @Column, @Transient

La anotación @Basic (que es opcional) se utiliza para indicar de forma explícita que dicho atributo debe ser almacenado en la base de datos. Por defecto, todas los atributos de una Entidad tienen asignada dicha anotación.

La anotación @Column (que es opcional) se utiliza para indicar las características físicas de la columna en la tabla de base de datos. Es necesario su uso por ejemplo cuando el nombre de la columna de la tabla de base de datos es distinto al del atributo definido en la Entidad.

Ejemplo:

Vamos a ejecutar este "script2" donde se ha modificado los nombre de las columnas:

Añadir anotaciones en la entidad “Empleado”, según lo resaltado y definir sus métodos de acceso getters and setters.

La anotación @Transient (que es opcional) se utiliza para indicar aquellos atributos que no forman parte de ninguna tabla relacional. Atributos cuyo valor se genera en tiempo de ejecución para realizar alguna funcionalidad, pero cuyo valor no necesita ser persistente.

Entonces la entidad "Empleado" quedaría de la siguiente manera:

Por ejemplo:

a) Añadir a la entidad "Empleado" el atributo “nombreCompleto”
b) Generar "getter/setter" y redefinir el método "toString()"
c) Probamos la aplicación

4. Manejo de Llave Primaria

Paso 1: @GenerateValue

Vamos a definir una estrategia de generación de llave Primaria

Estrategia 1 usando "IDENTITY"

Añadir en la entidad "Empleado" lo resaltado:

@Id
@Column(name="COD_EMP",unique=true,nullable=false) 
@GeneratedValue(strategy= GenerationType.IDENTITY)
private int id;

En la clase "EmpleadoTest" comentar la línea resaltada y volver a Probar:

public static void main(String[] args) {
   EmpleadoJPA empleadoJPA = new EmpleadoJPA();
   empleadoJPA.setup();
  
   // Entidad con datos estáticos
   Empleado entidadEmpleado = new Empleado();
   //entidadEmpleado.setId(1);
   entidadEmpleado.setNombre("Antonio");
   entidadEmpleado.setApellido("Perez");
   entidadEmpleado.setEdad(30);
   entidadEmpleado.setArea("Sistemas");

Revisar en el log el código autogenerado

Estrategia 2 usando "TABLE"

Crear una tabla adicional en la base de datos de ejemplo, según el "script3":

use mysqljpa;

DROP TABLE IF EXISTS tb_secuencia;
CREATE TABLE tb_secuencia(
  descripcion varchar(10) NOT NULL,
  valor int(10) NOT NULL,
  PRIMARY KEY (descripcion)
);

insert into tb_secuencia values('empleado',0);

En la entidad "Empleado" añadir el código resaltado:

@Id
@Column(name="COD_EMP",unique=true,nullable=false)
@GeneratedValue(strategy= GenerationType.TABLE, generator="generador")
@TableGenerator(name="generador", table="tb_secuencia", pkColumnName="descripcion",valueColumnName="valor", pkColumnValue="empleado", allocationSize=1)
private int id;

Probar aplicación y revisar en el log el código autogenerado

Estrategia 3 usando "AUTO"

En la entidad "Empleado" actualizar según el código resaltado:

@Id
@Column(name="COD_EMP",unique=true,nullable=false)
@GeneratedValue(strategy= GenerationType.AUTO, generator="generador")
@TableGenerator(name="generador", table="tb_secuencia", pkColumnName="descripcion",valueColumnName="valor", pkColumnValue="empleado", allocationSize=1)
private int id;

En el caso de Mysql, la estrategia "AUTO" selecciona como mejor opción obtener el código de la tabla “sequence”, en caso de tener una tabla con nombre distinto pero con las mismas características, hay que indicar un "TableGenerator", tal cual se ve en el ejemplo.

Probar la aplicación y revisar el log el código autogenerado.

La clase entidad Empleado.java

ESTRUCTURA FINAL DEL PROYECTO