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 |
|---|---|
|
|
|
|
|
|
| array (int[], ...) | |
| objeto (class, ...) | |
|
|
Regras de escrita do JSON
- Strings sempre entre aspas duplas: 'text' — erro, o correto é "text".
- Chaves de objetos — strings entre aspas duplas: por exemplo, "name": ...
- Vírgulas só entre elementos, sem vírgula final depois do último item.
- Indentação não é obrigatória, mas melhora a legibilidade.
- Números sem aspas: "age": 25, não "age": "25".
- Booleanos — true/false (sem aspas), não True, FALSE ou "true".
- 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:
- System.Text.Json — padrão, rápido e simples.
- Newtonsoft.Json (Json.NET) — o "veterano" com um monte de recursos.
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.
GO TO FULL VERSION