Sigueme en Facebook Sigueme en Twitter Sigueme en Instagram Sigueme en Youtube
JC Mouse Bolivia
Index / Java / Microservicio REST Java con Spark – Parte 2

Microservicio REST Java con Spark – Parte 2

Autor jc mouse jueves, agosto 2, 2018

Segunda y ultima parte del post dedicado a la creación de un microservicio en lenguaje java utilizando el framework Spark [MicroServicio REST – parte 1]. Si eres un nuevo visitante y aún no lo leíste, te recomiendo hacerlo para poder completar con éxito este post.

Para completar nuestro microservicio, nos resta implementar los métodos:

  • POST: Encargado de crear un nuevo recurso en el servidor
  • PUT: Utilizado para actualizar un recurso
  • DELETE: Borra un recursos en especifico

Ante de continuar con el desarrollo de nuestro microservicio, debemos indicar que tanto para crear y actualizar recursos, podemos enviar los datos en formato JSON o utilizando parámetros de un formulario, en este ejemplo, utilizaremos las dos formas de manera indistinta dejando en las manos del programador final la decisión de cual utilizar.

Paso 6.4 POST

El método POST hará uso de objetos JSON para recabar la información del cliente, es decir:

{
  "dni": "767",
  "nombre": "Armando Bronca",
  "edad": 99
}

El cual equivale a nuestra clase “Persona.java“.

El código para el método POST es el siguiente:

 1 /**
 2  * Agrega un nuevo registro Los datos de entrada corresponden a un
 3  * objeto JSON
 4 */
 5 post("/personas", (request, response)
 6    -> {
 7          if (request.body() != null) {//existe contenido                
 8             try {
 9                 //Obtiene objeto JSON de tipo persona
10                 Persona persona = gson.fromJson(request.body(), Persona.class);
11                 servicio.agregar(persona);
12                 response.status(201);//Codigo de respuesta                
13                 return new Respuesta("Nuevo Usuario agregado con DNI " + persona.getDni());
14              } catch (JsonParseException ex) {
15                 response.status(400);//Bad Request
16                 return new Respuesta("El objeto JSON no es valido");
17              }
18           } else {
19              response.status(400);//Bad Request
20              return new Respuesta("El objeto JSON es obligatorio");
21          }
22       },  gson::toJson );

Ahora en imsomnia creamos una nueva solicitud “Agregar persona” con el método POST y como body de tipo de texto JSON, es decir:

request post

Completamos los datos:

1. Ingresamos la dirección de la solicitud “http://localhost:4567/personas

2. Escribimos el objeto JSON persona

3. Presionamos el boton SEND (enviar)

4. Obtenemos una respuesta 201 Created junto con un mensaje.

recurso creado

Si ingresamos el objeto JSON de manera incorrecta, incompleta o con una estructura diferente a la requerida podemos obtener inconsistencias en los datos e incluso errores críticos al guardar el recurso, se debe tener en cuenta esos detalles a la hora de hacer uso de objeto JSON. En este ejemplo solo controlamos que el objeto JSON sea valido, es decir, si e objeto que enviamos no corresponde a un objeto JSON valido, el recurso no se creara y nos devolverá un código 400 Bad Request como respuesta.

Mala solicitud 400

Paso 6.5 PUT

Con el método PUT en lugar de utilizar objetos JSON, enviaremos los datos uno a uno como en un formulario, para obtener los datos desde el servidor, utilizaremos la instrucción request.queryParams(“nombre_del_parametro”). El código es el siguiente:

 1 /**
 2  * Actualiza un recurso
 3  */
 4  put("/personas/:id", (request, response)
 5     -> {
 6       //Busca registro segun el ID dado
 7       Persona persona = servicio.buscar(request.params(":id"));
 8       if (persona != null) {//existe registro
 9          //obtiene los datos a actualizar
10          persona.setNombre(request.queryParams("nombre"));
11          persona.setEdad(Integer.valueOf(request.queryParams("edad")));
12          //actualiza
13          servicio.actualizar(persona);
14          //responde
15          response.status(200);//Codigo de respuesta                
16          return new Respuesta("Registro actualizado");
17        }
18        response.status(404); // 404 Not found
19        return new Respuesta("Usuario no existe. Nada que actualizar.");
20    }, gson::toJson);

