XML para JSON: Um Guia para Modernizar Dados de Interfaces de Sistemas Legados

Elementos XML correspondem a objetos JSON, e nós de texto dentro de elementos são armazenados por padrão na chave #text. Todos os atributos de elementos XML recebem o prefixo @_ como chaves de objeto JSON para distingui-los de elementos filhos, uma convenção adotada pela maioria das ferramentas de conversão.

Elementos filhos duplicados com o mesmo nome são agregados automaticamente em um array JSON. Independentemente de o elemento filho aparecer 1 vez ou N vezes, a saída mantém uma estrutura de array consistente, eliminando a necessidade de verificação de tipo na lógica de negócio frontend.

Para XML no estilo envelope retornado por interfaces SOAP de backends legados, os dados principais dentro do nó Body são extraídos e convertidos para a estrutura JSON correspondente, com identificadores de namespace retidos para processamento posterior. Após a conversão de XML de feed RSS, os nós entry são agregados automaticamente em um array que pode ser renderizado diretamente como uma lista pelo frontend. Após a conversão de XML de configuração de projeto legado, a saída pode ser lida e utilizada diretamente por serviços de backend Node.js.

Prefixos de namespace XML são retidos integralmente quando convertidos para os nomes de chave JSON correspondentes, não são removidos automaticamente. Os desenvolvedores podem filtrar identificadores de namespace indesejados de acordo com os requisitos do negócio. O conversor de XML para JSON do OKfmt retém por padrão as informações originais de namespace.

O texto dentro de seções CDATA retém diretamente o seu conteúdo original, armazenado como o valor de string do nó correspondente, sem aplicação de escape ou truncamento. Isso garante a integridade estrutural de textos especiais, como fragmentos HTML e conteúdo de script.

O XML nativo suporta estruturas aninhadas de várias camadas, que são preservadas na hierarquia correspondente após a conversão para JSON, adaptando-se à lógica de processamento de objetos aninhados das APIs modernas. Para cenários de negócio que requerem armazenamento plano, estruturas aninhadas com mais de 3 camadas podem ser achatadas manualmente por caminho, usando underscores para concatenar os nomes de chave dos nós pais.

A achatação reduz a complexidade do acesso hierárquico durante a análise de JSON, tornando-a adequada para armazenamento em bancos de dados relacionais ou análise de logs. As ferramentas de conversão retêm a estrutura aninhada original por padrão e permitem que os usuários escolham independentemente se desejam ativar a achatação.