CodeGym /Cursos /C# SELF /Fundamentos do formato JSON e sua popularidade

Fundamentos do formato JSON e sua popularidade

C# SELF
Nível 43, Lição 4
Disponível

1. Introdução

Se você alguma vez abriu APIs modernas, trabalhou com web services, apps móveis ou até tentou salvar algo num "formato universal" — você já esbarrou ou vai esbarrar com JSON. É o formato que literalmente "conecta" diferentes linguagens e plataformas: C#, JavaScript, Python — todo mundo fala via JSON.

Por que exatamente o JSON virou a estrela da serialização? A resposta é simples: é um formato compacto, legível por humanos e leve para trocar dados estruturados. A popularidade vem da combinação de simplicidade, versatilidade e ótima suporte nas linguagens.

O que é JSON?

JSON vem de JavaScript Object Notation. O formato nasceu no mundo do JavaScript, mas rapidamente saiu do navegador para o mundo todo. Importante: apesar do nome, JSON não está preso ao JavaScript e é igualmente útil em qualquer linguagem.

O formato foi inventado no começo dos anos 2000 por Douglas Crockford como uma alternativa mais simples ao verboso XML. A ideia é direta: "JSON é mais curto, simples e mais fácil de ler".

2. Regras principais do formato JSON

O principal: JSON é um formato de dados textual estritamente definido. Sem mágica, apenas texto normal que você pode abrir em qualquer editor.

Construções básicas:

  • Arrays (arrays): listas ordenadas de valores.
  • Objetos (objects): conjuntos de pares chave-valor.
  • Tipos simples: strings, números, booleanos (true, false) e o valor especial null.

Exemplo de documento JSON mínimo:

{
    "name": "Ivan",
    "age": 25,
    "isStudent": true,
    "scores": [5, 4, 5, 3],
    "contacts": {
        "email": "ivan@example.com",
        "phone": null
    }
}

Estrutura esquemática

Aqui vai uma tabela de correspondência entre tipos C# e representação em JSON:

Tipo C# Exemplo JSON
string
"name": "Ivan"
int, double
"score": 5
bool
"isStudent": true
array (int[], ...)
"scores": [5,4,5,3]
objeto (class, ...)
"contacts": { ... }
null
"phone": null

Regras de escrita do JSON

  1. Strings sempre entre aspas duplas: 'text' — erro, o correto é "text".
  2. Chaves de objetos — strings entre aspas duplas: por exemplo, "name": ...
  3. Vírgulas só entre elementos, sem vírgula final depois do último item.
  4. Indentação não é obrigatória, mas melhora a legibilidade.
  5. Números sem aspas: "age": 25, não "age": "25".
  6. Booleanos — true/false (sem aspas), não True, FALSE ou "true".
  7. null é escrito como null (sem aspas).

3. JSON visto por um programador

Analogias com tipos C#:

  • JSON-object ≈ Dictionary<string, object>
  • JSON-array ≈ T[] ou List<T>
  • JSON-string ≈ string normal
  • JSON-number ≈ int ou double (dependendo do valor)

Exemplo de serialização de um objeto para JSON

Classe:

public class Student
{
    public string Name { get; set; } = "";
    public int Age { get; set; }
    public bool IsStudent { get; set; }
    public int[] Scores { get; set; } = Array.Empty<int>();
}

JSON resultante (vamos simplificar, os detalhes da serialização vêm depois):

{
    "Name": "Ivan",
    "Age": 25,
    "IsStudent": true,
    "Scores": [5, 4, 5, 3]
}

4. Exemplos de estruturas JSON válidas

Objeto com array e objetos aninhados

{
  "product": "Cafe",
  "price": 125.50,
  "inStock": true,
  "attributes": {
    "weight": 500,
    "unit": "gr"
  },
  "tags": ["bebida", "energia", "arabica"],
  "promotions": null
}

Array de objetos

[
  {"id": 1, "name": "Petya"},
  {"id": 2, "name": "Masha"},
  {"id": 3, "name": "Vasya"}
]

5. Exemplos de JSON inválido (e por quê)

Aspas simples:

{ 'name': 'Ivan' } // Erro!

JSON exige aspas duplas.

Vírgula depois do último elemento:

{ "x": 1, "y": 2, } // Erro!

Vírgula extra no final não é permitida.

Comentários:

{
  // Essa beleza infelizmente não funciona em JSON
  "name": "Ivan"
}

JSON não tem comentários.

6. Por que JSON é útil em projetos reais?

Troca de dados entre sistemas

JSON é a "língua comum" entre programas diferentes, normalmente sobre HTTP. Por exemplo, um servidor em C# conversa com um frontend em JavaScript — o formato comum é JSON.

Armazenamento de configurações e dados

Muitos apps guardam configurações em arquivos .json. Por exemplo, appsettings.json é padrão em aplicações .NET. Vantagens: fácil de ler, alterar e versionar.

APIs servidoras e móveis

A maioria das REST APIs usa JSON como formato de request/response: por exemplo, a lista de usuários vem como um array de objetos.

Configuração de ferramentas e bibliotecas

Muitas ferramentas no ecossistema .NET (Serilog, Swagger etc.) usam JSON para configurações. XML aparece cada vez menos — JSON é mais compacto e claro.

7. Popularidade do JSON: por que todo mundo gosta?

  • Legibilidade. Até quem não é programador consegue entender a estrutura.
  • Facilidade de transferência pela rede. Texto simples, pouco "peso".
  • Suporte em todas as linguagens. Serialização/deserialização geralmente já vem "out of the box".
  • Ótimo para configurações. Qualquer editor lida bem com ele.
  • Facilidade de geração. Montar JSON é trivial.
  • Arrays, aninhamento, null. Tudo intuitivo, sem a "febre de parênteses" do XML.

Quando escolher JSON?

  • Você está criando um app móvel ou web;
  • Trabalha com APIs de serviços externos;
  • Quer que sua aplicação seja fácil de integrar no futuro.

8. Como o C# trabalha com JSON

Resumo das bibliotecas .NET populares:

Exemplo mínimo de serialização/deserialização:

using System.Text.Json;

// Convertendo um objeto em uma string JSON
var student = new Student { Name = "Ivan", Age = 25, IsStudent = true, Scores = new[] {5, 4, 5, 3} };
string json = JsonSerializer.Serialize(student);

// E o contrário: ler um objeto a partir da string JSON
Student? parsed = JsonSerializer.Deserialize<Student>(json);

Console.WriteLine(json);

9. Erros comuns de iniciantes ao trabalhar com JSON

Erro comum — confundir aspas ou esquecer vírgula. Às vezes tentam adicionar comentários (como em C# — o que é prático!), mas JSON não permite.

Outro caso frequente — serializar objetos com coleções não inicializadas: resultado é "scores": null em vez do array esperado. Inicialize coleções antes de serializar.

Lembre que JSON é texto: volumes grandes ocupam muita memória. Se você serializar, digamos, 500 MB em JSON, a aplicação pode sofrer queda de desempenho.

2
Tarefa
C# SELF, nível 43, lição 4
Bloqueado
Leitura de dados de um arquivo binário
Leitura de dados de um arquivo binário
1
Pesquisa/teste
Introdução à serialização, nível 43, lição 4
Indisponível
Introdução à serialização
Conceito de serialização de dados
Comentários
TO VIEW ALL COMMENTS OR TO MAKE A COMMENT,
GO TO FULL VERSION