4D v14.3

Apresentação de comandos JSON

Página Inicial

 
4D v14.3
Apresentação de comandos JSON

Apresentação de comandos JSON  


 

 

Os comandos JSON permitem gerar e analisar os objetos de linguagem de formato JSON. Mais particularmente, o formato JSON faz que seja possível o acesso as bases 4D (dados e estrutura) utilizando um navegador web.

O suporte de objetos estruturados é uma das grandes novidades da linguagem de 4D v14, destinado a facilitar o intercâmbio de dados estruturados. Graças aos comandos do tema "JSON", 4D pode trabalhar diretamente com objetos JSON. Entretanto, 4D também pode trabalhar com objetos "nativos" (cuja estrutura se inspira em JSON), o que permite o intercâmbio com todos os tipos de linguagem. Para mais informação, consulte o capítulo Objetos (Linguagem).

"JSON ou JavaScript Object Notation é um formato de dados baseado em texto, genérico, derivado da notação dos objetos da linguagem ECMAScript." (fonte: Wikipedia). JSON é independente de qualquer outra linguagem, porém utiliza as convenções que são familiares para os programadores que utilizam C++ ou JavaScript, Perl, etc. É um formato que é particularmente adequado para o intercâmbio de dados.

Esta seção resume os princípios de notação implementados em JSON. Para uma descrição completa deste formato, consulte o seguinte site: www.json.org/index.html.

A sintaxe JSON está baseada nos seguintes princípios:

  • Os dados consistem em pares de nome/valor,
  • Os dados estão separados por vírgulas,
  • Os objetos estão definidos por colchetes {},
  • Os arrays estão definidos por colchetes [ ].

Os dados JSON se expressam em forma de pares nome/valor (ou chave/valor). Um par nome/valor contém um nome de campo (entre aspas), logo dois pontos, seguido de um valor. Por exemplo:

"Nome":"João" 

Para sua informação, este exemplo equivale em JavaScript:
Nome="João"

Leve em conta que os nomes de propriedades são diacríticos e tomam em consideração as maiúsculas e minúsculas. Se escrever "Nome" ao invés de "nome", obtém um novo par nome/valor.

Os seguintes tipos de valores são suportados em JSON:

TipoDescriçãoComentários
cadeiaTodo caractere Unicode exceto " e \
Os valores, como os nomes de propriedades, estão entre aspas ("), por exemplo, "city":"Paris"
\ se utiliza para os caracteres de controle:
\" = aspas
\\ = barra oblíqua inversa
\/ =  barra
\b = tecla de retrocesso
\f = formfeed
\n = retorno de linha
\r = retorno de carro
\t = tabulação
\u = quatro cifras hexadecimais
númeroInteiro ou número de ponto flutuanteNúmero similar a C ou a Java, exceto que os formatos octal e hexadecimal não se utilizam
objeto{ }
array[ ]
booleanotrue ou false
nulonull

Os objetos JSON se definem com colchetes e podem conter um número indefinido de pares nome/valor, por exemplo:

{ "nome":"João" , "Sobrenome":"Silva" }

Os arrays JSON se definem com colchetes. Cada array pode conter um número indefinido de objetos:

{
    "employees": [
        { "nome":"João" , "sobrenome":"Silva" },
        { "nome":"Ana" , "sobrenome":"Alves" },
        { "nome":"Pedro" , "sobrenome":"Machado" }
    ]
}

Por padrão, quando se convertem dados 4D desde JSON, é levada em conta a zona horária da máquina na que a conversão é levada a cabo (de conformidade com JavaScript). Por exemplo, em França (GMT+2), a conversão de 23/08/2013! da "2013-08-22T22:00:00Z" e vice versa.

Pode mudar este funcionamento e não ter em conta a zona horária, durante a implementação dos procedimentos de exportação, por exemplo, utilizando o comando SET DATABASE PARAMETER.

Para mais informação sobre como converter datas 4D/JSON, consulte Conversão de datas JavaScript.

 
PROPRIEDADES 

Produto: 4D
Tema: JSON

 
VER TAMBÉM 

Objetos (Linguagem)

 
ARTICLE USAGE

Manual de linguagem 4D ( 4D v14 R2)
Manual de linguagem 4D ( 4D v14 R3)
Manual de linguagem 4D ( 4D v14.3)
Manual de linguagem 4D ( 4D v14 R4)