En nuestro cliente REST, creamos una nueva solicitud de tipo PUT con una estructura de tipo formulario FORM, es decir:

PUT example

1 Ingresamos la dirección del recurso que queremos actualizar, este sera el registro 999 que agregamos con el método POST, “http://localhost:4567/personas/999

2 Podrás observar en este caso que ahora no se muestra el área para agregar JSON sino mas bien aparece un formulario donde podremos agregar cada parámetro que necesitemos, es decir “nombre” y “edad

3 finalmente presionamos el botón SEND

4 Obtenemos como resultado un código de respuesta 200 así como un mensaje JSON notificando el éxito de la operación.

PUT formato

Utiliza el método de búsqueda para comprobar que los datos se actualizaron correctamente.

buscar persona

Paso 6.6 DELETE

Para terminar el post nos falta implementar el método DELETE para eliminación de recursos, el código es el siguiente:

 1 /**
 2  * Elimina un registro dado su ID
 3  */
 4  delete("/personas/:id", (request, response)
 5         -> {
 6            response.status(200);//Codigo de respuesta                        
 7            Persona persona = servicio.buscar(request.params(":id"));
 8            if (persona != null) {//existe
 9                servicio.eliminar(request.params(":id"));
10                return new Respuesta("Usuario eliminado");
11            } else {//no existe
12                response.status(400);//Codigo de respuesta  
13                return new Respuesta("No existe usuario");
14            }
15     }, gson::toJson);

Para probar este método como en los anteriores casos, crea una nueva solicitud pero ahora de tipo DELETE. Este tipo de método no requiere de un Body por lo que solo deberás:

1 Escribir la dirección del recurso “http://localhost:4567/personas/123

2 Presionar SEND

3 Si el recurso existe, obtenemos un código 2o0 así como un mensaje de respuesta.

eliminacion de recursos rest

Descarga los archivos utilizados en este tutorial desde este <<enlace económico>>

enjoy!!!

Tags

Si te ha gustado podrías compartirlo o dejar un comentario. ¡Muchas gracias!
Autor: JC Mouse

Yo soy yo :) JC Mouse, Soy orgullosamente boliviano soy fundador y CEO de la web jc-Mouse.net uno de las pocas web en emprendimiento y tecnología en Bolivia.

Toda la información que encuentres en este sitio es y sera completamente gratis siempre, puedes copiar, descargar y re-publicar si así lo deseas en otros blogs o sitios web, solo te pido a cambio que dejes una referencia a esta web. Esto nos ayuda a crecer y seguir aportando. Bye

Enjoy! :)

También Te Podría Interesar

jFace – Crea retratos hablados

jFace – Crea retratos hablados

La policia, el FBI u otros organismos similares utilizaban a dibujantes para realizar el “retrato hablado” d...

Mapas interactivos con HTML5 – Parte 1

Mapas interactivos con HTML5 – Parte 1

La tecnología de HTML5 y javascript  nos permite crear gráficos interactivos livianos sin tener que recurrir a flash, el...

Tangram: El rompecabezas chino

Tangram: El rompecabezas chino

El Tangram es un juego chino muy antiguo, esta compuesto por 7 piezas: un paralelogramo (romboide), un cuadrado y 5 triá...

Conexión RESTFUL con android y JSON

Conexión RESTFUL con android y JSON

En este tutorial crearemos una sencilla aplicación android que nos permitirá conectarnos a un RESTFUL, obtener un result...

Interfaces Funcionales

Interfaces Funcionales

Una Interface Funcional es una interface que contiene uno y solo un método abstracto aunque puede contener métodos por d...

Hola mundo en Netbeans

Hola mundo en Netbeans

De los diferentes IDE’s que existen para crear aplicaciones para android, lamentablemente Netbeans es una de las m...

Comparte lo que sabes

Categorias

Últimas entradas

Los números narcisistas o números de Armstrong son aquellos números enteros positivos  cuya suma de las n-ésimas potenci...

En la convención de Chain React  en Portland (Oregon), Marc Horowitz ingeniero de software en Facebook presentó el motor...

En un post anterior [Introducción a VueJS framework para el desarrollo FrontEnd] realizamos una breve introducción a Vue...

La programación y la electrónica están a la orden del día. Cada vez son más importantes y prácticamente forman parte de...

Android Bolivia

MAUS