DEV Community: Henrique Leme de Brito

[Boost]

Henrique Leme de Brito — Tue, 14 Oct 2025 01:49:49 +0000

Daniel Reis

Oct 14 '25

Data Engineering 101 - A real beginner's approach

#datascience #database #bruin #programming

145

Comments 5

15 min read

O que é JSON (Javasript Object Notation) e como usamos ?

Henrique Leme de Brito — Fri, 21 Jun 2024 18:33:39 +0000

É bastante comum pra galera que ta começando na programação ficar um pouco perdido com muitos acronismos nas primeiras semanas. Hoje, vamos dar uma passada sobre algo que é muito comum no dia a dia da nossa profissão e que é bem fácil de pegar as manhas, pode confiar!! Neste artigo, vamos explicar o que significa a sigla JSON, como pode ser usado, como é a estrutura dele e muito mais! Bora lá?

Índice

O que é JSON afinal?
Já não existia uma forma de transportar dados assim antes?
Qual é a diferença entre JSON e XML?
Ainda vale a pena usar XML?
Vantagens do JSON
- Sintaxe JSON
- Tipos de Dados JSON
Exemplo prático com Carros
- Trabalhando com JSON em JavaScript
- Trabalhando com JSON em Python
- Trabalhando com JSON em PHP
- Trabalhando com JSON em Java

O que é JSON afinal?

O JSON ou "JavaScript Object Notation" é um formato básico para transportar dados, criado em 2000. Mas ao ler o nome, você pode se perguntar:

"Se tem JavaScript no nome, então só posso usá-lo com JavaScript, certo?" - Você, 2024

Não exatamente, pelo fato, de ser um formato leve e simples, ele é fácil de ser lido por outras linguagens e, o mais importante, por pessoas.

"Bem, se é uma maneira leve e simples de transportar dados, então vou usá-lo como um banco de dados." - Você, 2024

Eu não recomendaria...

Por quê? Bom, embora o JSON seja ótimo para transportar dados por causa de sua simplicidade e legibilidade, usá-lo como banco de dados pode não ser a melhor ideia. Arquivos JSON não são projetados para lidar com grandes quantidades de dados de forma eficiente. Eles não possuem recursos de indexação, consulta e transações como bancos de dados SQL (como MySQL e PostgreSQL) ou bancos de dados NoSQL (como MongoDB e ScyllaDB). Usar JSON como banco de dados pode levar a problemas de desempenho, integridade de dados e desafios na gestão de acesso concorrente aos dados.

Não existia uma forma de transportar dados assim antes?

Claro que sim. A principal linguagem usada era o XML (Extensible Markup Language), projetada para ser uma linguagem de marcação flexível e personalizável. Embora seja poderosa e altamente extensível, pode ser bastante verbosa, dificultando sua legibilidade. Cada pedaço de dado no XML é cercado por tags, o que pode aumentar o tamanho do arquivo e a complexidade, especialmente em documentos maiores ou conjuntos de dados.

Qual é a diferença entre JSON e XML?

JSON e XML são ambos formatos de serialização de dados. JSON é mais conciso, o que o torna mais fácil de ler e mais rápido de analisar, sendo bem adaptado às estruturas de dados das linguagens de programação modernas. O XML, por outro lado, é mais verboso com o uso de tags explícitas de início e fim, suportando uma estrutura hierárquica mais complexa adequada para aplicações que exigem metadados detalhados. Enquanto o JSON é preferido para APIs Web devido à sua eficiência, o XML é preferido em ambientes que requerem marcação extensiva de documentos, como aplicações empresariais.

Da uma olhadinha nesse exemplo em XML para comparação:

<livraria>
  <livro>
    <titulo>Aprendendo XML</titulo>
    <autor>Erik T. Ray</autor>
    <preco>29.99</preco>
  </livro>
  <livro>
    <titulo>JSON para Iniciantes</titulo>
    <autor>iCode Academy</autor>
    <preco>39.95</preco>
  </livro>
</livraria>

E agora temos esse mesmo exemplo, mas agora no formato JSON:

