Para consumir un servicio web, indicamos la URL del servicio expuesto. Hasta aquí, la url utilizada en los ejemplos anteriores nos ha devuelto un texto o un objeto que hemos prefijado. Sin embargo, si tenemos un conjunto de datos de lado del servidor (una base de datos), uno de los requerimientos podrá ser obtener un objeto de la base de datos a partir de un identificador. Por ejemplo, obtener la información de una persona dado el número de su identificador (es decir, su "id").
Para estos casos, existe la posibilidad de que la URL con la que es expuesto nuestro servicio Web acepte parámetros. Así, si queremos la información de una persona en específico, agregaremos su identificado a la URL. De esa manera, el servicio web buscará la información de la persona dado su identificador. Veamos las anotaciones disponibles para especificar parámetros.
- @PathParam(“nombre”). Se recupera el parámetro de la URI
- Uri: “http://localhost:8080/RS-Server/rest/cliente/1”
-
@GET @Path("/{id}") public String getCliente (@PathParam("id") Integer id) { ... }
- @QueryParam(“...”). Se recupera de la URL. @DefaultParam(“valor”)
- Uri: “http://localhost:8080/RS-Server/rest/cliente/buscar?user=64,jesus”
-
@GET @Path("/query") public String parametros (@DefaultValue(“666,demon") @QueryParam("user") User u) { ... } - @FormParam(“...”). Se extrae del formulario
- public void post(@FormParam("id") int id, @FormParam("name") String name) {...}
- @HeaderParam(“...”). Se extrae de la cabecera
- @CookieParam(“...”). Se extrae de las cookies