Fundamentos de uso de Quarkus

Quarkus es un framework Java para crear aplicaciones web orientadas fundamentalmente al modelo de microservicio. Compila a nativo con GraalVM y permite crear aplicaciones compactas de arranque rápido y ligeras, listas para llevar a la nube. Está basado en MicroProfile, una alternativa que ha surgido en los últimos años a Spring y que no es más que el Java EE de siempre pero manteniendo únicamente las bibliotecas más interesantes para crear aplicaciones ligeras. A lo largo de este tutorial iré mostrando los pasos para desarrollar una API REST con Quarkus.

En este vídeo haremos un par de endpoints de texto para presentar cómo usar las anotaciones @Path y @GET. Podréis apreciar que en Quarkus para implementar un endpoint todo lo que hay que hacer es implementar funciones que devuelvan cosas como strings. Mientras hayamos agregado Jackson cuando creamos el proyecto, Quarkus sabrá cómo convertir esto a una respuesta.

Cómo usar PathParam y QueryParam para especificar en la URL ciertas variables y que su contenido esté disponible desde las funciones de nuestros endpoints. De este modo podemos hacer endpoints cuyo comportamiento dependa de la información que le enviemos como parámetro. En este vídeo vemos estas dos formas de enviar información, que será complementado en el futuro con el envío de cargas completas compatibles con otro tipo de verbos HTTP.

Con la extensión Jackson podemos simplemente olvidarnos de convertir las cosas a JSON. Jackson sabe inspeccionar los tipos de datos que nuestros métodos devuelven y convertirlos a JSON si se lo pedimos. De este modo, podemos fácilmente crear entidades específicas que se corresponden con modelos y devolverlos como resultado de nuestros endpoints, para dejar que lleguen al consumidor de nuestra API como si fuesen objetos JSON normales.

En esta lección muestro cómo hacer un endpoint dentro de nuestro recurso que tiene la anotación POST para indicar que se debe ejecutar cuando la petición usa el verbo HTTP POST, y cómo podemos leer el payload mediante Jackson para convertirlo directamente a un objeto, como una clase. Quarkus también se va a ocupar de transformar el JSON de entrada en una instancia de la clase que le proporcionemos como parámetro.

Esta lección será fácil para personas que ya hayan hecho en Spring u otros frameworks al uso. En esta lección veremos el patrón Service Object, para desacoplar la lógica de negocio del controlador HTTP. Mediante inyección de depednencia instanciaremos automáticamente ese servicio en el controlador.

Con Response y ResponseBuilder podemos fabricar respuestas con códigos de estado personalizados y agregando cabeceras de respuesta específicas. Es algo que querremos hacer cuando tengamos que entregar algo que no sea HTTP 200, como por ejemplo prevenir errores en nuestra aplicación.

ExceptionMapper es una alternativa para el tratamiento de errores con el que podemos hacer que en caso de lanzarse una excepción por parte de alguno de los endpoints que hemos metido en nuestra API, se convierta en la respuesta correspondiente. Así podemos fabricar un conjunto de respuestas reusables asociadas a excepciones concretas que se comparten por toda la aplicación.