Acceso a datos con Quarkus

Quarkus tiene soporte para el Hibernate ORM, permitiendo persistir y recuperar información en una base de datos a través de una conexión JPA estandar. Sin embargo, Quarkus también trae una biblioteca llamada Panache que va a simplificar el acceso a base de datos mediante repositorios (al estilo Spring), e incluso entidades ActiveRecord o usando modernas técnicas de programación reactiva.

En este capítulo hacemos un recurso que interactúa con una base de datos. Para ello, será necesario antes mostrar cómo crear una entidad de JPA que podamos luego persistir a través de un PanacheRepository, que es la alternativa que ofrece Panache a tener que levantar manualmente un EntityManager como se suele hacer cuando vamos con el ORM sin nada de ayuda.

El patrón Active Record será conocido para gente que venga de frameworks como Django, Laravel o Ruby on Rails. En este caso, las clases de datos además de recordar los datos traídos o por enviar a base de datos, disponen de métodos que permiten interactuar con la base de datos. Es decir, en vez de tener el repositorio como una clase aparte, todos esos métodos están metidos dentro de la propia entidad.

Los repositorios y las entidades tienen más métodos, tanto para eliminar un registro como para recuperarlo. También es posible hacer modificaciones sobre una entidad si la volvemos a pasar al método persist() después de haberla recuperado previamente desde el propio repositorio. En este vídeo completo el CRUD.

Con el método find() podemos obtener listas de entidades donde aplicamos criterios de filtro. En este vídeo presento cómo aplicar filtros usando HQL o bien de la forma más simple, pasándole directamente un campo y su valor esperado. También introduzco al uso de Sort para aplicar criterios de ordenación.

PanacheQuery nos permite cuidar más la query que queremos que se mande a la base de datos, aprovechando el poder de Hibernate ORM, que es lo que lleva debajo. En este vídeo veremos cómo aplicar paginación a una query para poder ofrecer menos resultados por endpoint y así no someter a tanto estrés a la base de datos.

Filter y FilterDef son dos anotaciones de Hibernate ORM (lo que hay por debajo de Panache) usadas para crear filtros dinámicos con nombre. Si queremos que nuestro PanacheQuery pueda recibir una cadena de filtros, podemos usarlos para aplicar sucesivas cadenas de criterios para reducir los resultados devueltos por el repositorio.

Si queremos modificar la forma en la que se serializa a JSON una entidad, tenemos las anotaciones JsonIgnore, JsonProperty y JsonAlias para influir en la forma en la que Jackson serializa nuestra entidad, para ocultar campos o renombrarlos.