🚀 Capítulo 05: JSON: O Idioma das APIs (Tema: Minecraft)
NOTE
Este capítulo utiliza a temática de Minecraft para explicar o JSON. Cada bloco e item no jogo tem propriedades que podem ser guardadas de forma estruturada!
1. 🎯 Objetivo da Aula
Compreender o formato JSON (JavaScript Object Notation), sua estrutura de chave-valor e como ele é usado para transportar dados entre Cliente e Servidor.
2. 🏢 O Cenário Prático (Seu Desafio)
No Minecraft, cada bloco de minério tem propriedades: o tipo do minério, a dureza, se precisa de picareta de ferro ou não. Para enviar esses dados do jogo para um site que mostra o inventário do jogador, precisamos empacotar essas informações em um formato que o site entenda. Vamos usar o JSON, empilhando blocos de dados!
3. 🧠 Fundamentos: A Teoria Traduzida
JSON significa JavaScript Object Notation. É um formato leve de troca de dados, fácil de ler e escrever para humanos e fácil de interpretar para máquinas.
🧱 Regras dos Blocos JSON:
- Chave-Valor: Os dados são guardados em pares de
"chave": valor. - Chaves sempre entre aspas duplas (
"nome"). - Tipos de Dados permitidos:
- Texto (String): Entre aspas duplas (
"Diamante"). - Número: Sem aspas (
42,10.5). - Booleano:
trueoufalse. - Array (Lista): Entre colchetes
[]. - Objeto: Outro bloco JSON entre chaves
{}.
- Texto (String): Entre aspas duplas (
⛏️ Exemplo de um Bloco de Minecraft em JSON:
{
"nome": "Minério de Diamante",
"dureza": 3.0,
"precisa_ferro": true,
"drops": ["Diamante", "XP"]
}4. 📖 Exemplo Guiado: Validando o JSON
Um JSON sempre começa e termina com chaves {} (se for um objeto) ou colchetes [] (se for uma lista).
- Correto:
{"id": 1} - Errado:
{id: 1}(Falta aspas na chave). - Errado:
{"nome": 'Steve'}(Usou aspas simples no valor texto).
5. 🛠️ Prática Obrigatória 1: Criando seu Item
Crie um objeto JSON que represente uma Picareta do Minecraft. O JSON deve ter:
- Um texto para o
"material". - Um número para a
"durabilidade". - Um booleano para
"esta_encantada". - Uma lista de textos para os
"encantamentos".
6. 🛠️ Prática Obrigatória 2: Corrigindo o JSON
O JSON abaixo está com erros de sintaxe. Reescreva-o de forma correta:
{
nome: Steve,
"vida": 20,
'inventario': ['Espada', 'Tocha']
}7. 📤 Instruções de Entrega (GitHub Desktop + Microsoft Teams)
- Faça o Commit: No GitHub Desktop, digite a mensagem (ex:
Finaliza Capítulo 05 Backend) e clique em Commit to main. - Envie para a Nuvem (Push): Clique em Push origin.
8. 📂 Estrutura de Pastas
mod_07_backend_e_apis/
├── capitulos/
│ ├── capitulo_05_json.md
│ └── codigos/
│ └── cap05/
│ └── item_minecraft.json9. 💡 Checkpoint de Lógica
Por que o JSON se tornou mais popular que o XML para APIs web? (Dica: JSON parece muito com objetos JavaScript, que rodam no navegador!).
10. 🔥 Desafio de Fixação
Crie um JSON que represente uma lista de 3 jogadores do Minecraft, onde cada jogador é um objeto com nome e nível.
11. 🔑 Gabarito de Código/Fórmulas
Gabarito da Prática 2 (Corrigido):
{
"nome": "Steve",
"vida": 20,
"inventario": ["Espada", "Tocha"]
}