Ejemplo de listener de eventos de Hibernate

Publicado por pico.dev el , actualizado el .
blog-stack java planeta-codigo programacion
Comentarios

Java

En alguna ocasión puede que tengamos la necesidad de realizar alguna acción cuando una entidad es guardada en base de datos, actualizada, eliminada, cargada, … . Algunos casos de uso pueden ser:

  • Establecer la fecha de creación o de actualización del objeto cuando es persistido en base de datos.
  • Cifrar un dato del objeto al ser persistido en base de datos.
  • Proporcionar seguridad de modo que un usuario solo pueda modificar o acceder a los objetos a los que tenga acceso.
  • Al persistir el objeto guardar en un campo el valor calculado resultado de una función.
  • Cualquier otra restricción, cálculos o acciones.

Para realizar estas operaciones podemos hacerlas de varias formas, una puede ser usando triggers de la base de datos disponibles en Oracle y PostgreSQL. Si usamos Hibernate como librería ORM de persistencia en una aplicación el equivalente a los triggers de BBDD es mediante un listener que sea llamado al ocurrir ciertos eventos. En la clase EventType está la lista completa de los eventos que podemos recibir y la clase listener que debemos implementar para recibir cada uno de los eventos. Esta es la lista de los eventos disponibles según los conceptos que usa Hibernate:

  • AUTO_FLUSH
  • CLEAR
  • DELETE
  • DIRTY_CHECK
  • EVICT
  • FLUSH
  • FLUSH_ENTITY
  • INIT_COLLECTION
  • LOAD
  • LOCK
  • MERGE
  • PERSIST
  • PERSIST_ONFLUSH
  • POST_COLLECTION_RECREATE
  • POST_COLLECTION_REMOVE
  • POST_COLLECTION_UPDATE
  • POST_COMMIT_DELETE
  • POST_COMMIT_INSERT
  • POST_COMMIT_UPDATE
  • POST_DELETE
  • POST_INSERT
  • POST_LOAD
  • POST_UPDATE
  • PRE_COLLECTION_RECREATE
  • PRE_COLLECTION_REMOVE
  • PRE_COLLECTION_UPDATE
  • PRE_DELETE
  • PRE_INSERT
  • PRE_LOAD
  • PRE_UPDATE
  • REFRESH
  • REPLICATE
  • RESOLVE_NATURAL_ID
  • SAVE
  • SAVE_UPDATE
  • UPDATE

Con estos eventos podemos ser notificados de muchas cosas que suceden internamente en Hibernate en algunos casos antes y/o después del evento. En JPA se dispone de varias anotaciones (@PreInsert, @PostInsert, …) con las que podemos marcar un determinado método como listener de un evento pero no funcionan si usamos únicamente Hibernate.

En este artículo explicaré como implementar un listener de ejemplo que reciba parte de estos eventos usando solo Hibernate. Primeramente e importante, debemos tener en cuenta que el proceso como reacción a uno de estos eventos ha de ser muy ligero y tardar poco tiempo ya que algunos eventos son lanzados por cada instancia de entidad como consecuencia de operaciones muy frecuentes en una aplicación, si tardasen mucho o consumiesen mucha memoria o tiempo de procesador probablemente el rendimiento de la aplicación disminuiría notablemente.

Como se ve en la clase EventType cada evento tiene un listener distinto, para evitar crear una clase diferente por cada listener podemos emplear el patrón de diseño Adapter de forma que implemente las diferentes interfaces en las que estamos interesados. La implementación de la clase Adapter y una implementación de esta clase Adapter si nos interesasen los eventos PRE_INSERT, PRE_UPDATE, PRE_DELETE, POST_INSERT, POST_UPDATE, POST_DELETE sería la siguiente:

Una vez que tenemos la clase que va a recibir los eventos para que Hibernate la use debemos crear un Integrator que lo instanciará y la dará a conocer a Hibernate. En el siguiente código puede verse una implementación de un Integrator de Hibernate, en el se instancia el listener y se asocia a los diferentes eventos. En este caso solo se crea un listener pero perfectamente podríamos asociar varios listeners al mismo evento:

Finalmente, para que Hibernate conozca la existencia de este Integrator debemos crear un archivo que contenga el nombre completo de la clase Integrator. El archivo ha de estar en de un librería .jar en la ubicación /META-INF/services/org.hibernate.integrator.spi.Integrator y disponible en el classpath. El contenido de este archivo para el ejemplo es:

Con esto ya recibiremos los eventos cuando ocurran. En el ejemplo aparecerá en la consola los mensajes cuando se inserte, actualice o elimine una fila de base de datos. En las capturas de imagen se muestran las trazas de una inserción, una traza para la preinseción Action: preInsert, Id: null donde se ve que la entidad no tienen identificativo asignado y otra traza después de la inserción Action: postInsert, Id: 1 donde la entidad ya tiene identificativo asignado y la sentencia SQL se ha ejecutado, como se ve en la captura los mensajes salen antes y después de ejecutarse la sentencia SQL que se envía a la base de datos.

Otra implementación distinta a la expuesta en este artículo es con anotaciones tal y como hace JPA, podríamos hacer una implementación de listener que busque una anotación en la entidad y llame a ese método cuando se produzca el evento. Depende de como prefiramos organizar el código, si preferimos tener el código del listener separado de la entidad o todo el código en la propia entidad.

Esto así puede servirnos pero si el listeners es más complejo debamos hacer uso de un servicio de Spring, en el ejemplo mostrado se usa la clase DummyService.java que es instanciada por HibernateIntegrator.java e inyectada en la clase adaptador ProductoEventAdapter.java. En el siguiente artículo explicaré lo que debemos hacer para crear un listener de Hibernate que use servicios de Spring e inyecte dependencias de otros servicios, de esta forma el listener o adaptador podrá usar todas las funcionalidades de los servicios disponibles en el contenedor IoC de Spring.

El código fuente completo del ejemplo lo puedes encontrar en mi repositorio de GitHub.