🧩

Gerador de classes C# a partir de JSON

Transforme payloads JSON em classes C# fortemente tipadas com JsonPropertyName, suporte a referências anuláveis e código limpo pronto para uso.

Guia prático
Configurações
Nome da classe
Nome da classe C# raiz gerada
Adicionar JsonPropertyName
Mantém a chave original com JsonPropertyName("key")
Ativar referências anuláveis
Adiciona ? automaticamente quando o JSON aceita null
Gerar partial class
Marca todas as classes como partial para ampliá-las em outros arquivos

Inserir JSON

JSON válido

❓Por que gerar classes C# a partir de JSON?

APIs REST, eventos em nuvem, configurações e telemetria entregam JSON. Conversor esses exemplos em classes C# tipadas garante segurança em tempo de compilação, melhor IntelliSense, modelos de domínio claros e refatorações tranquilas. JsonPropertyName preserva as chaves originais e acelera a troca de contratos entre equipes.

✨Recursos

🚀

Saída tipada

Infere tipos C#, cria classes aninhadas e preserva as chaves originais do JSON.
🧷

JsonPropertyName

Garante compatibilidade total com System.Text.Json mesmo para payloads snake_case.
🧮

Consciência nullable

Adiciona ? automaticamente quando o campo pode ser null e documenta claramente o contrato.
📊

Estatísticas integradas

Mostra quantas classes, propriedades e arrays foram gerados.

📚Guia prático

Mapeamento JSON → C#

Strings tornam-se string ou DateTime, inteiros viram long, números com decimais double, booleanos bool, objetos classes dedicadas e arrays viram List<T>. Se o exemplo contém null, a propriedade vira nullable e, com a opção ativada, recebe ?. Arrays heterogêneos recuam para List<object> preservando toda a estrutura.

Pipeline de geração

O conversor percorre o JSON recursivamente, normaliza nomes para PascalCase, evita palavras reservadas e reutiliza assinaturas quando os objetos possuem o mesmo formato. As métricas de classes, propriedades e arrays são exibidas imediatamente após a conversão para avaliar a complexidade do payload.

JsonPropertyName e serialização

System.Text.Json utiliza JsonPropertyName, portanto o código pode ser decorado com a chave original, garantindo compatibilidade com payloads snake_case. Como as classes são partial, você pode adicionar validações, conversores ou anotações em outros arquivos sem tocar no código gerado.

Estratégia nullable

Referências anuláveis ativadas significam que todo valor potencialmente null (bool, long, double, string, List<T>, classes aninhadas) recebe ?. Assim o compilador alerta cedo e NullReferenceException são evitadas.

💬Frequently Asked Questions

❓O que é geração de classes C# a partir de JSON e por que é útil?
A geração de classes C# a partir de JSON cria automaticamente classes C# fortemente tipadas a partir de estruturas de dados JSON. Isso é essencial ao trabalhar com APIs, arquivos de configuração ou serialização de dados em aplicações .NET. Em vez de escrever classes manualmente ou usar tipos dinâmicos, o gerador cria classes C# apropriadas com tipos corretos, suporte nullable e atributos JsonPropertyName, economizando horas de desenvolvimento e reduzindo erros.
💬Como o gerador lida com diferentes tipos de dados JSON?
O gerador mapeia tipos JSON para tipos C# apropriados: strings se tornam string ou DateTime (para datas ISO-8601), inteiros mapeiam para long, números de ponto flutuante para double, booleanos para bool, objetos se tornam classes dedicadas e arrays se tornam List<T>. Valores null marcam propriedades como nullable (com sufixo ? quando referências nullable estão habilitadas). Arrays mistos usam List<object> para preservar dados heterogêneos.
🔍O que são atributos JsonPropertyName e quando devo usá-los?
Atributos JsonPropertyName permitem que propriedades C# usem nomenclatura PascalCase (convenção C#) enquanto JSON usa nomenclatura diferente (como snake_case ou camelCase). O atributo preserva o nome da chave JSON original durante serialização/desserialização. Habilite esta opção quando seu JSON usa chaves não-PascalCase mas você quer nomes de propriedades C# idiomáticos em seu código.
💡O que é suporte de referências nullable e por que habilitá-lo?
Tipos de referência nullable (C# 8.0+) adicionam ? a tipos de referência quando podem ser null, habilitando verificação null em tempo de compilação. Quando habilitado, o gerador adiciona ? a propriedades quando a amostra JSON contém valores null. Isso ajuda a prevenir erros NullReferenceException, torna campos opcionais explícitos e segue melhores práticas modernas de C# para segurança null.
📚Posso modificar as classes geradas após a geração?
Sim, o gerador cria classes parciais por padrão (ou quando habilitado), permitindo que você as estenda em arquivos separados sem modificar o código gerado. Você pode adicionar métodos personalizados, lógica de validação, atributos específicos do domínio ou implementar interfaces. Esta separação mantém o código gerado limpo e permite regenerar com segurança as classes quando a estrutura JSON muda.

💡Melhores práticas

💡

Use amostras representativas

Inclua campos opcionais e null para que o gerador saiba quais propriedades são nullable.
🧱

Divida payloads gigantes

Converta seções separadas e una tudo via partial class dentro da solução.
🧾

Limpe o JSON

Remova comentários e vírgulas finais para evitar erros de parsing.

📝Registro de atualizações

📌v1.0.251115
v1.0.251115

Primeiro lançamento com alternância JsonPropertyName, suporte nullable, painel de estatísticas e exportação .cs

📦Componentes recomendados

User Comments

0 / 2000
Loading...