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" 

Nome="João"

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

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" }

Objetos JSON podem ser armazenadas e gerenciados em  4D por variáveis objeto (C_OBJECT) e campos.

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.