PT
RU
EN
ES
ZH
FR
DE
AR
HI
O que é Gson e para que serve?
\n\nGson é uma poderosa biblioteca para a linguagem Java, desenvolvida pela empresa Google, que permite converter objetos Java em sua representação JSON (serialização) e, inversamente, restaurar objetos Java a partir de strings JSON (desserialização). JSON (JavaScript Object Notation) é um formato leve de troca de dados, amplamente utilizado em APIs web, arquivos de configuração e para armazenar dados estruturados.
\n\nPor que usar Gson? No desenvolvimento moderno de aplicações Java, praticamente nenhum projeto funciona sem lidar com JSON. Seja para comunicação com APIs REST, leitura de configurações ou troca de dados entre microsserviços — o Gson oferece uma maneira simples, rápida e confiável de conversão. Ao contrário da biblioteca padrão do Java (org.json), o Gson consegue trabalhar diretamente com objetos Java arbitrários (POJOs), mapeando automaticamente os campos da classe com as chaves JSON. Isso poupa o desenvolvedor de fazer parsing manual e escrever código repetitivo.
Instalação do Gson
\n\nGson é uma biblioteca Java, portanto é distribuída através de sistemas de gerenciamento de dependências para JVM. Abaixo estão as formas de instalação para as ferramentas de build mais populares.
\n\nMaven
\nAdicione a seguinte dependência ao seu arquivo pom.xml:
<dependency>\n <groupId>com.google.code.gson</groupId>\n <artifactId>gson</artifactId>\n <version>2.10.1</version> <!-- Verifique a versão mais recente no Maven Central -->\n</dependency>Gradle
\nAdicione ao arquivo build.gradle:
implementation 'com.google.code.gson:gson:2.10.1'Download direto do JAR
\nSe você não utiliza sistemas de build, baixe o arquivo JAR do Maven Central e adicione-o ao classpath do seu projeto.
\n\nImportante: Ao contrário do Python (pip) ou Node.js (npm), no Java não existe um gerenciador de pacotes único. Maven e Gradle são o padrão de facto.
\n\nInício rápido: primeiro exemplo
\n\nVamos criar uma classe simples Person e serializá-la em JSON, e depois desserializá-la de volta.
import com.google.gson.Gson;\n\npublic class QuickStart {\n public static void main(String[] args) {\n // 1. Criar um objeto\n Person person = new Person("Ivan", 30, "ivan@example.com");\n\n // 2. Criar uma instância do Gson\n Gson gson = new Gson();\n\n // 3. Serialização (Java -> JSON)\n String json = gson.toJson(person);\n System.out.println("JSON: " + json);\n // Saída: JSON: {"name":"Ivan","age":30,"email":"ivan@example.com"}\n\n // 4. Desserialização (JSON -> Java)\n String jsonInput = "{\\"name\\":\\"Maria\\",\\"age\\":25,\\"email\\":\\"maria@test.com\\"}";\n Person personFromJson = gson.fromJson(jsonInput, Person.class);\n System.out.println("Nome: " + personFromJson.getName());\n // Saída: Nome: Maria\n }\n}\n\nclass Person {\n private String name;\n private int age;\n private String email;\n\n // É obrigatório ter um construtor padrão (sem argumentos) para a desserialização!\n public Person() {}\n\n public Person(String name, int age, String email) {\n this.name = name;\n this.age = age;\n this.email = email;\n }\n\n public String getName() { return name; }\n public int getAge() { return age; }\n public String getEmail() { return email; }\n}Principais métodos e funções do Gson
\n\nAbaixo estão os principais métodos da biblioteca Gson. Cada método é acompanhado de uma descrição e um exemplo funcional.
\n\n1. Gson.toJson(Object src)
\nO que faz: Serializa o objeto Java fornecido em uma string JSON. Este é o método mais básico para converter um objeto em JSON.
\n
