Taller 2: Básico Rest
Objetivos
Al finalizar este taller el estudiante estará en capacidad de:
- Probar una aplicación Restful utilizando Postman.
- Explicar la semántica de las anotaciones JAX-RS para implementar servicios Rest
- Modificar la aplicación para cambiar la represnetación del recurso city
- Agregar servicios nuevos ala aplicaicón
Parte 1
- Clone el proyecto que se encuentra en Ejemplo Rest
- Ejecute la aplicación y pruébela con Postman.
Parte 2
Punto 1.
Agregue un atributo al recurso City, por ejemplo pais de tipo String. Modifique el código para las ciudades tengan ese atributo. Verifique con Postman su modificación:
a. Cuando utilice POST en el json que envía adicione el atributo nuevo. Revise que el Json que devuelve lo contenga.
b. Cuando invoque el servicio GET /cities verifique que las ciudades tienen el atributo.
Punto 2.
Desarrolle los siguientes servicios:
| Servicio | Resumen | Parámetros | Retorno | Código HTTP |
|---|---|---|---|---|
GET /cities/:id |
Obtiene los atributos de una instancia de City (READ) que tiene identificado id | @PathParam id: Identificador del recu | Json con la representación del recurso City correspondiente con el id dado | 404 Si no existe una ciudad con ese id |
PUT /cities/:id |
Actualiza una instancia de la entidad City (UPDATE) | @PathParam id: Identificador del recurso | Objeto JSON de City Instancia de City actualizada | 404 Si no existe una ciudad con ese id |
DELETE /cities/:id |
Borra instancia de City en el servidor (DELETE) | @PathParam id: Identificador del recurso | 404 Si no existe una ciudad con ese id |
Reglas de Negocio
Cuando se actualiza la información dela ciudad se debe verificar que el nombre no exista ya en la base de datos. SI ya existe, se debe disparar una BusinessLogicException
Si el recurso no existe se debe disparar una excepción WebApplicationException indicando que la ciudad no existe