{
  "livraria": {
    "livros": [
      {
        "titulo": "Aprendendo XML",
        "autor": "Erik T. Ray",
        "preco": 29.99
      },
      {
        "titulo": "JSON para Iniciantes",
        "autor": "iCode Academy",
        "preco": 39.95
      }
    ]
  }
}

Ainda vale a pena usar o XML?

Bom, vai depender do seu objetivo, mas na minha opinião, sempre vale a pena dar uma olhada em alguma coisa que você não conhece, mesmo que você não pretenda usar, só para ter uma ideia do que é e como é usado. Você pode se deparar com um problema que o XML pode resolver um dia, vai saber.

Vantagens do JSON

Então, como você já viu, a principal razão para usar JSON é sua legibilidade, mas vamos listar suas principais vantagens:

Fácil de Ler: JSON tem uma estrutura clara e direta.
Fácil de Parsear: Sua sintaxe simples facilita a na hora de converter.
Compacto: JSON tende a ser mais leve, economizando espaço e largura de banda.
Universal: Amplamente suportado por várias linguagens de programação e plataformas, usado por grandes empresas como Google e Twitter.

Sintaxe JSON

A sintaxe JSON é direta e sem muito segredo, seguindo algumas regras básicas:

Dados em pares de nome/valor: Cada elemento de dado em JSON é representado como um par de chave (ou nome) e valor, separados por dois pontos.
Dados separados por vírgulas: Múltiplos pares de chave-valor dentro de um objeto são separados por vírgulas.
Objetos são envoltos por chaves: Um objeto em JSON é cercado por chaves {}.
Arrays são envoltos por colchetes: Um array em JSON é cercado por colchetes [].

Mas é mais fácil visualizar do que ler, então aqui estão alguns exemplos para você, junto com a definição de cada tipo:

Tipos de Dados JSON

JSON suporta os seguintes tipos de dados:

String: Uma sequência de caracteres, cercada por aspas duplas. "nome": "João Silva"
Número: Valores numéricos, podem ser inteiros ou de ponto flutuante. "idade": 30
Objeto: Uma coleção de pares chave-valor, cercados por chaves. "endereço": { "rua": "Rua Principal", "cidade": "Cidade Exemplo" }
Array: Uma lista ordenada de valores, cercada por colchetes. "cursos": ["Matemática", "Ciências", "História"]
Boolean: Valores verdadeiro ou falso. "éEstudante": false
Null: Representa um valor nulo. "nomeDoMeio": null

E não, você não pode escrever comentarios em arquivo um JSON :D

Exemplo prático com Carros

Vamos dizer que você quer manter registros de carros e seus detalhes. Aqui está um exemplo de como esses registros podem ser organizados em JSON:

{
  "carros": [
    {
      "marca": "Toyota",
      "modelo": "Corolla",
      "ano": 2020,
      "características": {
        "cor": "Azul",
        "transmissão": "Automática"
      }
    },
    {
      "marca": "Toyota",
      "modelo": "Corolla",
      "ano": 2021,
      "características": {
        "cor": "Vermelha",
        "transmissão": "Automática"
      }
    }
  ]
}

Se você quiser adicionar mais carros, basta adicionar mais objetos ao array de carros na estrutura JSON.

E isso pode ser facilmente feito analisando o JSON em uma linguagem de sua escolha e, em seguida, manipulando-o como desejar. Aqui estão alguns exemplos usando o JSON mostrado anteriormente para dar uma ideia melhor de como ler e analisar um arquivo JSON:

Trabalhando com JSON em JavaScript

const fs = require('fs').promises

const jsonPath = 'C:docs/example/example.json'
const readJsonFile = async () => {
  // Lê o conteúdo do JSON e garante que seja lido como uma string
  const jsonContent = await fs.readFile(jsonPath, 'utf-8')
  // Converte o JSON em um objeto JavaScript
  const data = JSON.parse(jsonContent)

  console.log(data.carros[0])
  // Saída: { marca: "Toyota", modelo: "Corolla", ano: 2020, características: { cor: "Azul", transmissão: "Automática" } }

  console.log(data.carros[1])
  // Saída: { marca: "Toyota", modelo: "Corolla", ano: 2021, características: { cor: "Vermelha", transmissão: "Automática" } }
}

readJsonFile()

Trabalhando com JSON em Python

