Pro RESTful APIs

Guía técnica condensada de Sanjay Patni, publicada por Apress en 2017 y fundamentada en los programas académicos impartidos por el autor en la extensión de Silicon Valley de la Universidad de California Santa Cruz. La obra se orienta a desarrolladores web e ingenieros de software de nivel intermedio que dominan el lenguaje Java y la programación orientada a objetos, y buscan dominar de forma directa la especificación JAX-RS para construir, integrar y consumir servicios web basados en la arquitectura REST.

El contenido sigue una estructura descendente (top-down) que parte de los principios y restricciones de REST, pasando por el modelado de APIs con lenguajes de definición como RAML y la manipulación de formatos de intercambio de datos (JSON y XML). Luego se centra en la implementación práctica con JAX-RS y su implementación de referencia Jersey, cubriendo el ciclo de peticiones HTTP, anotaciones esenciales (@Path, @GET, @POST, @PUT, @DELETE, @Produces, @Consumes, @PathParam y @QueryParam) y la estructuración en capas de la cartera de APIs (Process, System y Experience APIs). Por último, explica la persistencia de datos mediante repositorios relacionales con MySQL y NoSQL con MongoDB, el consumo de servicios desde clientes Java y nociones de seguridad con OAuth 2.0, Spring Security y control de caché HTTP (ETags y cabeceras Cache-Control).

A lo largo de sus 126 páginas, el libro presenta laboratorios prácticos y fragmentos de código orientados a construir endpoints RESTful en Java conectados a bases de datos relacionales y documentales, sin articular un proyecto integral de gran escala ni incorporar ejercicios evaluables para el estudiante. Su principal mérito radica en su brevedad y carácter directo para asimilar JAX-RS y el ecosistema Java sin rodeos teóricos innecesarios; no obstante, deja fuera estándares actuales como OpenAPI 3.0, Spring Boot o arquitecturas de microservicios en la nube. Conviene tener solidez previa en Java SE y configuración de proyectos Maven antes de leerlo.