Parámetros RESTful con JAX-RS

02/Nov/2015 Java , , , , , Deja un comentario
Programación en Java

En este ejemplo vamos a ver cómo podemos pasar parámetros RESTful con JAX-RS. Es decir, que la URL de la petición RESTful contenga un parámetro, el cual vayamos a utilizar posteriomente. Para ello vamos a crear un servicio RESTful que nos salude y que el nombre de la persona a saludar esté en la URI de la petición.

Es decir que si ponemos /saludo/victor la respuesta sea Hola Víctor!.

Lo primero que tienes que hacer es configurar todo el entorno para que puedas utilizar JAX-RS. Para ello no dejes de leerte el artículo Servicios JAX-RS con Tomcat 7 y Jersey. Pero a modo resumido tienes que configurar las dependencias de Jersey en el POM.


  com.sun.jersey
  jersey-server
  1.8

Y configurar el Servlet de Jersey.


  Jersey REST Service
  com.sun.jersey.spi.container.servlet.ServletContainer
  
    com.sun.jersey.config.property.packages
    com.lineadecodigo.javaee.rest
  
  1


  Jersey REST Service
  /rest/*

Ahora vamos a crear nuestra clase ParametroRest.

@Path("saludo/{nombre}")
public class ParametroRest { ... }

En esta clase hemos utilizado la anotación @Path para poder indicar cual es la URI sobre la que atenderá el servicio RESTful. Además cuando hemos especificado la ruta vemos que el valor del parámetro que vamos a utilizar a posteriori aparece entre llaves.

Lo siguiente será crear el método que atienda a las peticiones GET. Para ello nos apoyaremos en la anotación @GET e indicaremos que contesta con código HTML mediante la anotación @Produces.

@GET
@Produces("text/html")
public String getSaludo() { .. }

Ahora tenemos que pasar el parámetro de la URI a este método. Para ello declararemos un atributo del método de tipo String al cual añadiremos la anotación @PathParam la cual tiene como parámetro el valor que pusimos entre las llaves del @Path.

@GET
@Produces("text/html")
public String getSaludo(@PathParam("nombre") String nombre) {
  return "

Hola " + nombre + "

"; }

Ahora ya podremos utilizar nuestro parámetro del método para componer la respuesta del servicio RESTful. Y así, de esta forma tan sencilla hemos conseguido configurar los parámetros RESTful con JAX-RS.

Vídeos sobre Java


¿Algo que nos quieras comentar?

Déjanos tu comentario, no te preocupes que tu email no será publicado

*

Este sitio usa Akismet para reducir el spam. Aprende cómo se procesan los datos de tus comentarios.