import json  

# Lê o arquivo JSON
with open('C:docs/example/example.json', 'r') as jsonFile:  
    # Analisa o conteúdo do JSON
    jsonContent = json.load(jsonFile)  

print(jsonContent['carros'][0])  
# Saída: {'marca': 'Toyota', 'modelo': 'Corolla', 'ano': 2020, 'características': {'cor': 'Azul', 'transmissão': 'Automática'}}  
print(jsonContent['carros'][1])  
# Saída: {'marca': 'Toyota', 'modelo': 'Corolla', 'ano': 2021, 'características': {'cor': 'Vermelha', 'transmissão': 'Automática'}}

Trabalhando com JSON em PHP

<?php  
$jsonPath = 'C:docs/example/example.json';  
// Lê o conteúdo do JSON
$contents = file_get_contents($jsonPath);  

// Converte o conteúdo do JSON em um Objeto PHP
$jsonContent = json_decode($contents);  

print_r($jsonContent->carros[1]);  
// Saída: stdClass Object  
// (  
//    [marca] => Toyota  
//    [modelo] => Corolla  
//    [ano] => 2021  
//    [características] => stdClass Object  
//        (  
//            [cor] => Vermelha  
//            [transmissão] => Automática  
//        )  
// )
?>

Trabalhando com JSON em Java

package org.example;  
import org.json.JSONArray;  
import org.json.JSONObject;  

import java.io.IOException;  
import java.nio.charset.StandardCharsets;  
import java.nio.file.Files;  
import java.nio.file.Paths;  

public class Main {  
    public static void main(String[] args) throws IOException {  
        String jsonFilePath = "C:docs/example/example.json";  
        // Lê o conteúdo do arquivo e converte em uma string
        String jsonContent = Files.readString(Paths.get(jsonFilePath), StandardCharsets.UTF_8);  

        // Converte o conteúdo da string em um Objeto JSON
        JSONObject jsonExample = new JSONObject(jsonContent);  

        JSONArray carros = jsonExample.getJSONArray("carros");  

        System.out.println(carros.get(0));  
        // Saída: {"características": {"transmissão":"Automática","cor":"Azul"},"ano":2020,"modelo":"Corolla","marca":"Toyota"}  
        System.out.println(carros.get(1));  
        // Saída: {"características":{"transmissão":"Automática","cor":"Vermelha"},"ano":2021,"modelo":"Corolla","marca":"Toyota"}  
    }  
}

PS: O exemplo em Java usa uma biblioteca json. Se você for testá-lo, certifique-se de incluí-la nas suas dependências.

Conclusão

Entender JSON pode parecer complicado no começo, mas na verdade é muito simples quando você pega o jeito! Demos uma passada sobre o que é JSON, como é usado e por que é tão útil.

Desde entender sua sintaxe até vê-lo em ação em diferentes linguagens de programação, agora você está pronto para dar os primeiros passos e começar a usar JSON em seus projetos.

Se você ainda tiver alguma dúvida, sinta-se à vontade para me perguntar diretamente. Espero que tenha gostado do artigo - não se esqueça de curtir e compartilhar com aquele amigo que ainda está lutando para entender JSON.

Feedback sobre o artigo são sempre bem-vindos para que eu possa melhorar nos próximos. Obrigado por ler, mantenha-se saudável e beba água!

What is JSON ( Javascript Object Notation ) and how to use it

Henrique Leme de Brito — Fri, 14 Jun 2024 16:26:34 +0000

It's pretty common for newcomers in coding to struggle with many acronyms around their first weeks, today we'll talk about one that is very common to use in our profession, it's also really easy to understand trust me! In this article we'll talk about what does the JSON acronym mean, how can be used, what it looks like and much more! Allow me to introduce it

Table of contents
What is JSON anyway ?
Wasn't there a way of data-transport like this before?
What's the difference between JSON and XML ?
Is it still worth giving a try to XML?
Advantages of JSON
- JSON Syntax
- JSON Data Types
Practical example with Cars
- Working with JSON in JavaScript
- Working with JSON in Python
- Working with JSON in PHP
- Working with JSON in Java

What is JSON anyway ?

