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

Ejecutables con Launch4J

Ejecutables con Launch4J

Launch4j es un software OpenSource hecho en Java que permite crear ejecutables para programas escritos en ese mismo leng...

Cambiar la Interfaz Gráfica con skin java

Cambiar la Interfaz Gráfica con skin java

La Interfaz Grafica de Usuario en Java nos brinda la posibilidad de cambiar la apariencia de nuestras aplicaciones, ya s...

Encriptación simétrica en java

Encriptación simétrica en java

En este post veremos un ejemplo sencillo de encriptación/desencriptación simétrica que el API de Java nos permite realiz...

Introducción a SQLite

Introducción a SQLite

Android hace uso de la base de datos SQLite para el manejo de registros en las aplicaciones. Según Santa Wikipedia defin...

Reproductor de video con VLCJ

Reproductor de video con VLCJ

VLC Media Player es un reproductor multimedia de código abierto muy popular desarrollado por el proyecto VideoLAN. VLCJ...

Modificar las pestañas de JTabbedPane

Modificar las pestañas de JTabbedPane

En este tutorial veremos lo fácil que es personalizar las pestañas de un JTabbedPane con unas cuantas lineas de código y...

Comparte lo que sabes

Categorias

Últimas entradas

Blockly proyecto de Google for Education, es una biblioteca en JavaScript que agrega un editor de código visual a aplica...

j2html es una biblioteca para java que permite generar código html seguro desde código java utilizando sus propias etiqu...

En este post haremos uso de PanoramaImageView para agregar a una aplicación android, una vista panorámica de 180° y 360°...

¿Que es una infografia? “Una infografía es una representación visual informativa o diagrama de textos escritos que...

Android Bolivia

MAUS