Como funciona o JavaScript Object Notation (JSON)
A maioria das solicitações e respostas para e de IBM® Cloudant® for IBM Cloud® utilizar JSON para formatação do conteúdo e da estrutura dos dados e respostas.
Em bancos de dados do IBM Cloudant, o objeto JSON é usado para representar várias estruturas, incluindo todos os documentos em um banco de dados.
A análise de JSON em um objeto JavaScript é suportada por meio da função JSON.parse()
em JavaScript ou por meio de várias bibliotecas que executam a análise
do conteúdo em um objeto JavaScript para você. As bibliotecas para a análise e geração de JSON estão disponíveis para muitas linguagens de programação principais.
O JSON é usado porque é a solução mais simples e fácil para trabalhar com dados que usam um navegador da web. Como resultado, as estruturas JSON podem ser avaliadas e usadas como objetos JavaScript dentro do ambiente do navegador da web. O JSON também se integra ao JavaScript do lado do servidor usado no IBM Cloudant. Os documentos JSON são sempre codificados em UTF-8.
Tenha cuidado para seguir estas diretrizes:
- Suas estruturas JSON sejam válidas.
- Você normaliza sequências em documentos JSON recuperados do IBM Cloudant.
O JSON suporta os mesmos tipos básicos que os suportados por JavaScript: números, sequências, booleanos, matrizes e objetos.
Números
Os números podem ser valores de número inteiro ou de vírgula flutuante.
Exemplo de um número no formato JSON
123
Sequências
As sequências devem ser encerradas por aspas duplas. As sequências suportam caracteres Unicode e o escape com uma barra invertida.
Exemplo de uma sequência no formato JSON
"A String"
Booleanos
Um valor true
ou false
.
Exemplo de um booleano no formato JSON
{
"value": true
}
Matrizes
Uma lista de valores entre colchetes. Os valores que são colocados entre aspas podem ser qualquer JSON válido.
Exemplo de uma matriz no formato JSON
[
"one",
2,
"three",
[],
true,
{
"foo":
"bar"
}
]
Exemplo de uma matriz no formato JSON (linear)
[ "one", 2, "three", [], true, { "foo": "bar" } ]
Objetos
Um conjunto de pares key-value
, como uma matriz associativa, ou um hash. A chave deve ser uma sequência, mas o valor pode ser qualquer um dos valores JSON suportados.
Exemplo de um objeto JSON
{
"servings" : 4,
"subtitle" : "Easy to make in advance, and then cook when ready",
"cooktime" : 60,
"title" : "Chicken Coriander"
}