Dada la creciente demanda de construir aplicaciones SOA (Arquitectura Orientada a Servicios), es interesante ver como se construye rápidamente una api RESTFUL con Java y Spring. Para ello me baso en el tutorial básico de la página oficial de spring.io (link is external).
En dicho tutorial, se puede descargar el proyecto con estructura Maven o Gradle. El proyecto es tan simple como que únicamente tiene una depencencia con la librería Spring Boot, aunque también sería interesante utilizar la librería Jackson, para convertir objetos en formato json, un formato estandar utilizado para las peticiones(Request) y las respuestas(Response).
Para aquellos que aún no conocen la filosofía REST, en pocas palabras consiste en hacer las operaciones típicas de una aplicacion, crear, actualizar, eliminar, listar, y buscar, mediante las operaciones HTTP básicas:
- GET. Recuperar un objeto o conjunto de objetos. Ejemplo, /ver/municipio/43, devolvería un objeto municipio en un cierto formato(JSON, XML,…).
- POST. Crea un nuevo recurso/objeto. /crear/municipio Crea un municipio con el contenido que se envia en un cierto formato.
- PUT. Crear un nuevo recurso/objeto, o actualizarlo, ejemplo: /actualizar/municipio/43 con un objeto xml o json en la petición.
- DELETE. Se utiliza para eliminar recursos, ejemplo: llamada a hastalasnubes.com/borrar/municipio/43
Más informacion:
https://spring.io/guides/gs/rest-service/ (link is external)
http://javapapers.com/java/java-restful-web-services-with-json-and-jersey/ (link is external)
http://javapapers.com/web-service/restful-services-crud-with-java-jax-rs-jersey/ (link is external)