Red de conocimiento informático - Conocimiento informático - Cómo combinar REST y JSON para crear una API

Cómo combinar REST y JSON para crear una API

Imprimir

Crear interfaces de programación de aplicaciones accesibles desde la web es fácil, pero hacer que esas interfaces funcionen bien sin interrupciones no lo es, dijo Les Hazlewood, director de tecnología de Stormpath, en JavaOne 2013. Hazlewood dijo en JavaOne 2013 La reunión introdujo las mejores prácticas para crear hermosas API REST JSON a través de JAX-RS y Jersey. Hazlewood demuestra las mejores prácticas para crear hermosas API REST JSON con JAX-RS y Jersey.

"A primera vista, una buena API REST parece simple, incluso si el backend es complejo. Las API se centran en un conjunto de cosas y en cómo representar una sola cosa. Reduzca la colección de API, busque en todos los libros y publicación, encontrará una solución simple, intuitiva y sin complicaciones

En este artículo, Hazlewood profundiza en las mejores prácticas de API, los pros y los contras de las API REST y JSON

¿Qué deben explorar los desarrolladores cuando utilizan las API REST?

Les Hazlewood: REST existe como una construcción arquitectónica sobre HTTP, cómo se intercambian datos, cómo se crean, se leen y se actualizan. La semántica de eliminación de datos está integrada en la especificación HTTP y se utiliza para codificar cómo funciona el entorno al crear, leer y eliminar intercambios entre diferentes máquinas.

Esto es lo que hace REST. ¿Este comportamiento en máquinas separadas? Dado que REST se basa en HTTP, es posible que tenga una máquina Linux hablando con una máquina Windows y una máquina Mac debido a que HTTP está en todas partes, por lo que REST está en todas partes. y C#) pueden usar REST

Todos creen que conocen los protocolos HTTP, conocen GIT y POST porque han estado completando formularios web durante años. Entonces, dado que REST solo usa HTTP, los desarrolladores piensan que es simple. , pero ahora hay cada vez más servicios REST que ya no usan XML, sino que incorporan SOAP.

¿Qué tiene de difícil usar REST?

Esto es exactamente. Por qué di esta conferencia. REST es un estilo arquitectónico, pero en el uso de métodos no existe un estándar o especificación formal. Vamos a explicarlo en términos de estilo. Creo que funciona un poco diferente de lo que piensas porque no es un. especificación que puede ser replicada por una máquina. Hay un elemento humano involucrado y JOSN es simple, al igual que http. Pero asegúrese de que el uso de ambos métodos para resolver el problema sea intuitivo y no esté codificado aquí y allá. p>¿Cuáles son las otras razones por las que recomienda usar JSON y REST?

Hazlewood: REST y JSON proporcionan una representación de datos amigable para los humanos; esta ha sido la razón. por qué JSON se adopta ampliamente /p>

JSON es una especificación de sintaxis. Simplemente define cadenas básicas, números, valores nulos y no nulos. Le permite representar cosas complejas con un esquema simple y metadatos mínimos. Es tan simple que se puede utilizar en muchos contextos diferentes. Es fácilmente analizado por máquinas. También es más fácil de leer para la gente.

JavaScript es un lenguaje de programación que ocupa un lugar importante en el mundo.

Incluso si la aplicación principal está construida en Java, Python o C#, hay un alto porcentaje de que, si tienes una página web o una interfaz visual de usuario, habrá algo de JavaScript involucrado. Cualquiera con experiencia en programación en JavaScript puede dominar JSON fácilmente. Si la API devuelve JSON y usted ha escrito JavaScript, su lenguaje de programación ya sabe cómo interactuar con los datos devueltos al servidor. JSON se está volviendo muy popular hoy en día al utilizar JavaScript para intercambiar datos en lugar de simplemente escribir software.

¿Cuándo es correcto utilizar JSON y cuándo es incorrecto?

Hazlewood: Obviamente, XML es más adecuado para la representación de datos estructurados. Los documentos XML contienen más información y los tipos se representan de manera más eficiente en los documentos XML. XML es excelente para el intercambio de datos, pero en términos de facilidad de uso, los desarrolladores dudan en utilizar XML. JSON se puede inspeccionar a simple vista. El diseño de XML es más complejo. JSON es una sintaxis muy simple. En términos de diseño del lenguaje, JSON sólo contiene un pequeño conjunto de elementos centrales de los que surge todo. Debido a que es simple, es fácil de operar y entender. En comparación con XML, JSON no es adecuado para que las máquinas digieran información. Desde este punto de vista, XML lo hace mejor.