The JSON or "JavaScript Object Notation" is simply a basic format for transporting data that was created in 2000. But when you read the name, you might ask:

"If is a JavaScript Object Notation, then I can only use it with JavaScript, right?" - You, 2024

Not really, because since it's light and simple, it becomes easy to read by other languages and, mostly imporant, by people.

"Well. if is a light and simple way to transport data, then I'll use it as a database" - You, 2024

I wouldn't recommend it ....

Why not? Well, while JSON is great for transporting data because of its simplicity and readability, using a single JSON file as a whole database may not be the best idea. JSON files are not designed to handle large amounts of data efficiently. They lack the indexing, querying, and transactional capabilities of SQL databases like MySQL, PostgreSQL, or NoSQL databases like MongoDB and ScyllaDB. Using a single JSON file as a database can lead to performance issues, data integrity problems, and challenges in managing concurrent access to the data.

Wasn't there a way of data-transport like this before?

Of course there were. The main language used was XML (Extensible Markup Language), which was designed to be a flexible and customizable markup language. Although is powerful and highly extensible, it can be quite verbose. Each piece of data in XML is surrounded by tags, which can increase file size and complexity, especially in larger documents or data sets.

What's the difference between JSON and XML ?

JSON and XML are both data serialization formats. JSON is more concise, making it easier to read and faster to parse, which is well suited to the data structures of modern programming languages. XML, on the other hand, is more verbose with its use of explicit start and end tags, supporting a more complex hierarchical structure suitable for applications that require detailed metadata. While JSON is preferred for Web APIs due to its efficiency, XML is preferred in environments that require extensive document markup, such as enterprise applications.

Here is an XML example for comparison:

<bookstore>   
    <book>     
        <title>Learning XML</title>     
        <author>Erik T. Ray</author>     
        <price>29.99</price>   
    </book>   
    <book>     
        <title>JSON for Beginners</title>     
        <author>iCode Academy</author>    
        <price>39.95</price>   
    </book> 
</bookstore>

And now we have the same example, but this time in JSON:

{
  "bookstore": {
    "books": [
      {
        "title": "Learning XML",
        "author": "Erik T. Ray",
        "price": 29.99
      },
      {
        "title": "JSON for Beginners",
        "author": "iCode Academy",
        "price": 39.95
      }
    ]
  }
}

Is it still worth giving a try to XML?

Well, it depends on what your goal is, but in my opinion it's always worth taking a look on something, even if you don't intend to use it, just to get an idea of what it is and how it's used, you might come across a problem that XML can help you with, who knows.

Advantages of JSON

So as you have seen, the main reason for using JSON is its ability to be readable, along with a few others:

Easy to Read: JSON has a clear and straightforward structure.
Easy to Parse: Its simple syntax makes it easy for computers to parse.
Compact: JSON tends to be more lightweight, saving space and bandwidth.
Universal: Widely supported by various programming languages and platforms, used by major companies like Google and Twitter.

JSON Syntax

The JSON syntax is straightforward and without much secret, following some basic rules:

Data is in name/value pairs: Each data element in JSON is represented as a key (or name) and value pair, separated by a colon.
Data is separated by commas: Multiple key-value pairs within an object are separated by commas.
Curly braces hold objects: An object in JSON is enclosed within curly braces {}.
Square brackets hold arrays: An array in JSON is enclosed within square brackets [].

But it is easier for you to see than to read, so here are some examples for you, along with the definition of each type

JSON Data Types

JSON supports the following data types:

String: A sequence of characters, enclosed in double quotes. "name": "John Doe"
Number: Numeric values, can be integers or floating-point. "age": 30
Object: A collection of key-value pairs, enclosed in curly braces. "address": { "street": "123 Main St", "city": "Anytown" }
Array: An ordered list of values, enclosed in square brackets. "courses": ["Math", "Science", "History"]
Boolean: True or false values. "isStudent": false
Null: Represents a null value. "middleName": null

And no, you can't comment in a JSON :D

Practical example with Cars

Let's say you want to keep records of cars and their details. Here's an example of how these records can be organized in JSON:

