XML a JSON: las decisiones que todo convertidor debe tomar

La ambigüedad que ningún conversor puede evitar

Considere `<items><item>x</item></items>`. ¿Debería `item` ser una cadena o una lista de uno? XML no lo dice, y la diferencia importa en el momento en que escribes código en su contra: un consumidor que espera siempre una matriz se rompe en una respuesta de un solo elemento, y un consumidor que espera que un objeto se rompa cuando llega un segundo elemento. Los convertidores maduros le permiten forzar matrices para elementos de lista conocidos en lugar de adivinar silenciosamente, porque la suposición es correcta con la frecuencia suficiente para alcanzar la producción.

Los atributos necesitan una convención de nomenclatura

JSON no tiene atributos, por lo que un atributo debe convertirse en una clave hermana o en un objeto anidado. La convención ampliamente utilizada antepone los nombres de atributos con `@` - `<image src="a.png"/>` se convierte en `{"@src": "a.png"}`, mientras que el texto del elemento va a una clave reservada como `#text` cuando un elemento tiene atributos y contenido. Cualquiera que sea la convención que utilice el conversor, debe aplicarse de forma coherente, porque el XML medio convertido es peor que el XML no convertido.

                <rss version="2.0"><channel><title>Feed</title></channel></rss>
→ {
  "rss": {
    "@version": "2.0",
    "channel": { "title": "Feed" }
  }
}
              

Espacios de nombres

Los documentos con espacios de nombres (servicios SOAP, mapas de sitio, formatos de Office) califican los nombres de los elementos como `ns:element`. JSON no tiene equivalente, por lo que un convertidor elimina el prefijo, lo mantiene como parte de la clave o reorganiza el documento alrededor del URI del espacio de nombres. Eliminarlo es común y en ocasiones desastroso cuando dos espacios de nombres usan el mismo nombre local. Si su documento utiliza espacios de nombres, verifique la salida para detectar colisiones antes de confiar en ella y prefiera mantener el prefijo en la clave.

Dónde se utiliza realmente esta conversión

• Feeds RSS y Atom: leer un feed en JavaScript es mucho más fácil después de la conversión.
• SOAP y API heredadas: convertir una respuesta en algo que un cliente moderno pueda consumir.
• Mapas de sitio y archivos de configuración: inspeccionar la estructura sin un editor que comprenda los esquemas.
• Migraciones de datos: mover registros de un sistema de la era XML a uno basado en JSON.

Round-trip fidelity is a myth. La conversión de XML a JSON y viceversa rara vez devuelve el documento original byte por byte, porque el orden de declaración, los espacios en blanco, los comentarios y CDATA no sobreviven. Convierta cuando necesite consumir los datos en otro lugar, no como estrategia de respaldo.

Validar primero, luego convertir

Los analizadores XML son estrictos con las etiquetas no cerradas y las entidades no válidas, y los mensajes de error suelen ser precisos. Corrija el documento antes de convertirlo: una entrada bien formada es la única manera de obtener una estructura JSON que valga la pena conservar. Luego, la conversión se ejecuta localmente en el navegador, lo cual es importante cuando XML es una exportación de un cliente o una respuesta de servicio interno, y continúa funcionando sin conexión.