Cómo funciona JavaScript Object Notation (JSON)
La mayoría de solicitudes y respuestas en IBM® Cloudant® for IBM Cloud® utilizar JSON para formatear el contenido y la estructura de los datos y las respuestas.
En las bases de datos de IBM Cloudant, el objeto JSON se utiliza para representar diversas estructuras, que incluyen todos los documentos de una base de datos.
El análisis de JSON en un objeto JavaScript se admite mediante la función JSON.parse() en JavaScript o mediante diversas bibliotecas que realizan automáticamente
el análisis del contenido en un objeto JavaScript. Las bibliotecas para analizar y generar JSON están disponibles para muchos de los principales lenguajes de programación.
JSON se utiliza porque es la solución más simple y fácil de trabajar con datos que utilizan un navegador web. Como resultado, las estructuras de JSON se pueden evaluar y utilizar como objetos JavaScript dentro del entorno del navegador web. JSON también se integra con el JavaScript del servidor que se utiliza en IBM Cloudant. Los documentos JSON siempre tienen codificación UTF-8.
Es importante seguir estas directrices:
- Las estructuras JSON sean válidas.
- Se normalizan las series en los documentos JSON recuperados de IBM Cloudant.
JSON admite los mismos tipos básicos que JavaScript: números, series, valores booleanos, matrices y objetos.
Números
Los números pueden ser enteros o valores de coma flotante.
Ejemplo de número en formato JSON
123
cadenas
Las series se deben especificar entre comillas dobles. Las series dan soporte a caracteres Unicode y al escape de barra inclinada invertida.
Ejemplo de una serie de caracteres en formato JSON
"A String"
Valores booleanos
Un valor true o false.
Ejemplo de un valor booleano en formato JSON
{
"value": true
}
Matrices
Una lista de valores especificados entre corchetes. Los valores escritos entre corchetes pueden ser cualquier valor JSON válido.
Ejemplo de una matriz en formato JSON
[
"one",
2,
"three",
[],
true,
{
"foo":
"bar"
}
]
Ejemplo de una matriz en formato JSON (lineal)
[ "one", 2, "three", [], true, { "foo": "bar" } ]
Objetos
Un conjunto de pares key-value, como por ejemplo una matriz asociativa o un hash. La clave debe ser una serie de caracteres, pero el valor puede ser cualquiera de los valores JSON admitidos.
Ejemplo de un objeto JSON
{
"servings" : 4,
"subtitle" : "Easy to make in advance, and then cook when ready",
"cooktime" : 60,
"title" : "Chicken Coriander"
}