Conversor de JSON para Dart

Como o JSON se transforma em modelos Dart com null safety

A documentação oficial do dart:convert explica que jsonDecode() produz valores compatíveis com JSON, como números, strings, booleanos, null, listas e mapas com chaves de texto. Uma classe de modelo não pode ser codificada diretamente em JSON, mas jsonEncode() pode chamar o método toJson() dela. Este conversor gera esse padrão de serialização manual sem adicionar anotações json_serializable nem dependências de pacotes.

Imagine uma amostra com um usuário e um endereço aninhado. A classe User gerada tem campos final e um construtor com parâmetros nomeados. User.fromJson(Map<String, Object?> json) converte valores escalares e chama UserAddress.fromJson() para o objeto aninhado. Se address estiver ausente ou for null em qualquer objeto analisado, seu tipo passa a ser UserAddress?, e a factory verifica o valor antes de criar a instância. Quando toJson está ativado, os modelos aninhados são convertidos recursivamente em mapas aceitos por jsonEncode().

O conversor examina todos os objetos de uma lista raiz, em vez de confiar apenas no primeiro item. Um campo se torna nullable quando está ausente em algum objeto ou aparece explicitamente como null. Você também pode tornar todos os campos nullable quando a API real for menos previsível do que a amostra. O guia de null safety do Dart ressalta que os tipos não aceitam null por padrão e precisam de ? para isso.

Tratamento de identificadores e limites da inferência

As chaves JSON não precisam ser membros Dart válidos. A pontuação é removida, as palavras são convertidas para lowerCamelCase, palavras reservadas recebem um sufixo seguro e colisões recebem sufixos numéricos determinísticos. A chave original permanece inalterada em json['original-key'] e no mapa de toJson(). Os nomes das classes aninhadas usam o caminho completo para que objetos de endereço independentes não sejam combinados por engano.

Uma única amostra não comprova o contrato de uma API. Strings JSON não são automaticamente datas, UUIDs ou enums, e uma lista vazia não revela o tipo dos elementos. Nomes de membros duplicados também não permitem uma conversão de ida e volta confiável, pois os analisadores JSON costumam preservar apenas o último valor. Antes de usar os modelos em produção, compare-os com a documentação ou o esquema da API. Limites de entrada, profundidade, declarações inferidas e saída mantêm o trabalho do navegador sob controle.