Jackson para Java: guia completo com exemplos

O que é Jackson e para que serve?

\n\n

Jackson é uma biblioteca poderosa e de alto desempenho para Java, projetada para processar dados no formato JSON (JavaScript Object Notation). No desenvolvimento moderno de aplicações Java, o JSON tornou-se o padrão de facto para troca de dados entre cliente e servidor, especialmente em serviços web RESTful e arquitetura de microsserviços. Jackson resolve três tarefas principais:

\n\n

\n
• Serialização (Serialization) — conversão de objetos Java em uma string JSON.
\n
• Desserialização (Deserialization) — conversão de uma string JSON de volta em objetos Java.
\n
• Manipulação de árvore (Tree Model) — trabalho com JSON como uma estrutura de árvore de nós (JsonNode).
\n

\n\n

A biblioteca se destaca pela alta velocidade de processamento, flexibilidade de configuração e amplo suporte a anotações. Jackson é usado por gigantes como Spring Framework (através do módulo spring-web), Play Framework e muitas outras soluções empresariais. Sem Jackson, é difícil imaginar o desenvolvimento Java moderno, onde é necessária integração com APIs externas, trabalho com arquivos de configuração ou armazenamento de dados em bancos de dados NoSQL.

\n\n

Instalação do Jackson

\n\n

Jackson consiste em vários módulos. Os principais são:

\n

\n
• jackson-core — núcleo da biblioteca (parser/gerador de fluxo).
\n
• jackson-databind — módulo para serialização/desserialização (depende de core e annotations).
\n
• jackson-annotations — anotações para configuração de mapeamento.
\n

\n\n

Para a maioria das tarefas, basta adicionar jackson-databind, pois ele puxará transitivamente os outros módulos.

\n\n

Instalação via Maven

\n

Adicione ao arquivo pom.xml:

\n

<dependency>\n    <groupId>com.fasterxml.jackson.core</groupId>\n    <artifactId>jackson-databind</artifactId>\n    <version>2.17.1</version> <!-- Verifique a versão mais recente no Maven Central -->\n</dependency>

\n\n

Instalação via Gradle

\n

Adicione ao arquivo build.gradle:

\n

implementation 'com.fasterxml.jackson.core:jackson-databind:2.17.1'

\n\n

Instalação via pip? Não, isso é Java!

\n

Observação importante: Jackson é uma biblioteca para Java, não para Python. Em Python, o equivalente é o módulo padrão json ou a biblioteca simplejson. Para Java, a instalação é feita através de sistemas de gerenciamento de dependências (Maven, Gradle) ou baixando os arquivos JAR do site oficial.

\n\n

Início rápido: primeiro exemplo

\n\n

Vamos criar uma classe Java simples e aprender a transformá-la em JSON e vice-versa.

\n\n

Passo 1: Crie a classe modelo

\n

import com.fasterxml.jackson.annotation.JsonProperty;\n\npublic class User {\n    private String name;\n    private int age;\n    private String email;\n\n    // Construtor padrão é obrigatório!\n    public User() {}\n\n    public User(String name, int age, String email) {\n        this.name = name;\n        this.age = age;\n        this.email = email;\n    }\n\n    // Getters e setters são obrigatórios para o Jackson\n    public String getName() { return name; }\n    public void setName(String name) { this.name = name; }\n\n    public int getAge() { return age; }\n    public void setAge(int age) { this.age = age; }\n\n    public String getEmail() { return email; }\n    public void setEmail(String email) { this.email = email; }\n}

\n\n

Passo 2: Serialização e desserialização

\n

import com.fasterxml.jackson.databind.ObjectMapper;\n\npublic class Main {\n    public static void main(String[] args) throws Exception {\n        // Cria o objeto principal da biblioteca\n        ObjectMapper mapper = new ObjectMapper();\n\n        // Cria um objeto Java\n        User user = new User("João Silva", 30, "joao@exemplo.co