Servicio REST con Java

Clase 13 de 23 • Curso de Java para APIs REST 2016

Clase anteriorSiguiente clase

Fernando Palacios Palacios

student•

Mal ejemplos:

- /adduser

- /delete/user

- /user/delete/morgan

Buenos ejemplos:

- /user/morgan -GET -DELETE (el estado del request, verbos http, nos describen la accion del servicio REST)

- /user -POST (create new user by data from request body)

- /user -PUT (update user with data from request body)

- /user/morgan/courses -GET (obtain especific resource)

- /user/morgan/courses/java -GET

DAVID PAUL PORRAS CORDOVA

student•

Aquí comparto un excelente tutorial sobre Spring, en toda sus implementaciones.
http://www.mkyong.com/tutorials/spring-tutorials/

Cesar David Ramírez Dimaté

student•

Resumen del vídeo:

REST (Representational State Transfer)
Métodos: doGet, doPost, doPut, etc.
SOAP: Es una defición basada en xml.

Interface Uniforme

Recursos Identificados por medio de URIs (Uniform Resource Identifier ‘Identificador de recursos uniforme’). Ejem: /platzi/resources/…
Manipulación de Recursos a través de representaciones (XML, JSON).
Mensajes auto-descriptivos (meta-data content/type).
HATEOAS (Hypermedia As The Engine Of Application State ‘Hipermedia como el motor del estado de aplicación’). Los mismos datos que se envían van a documentar nuestro API REST.

Malos ejemplos de REST
Una mala visión es pensar que REST es el hecho de hacer una llamada HTTP y devolver datos. REST son las 4 reglas anteriores.

/addUser # Nunca usar verbos o acciones en nuestras URIs.
/getUser?user=obernal # No usar parámetros en los recursos que indiquen un usuario, se utilizan más que todo para filtros.
/getCourses?user=obernal&course=java-avanzado
/deleteUser?user=obernal - GET
Se deben utilizar los métodos http. Si se desea traer un usuario (utilizar GET), si se desea crear un usuario (utilizar POST), si se desea actualizar un usuario (utilizar PUT) y no resources de /addUser, /createUser, /deleteUser…

Buenos ejemplos de REST

/user/obernal - GET # Utilizar un URI único.
/user - POST (Adicionar) # Se envía un JSON en el cuerpo (body).
/user/obernal/courses - GET # No se utilizan mucho los parámetros.
/user/obernal/courses/java-avanzado - GET
A través de un URI podemos manejar cualquier operación y no necesariamente se debe indicar al usuario que es. Se puede desactivar un usuario o actualizarlo.

Códigos de Status HTTP
Retornar una respuesta después de una petición.

1XX: Informacional
2XX: Suceso # Ejemplo, 201, fue creado un recurso. Manera exitosa.
3XX: Redirección # Ese recurso ya no existe y se redirecciona a otro.
4XX: Error Cliente # Como el 404, puede ser que el cliente haya hecho algo mal.
5XX: Error Servidor # No debería aparecer, el desarrollador cometío un error.

API de GitHub: https://developer.github.com/v3/ (Se adhiere mucho a los estándares REST).

Hacer la llamada al API de GitHub. Utilizar un RESTClient del navegador. Por ejemplo RESTED de Chrome.

Método: GET
URL: https://api.github.com/repos/spring-projects/spring-framework

Julian Gomez

student•

Muy buena clase, breve y precisa, aprendia¿ de nuevo los estandares de los nombres y caracteristicas que deben tener un REST Service. Gracias por las preguntas y respuestas

Cesar David Ramírez Dimaté

student•

Pienso lo mismo.

Don Jesús

student•

Muy buena clase teórica que explica los conceptos básicos de REST. Esperemos que más adelante hagamos un ejemplo para que quede todo mucho más claro.

Alexander Agrazal

student•

Entiendo REST de manera más clara http://spring.io/understanding/REST

jeanpier castro casanova

student•

pense que iba a crear el servicio , consumirlo , hacer crud , 😕
no enseño nada 😭

Jair Israel Avilés Eusebio

student•

Fue solamente la explicación teórica en las clases posteriores muestra la forma de crear un servicio REST con Spring Boot 😃

Cesar David Ramírez Dimaté

student•

Excelente explicación teórica. Este vídeo muestra la importancia de saber primero que es lo que vamos a hacer antes de darle mano al código fuente. Todo el tiempo en mi trabajo viendo por ejemplo los status de http y no sabía las diferencias. Con eso uno puede manejar más fácil las excepciones por ejemplo.