César Francisco Castillo - Desarrollo de aplicaciones web con Jakarta EE

A través de la variable em tendremos acceso a los métodos persist(), remove(), merge() y find(), entre otros.

La operación de inserción consiste en crear una nueva entidad y almacenarla en la base de datos. Veamos un ejemplo de cómo persistir una instancia de la entidad Facultad:

La búsqueda de una determinada entidad se realiza mediante el método find() , que recibe como parámetros la clase a la que pertenece la entidad y el valor de su clave primaria, y retorna una instancia de dicha entidad. Veamos un ejemplo de cómo buscar la facultad cuyo Id sea igual a 1:

Actualizar los valores de los atributos de una determinada entidad requiere la búsqueda de dicha entidad en la base de datos. Si el resultado de dicha búsqueda es exitoso, es decir, encontramos la entidad, podremos manipular sus atributos.

Observe el siguiente fragmento de código en el que se recupera una instancia de la entidad Facultad cuyo Id vale 1 y se cambia su nombre.

El método merge() devuelve la entidad de facultad a la base de datos con sus valores actualizados.

Imagine que un cliente llama a su compañía proveedora de servicios de telefonía móvil y solicita la baja por algún motivo. Dicha empresa accede a la petición y junto con la baja del servicio elimina también los registros asociados a ese cliente (así lo establecen las políticas empresariales). Ahora bien, ¿qué ocurriría si al cabo de unos meses el mismo cliente llama para solicitar el servicio nuevamente? ¿Debería la empresa pedirle sus datos personales de nuevo?

La respuesta depende de si la empresa borró “físicamente” los registros o solo realizó una “baja lógica” del cliente, y cambió su estado de activo a inactivo.

En la práctica, no se estila eliminar físicamente ningún registro de la base de datos (hablando de entornos de producción, claro, y no de pruebas), solo se cambian los estados.

Al igual que la operación de actualización, eliminar una entidad incluye una búsqueda. En el siguiente fragmento de código se eliminará físicamente la facultad cuyo id vale 1:

En caso de necesitar realizar una “baja lógica” se deberá utilizar el método merge() en lugar de remove().

Imagine que deseamos dar de alta una nueva facultad y, junto a ella, registrar las carreras que en ella se imparten (ya que en una misma facultad se pueden impartir distintas carreras).

Podríamos pensar en invocar el método persist() tantas veces como carreras tenga la facultad en cuestión. El siguiente fragmento de código refleja esta situación:

En su lugar, lo más adecuado sería crear una lista de carreras e ir añadiéndolas una a una. Al final, invocamos el método setCarrerasList() del objeto facultad, al cual pasaremos la lista. Después, persistiremos todo junto (Facultad y Carreras) en una sola llamada al método persist(), como se puede apreciar en el siguiente fragmento de código:

Si por alguna razón no se puede insertar el objeto facultad, tampoco se insertarán las distintas carreras. De este modo, nos aseguramos de no dejar la base de datos en un estado de inconsistencia.

Para que la persistencia en cascada pueda funcionar desde Facultad hacia Carrera, debemos editar la anotación @OneToMany que define la relación e incluir la constante PERSIST de la siguiente manera:

Veamos un pequeño ejemplo de persistencia en cascada, en el cual insertamos una facultad y, junto a ella, un listado de carreras generado en un bucle.

Como en la base de datos que acompaña a este libro el último registro insertado en la tabla carreras tiene un id igual a cuarenta y cuatro (id=44), empezaremos el bucle con el número cuarenta y cinco (i=45) para no obtener errores en la inserción por duplicación de claves primarias.

ThreadLocalRandom .current ().nextInt (2 ,4 )genera números aleatorios (solo admite como posibles valores 2 y 3) que representan el tipo de carrera (2 = grado, 3 = pregrado).

Observe que el método persist() se encuentra encerrado dentro de una transacción, ya que, de lo contrario, no se ejecutaría.

Tras la ejecución de este ejemplo se habrán insertado cinco nuevas carreras y una facultad con tan solo una llamada al método persist().

Por supuesto, en una práctica de la vida real no tendríamos que crear “a mano” uno a uno los objetos de tipo Carrera o cualquier otro tipo de objeto, sino que, tal vez, alguien ya habría creado un archivo de texto con cientos de registros y a nosotros, como programadores, nos tocaría la tarea de procesarlo, convirtiendo esos registros (filas) en un tipo de dato determinado para su posterior persistencia en una base de datos. El tema del procesamiento de archivos será analizado en el Apéndice B.