RatPack: Servicios REST fácil y rápido

Si alguna vez han tenido que implementar un servicio web usando REST, sabrán que hay muchas opciones para hacerlo. Spring tiene facilidades para implementarlos, hay estándares para realizarlos, y por supuesto hay una gran cantidad de frameworks que pueden estar dedicados a implementar servicios de este tipo o que son para aplicaciones web pero además pueden usarse para implementar servicios REST.

Una opción muy sencilla para REST es RatPack, un framework bastante ligero para hacer servicios REST como scripts en Groovy.

Con RatPack, simplemente definimos los servicios que queremos implementar, en un script de Groovy, y el framework se encarga de lo demás: el servicio se ejecutará como un servlet dentro de Jetty, despachando las peticiones HTTP a los URL's que nosotros hayamos definido.

Los scripts son muy sencillos. Un ejemplo de "hola mundo" en RatPack:

Para ejecutarlo, necesitamos tener en nuestra ruta de ejecutables el script   y entonces simplemente lo ejecutamos con la ruta al script:

Por default, RatPack recibe peticiones en el puerto 5000, pero esto es configurable. Si apuntan su navegador a , en su navegador aparecerá el texto  .

Por supuesto, se pueden recibir parámetros, de varias maneras. La manera REST es por supuesto como parte del URL, pero también se pueden mandar parámetros en un POST o en un GET. Por ejemplo:

Para activar el primer servicio, podemos simplemente usar y obtendremos la cadena  ; para activar el segundo servicio necesitamos hacer un HTTP POST al URL enviando como datos en el POST algo como  , para obtener el mismo resultado.

Se pueden definir servicios usando los 4 verbos estándar de REST:  ,  ,   y  . En teoría, además se pueden definir verbos personalizados; haciendo pruebas me di cuenta que no es así, pero una de las grandes ventajas del open source es el acceso al código y la libertad de modificarlo, de modo que pude implementar esta funcionalidad sin complicarme demasiado en mi copia del código, y ya envié los cambios al autor por si los quiere integrar a la versión oficial. Entonces, se puede registrar una ruta utilizando un verbo personalizado, por ejemplo:

Para que esto funcione, se necesita un cliente de HTTP que pueda enviar verbos además de POST y GET. Una opción es hacer telnet al puerto 5000 y teclear:

  (doble ENTER)

y se obtendrá el saludo  .

Se pueden registrar rutas con varios parámetros, no solamente uno, y el valor de cada parámetro se obtiene del mapa  . El mapa   sirve para obtener los valores que se recibieron en el query string del URL o como datos de un POST y ya vienen decodificados.

Se tiene también acceso a los encabezados y otros valores; hay un mapa   que contiene todos los encabezados de la petición HTTP. Las variables   y   nos dan acceso completo a la petición y respuesta del servlet, lo cual es útil por ejemplo para recibir y contestar datos como una imagen, manejando directamente los streams.

Se pueden usar también plantillas. Por ejemplo, se puede crear un archivo hola.html con lo siguiente:

Para usarla, se invoca el método   con el nombre de la plantilla (la cual será buscada en el directorio desde donde se ejecutó ratpack) y opcionalmente un mapa con valores a sustituir. En este caso, se puede pasar directamente el mapa  :

Y ahora al pedir en el navegador, ya veremos un saludo formateado en HTML.

El script de Groovy puede contener referencias a otros componentes, se pueden tener variables fuera de la definición de las rutas (que a fin de cuentas son closures) y se pueden usar ahí. Esto nos permite por ejemplo definir un DataSource, o cargar un applicationContext de Spring, un cliente de web service, etc.

De entrada, yo he utilizado RatPack para prototipos de servicios, pero la verdad es que uno le va poniendo más código al script y al final ya no dan ganas de reescribirlo en otra cosa; si no es algo muy complicado, se puede levantar el script y simplemente configurar un proxy en el Apache httpd para redirigir las rutas pertinentes a RatPack.

Para mayor información se puede consultar , donde se hospeda el proyecto.