{     
    "cars": [
        {         
            "brand": "Toyota",         
            "model": "Corolla",         
            "year": 2020,         
            "features": {             
                "color": "Blue",             
                "transmission": "Automatic"         
            }     
        }, 
        {         
            "brand": "Toyota",         
            "model": "Corolla",         
            "year": 2021,         
            "features": {             
                "color": "Red",             
                "transmission": "Automatic"         
            }     
        }
    ]
}

If you want to add more cars, you can simply add more objects to the cars array in the JSON structure.

And this can easily be done by parsing the JSON in a language of your choice and then manipulating it as you wish, here are some examples using the JSON shown earlier to give you a better idea of how to read and parse a JSON file

Working with JSON in JavaScript

const fs = require('fs').promises

const jsonPath = 'C:docs/example/example.json'
const readJsonFile = async () => {

    // Reads the content from the JSON and ensure is read as a string
    const jsonContent = await fs.readFile(jsonPath, 'utf-8')
    // Converts the JSON into a javascript object
    const data = JSON.parse(jsonContent)
    
    console.log(data.cars[0])
    //Output: { brand: "Toyota", model: "Corolla", year: 2020, features: { color: "Blue", transmission: "Automatic", }, }

    console.log(data.cars[1])
    //Output: { brand: "Toyota", model: "Corolla", year: 2021, features: { color: "Red", transmission: "Automatic", }, }

}
readJsonFile()

Working with JSON in Python

import json  

#Reads the JSON file  
with open('C:docs/example/example.json', 'r') as jsonFile:  
    #Parse the JSON content  
    jsonContent = json.load(jsonFile)  

print(jsonContent['cars'][0])  
#Output: {'brand': 'Toyota', 'model': 'Corolla', 'year': 2020, 'features': {'color': 'Blue', 'transmission': 'Automatic'}}  
print(jsonContent['cars'][1])  
#Output: {'brand': 'Toyota', 'model': 'Corolla', 'year': 2021, 'features': {'color': 'Red', 'transmission': 'Automatic'}}

Working with JSON in PHP

<?php  
$jsonPath = 'C:docs/example/example.json';  
// Reads the content from the JSON  
$contents = file_get_contents($jsonPath);  

// Converts the JSON content into a PHP Object  
$jsonContent = json_decode($contents);  

print_r($jsonContent->cars[1]);  
// Output: stdClass Object  
// (  
//    [brand] => Toyota  
//    [model] => Corolla  
//    [year] => 2021  
//    [features] => stdClass Object  
//        (  
//            [color] => Red  
//            [transmission] => Automatic  
//        )  
//  
//)

Working with JSON in Java

package org.example;  
import org.json.JSONArray;  
import org.json.JSONObject;  

import java.io.IOException;  
import java.nio.charset.StandardCharsets;  
import java.nio.file.Files;  
import java.nio.file.Paths;  

public class Main {  
    public static void main(String[] args) throws IOException {  
        String jsonFilePath = "C:docs/example/example.json";  
        // Reads the content from the file and converts into a string  
        String jsonContent = Files.readString(Paths.get(jsonFilePath), StandardCharsets.UTF_8);  

        // Converts the string content into a JSON Object  
        JSONObject jsonExample = new JSONObject(jsonContent);  

        JSONArray cars = jsonExample.getJSONArray("cars");  

        System.out.println(cars.get(0));  
        // Output: {"features": {"transmission":"Automatic","color":"Blue"},"year":2020,"model":"Corolla","brand":"Toyota"}  
        System.out.println(cars.get(1));  
        // Output: {"features":{"transmission":"Automatic","color":"Red"},"year":2021,"model":"Corolla","brand":"Toyota"}  

    }  
}

PS: The Java example uses the json library, if you try it make sure you have it on your dependencies.

Conclusion

Wrapping your head around JSON might seem a bit tricky at first, but it's actually a piece of cake once you get the hang of it! We've covered what JSON is, how it's used, and why it's so useful.

From understanding its syntax to seeing it in action in different programming languages, you're now ready to dive in and start using JSON in your projects.

If you still have any doubts, feel free to ask me directly. I hope you enjoyed the article - don't forget to like it and share it with that friend who is still struggling with JSON.

Feedback on the article is welcome so I can improve in the next one. Thanks for reading, stay healthy and drink water!