XML a JSON: por qué cambian los arrays y los atributos

PublicadoHerramientaConversor XML ↔ JSON

Contenido
  1. El problema
  2. La solución
  3. Puntos donde sueles atascarte
  4. En resumen
  5. Preguntas frecuentes

Cuando conviertes un array de JSON a XML, no aparece una etiqueta nueva que envuelva el array: la estructura pasa a ser la de etiquetas con el mismo nombre repetidas tal cual, tantas veces como elementos haya. A la inversa, cuando los atributos de XML pasan a JSON no se mezclan con los demás valores, sino que se meten bajo una clave aparte, como @attributes. Ninguna de las dos cosas es un error: son el resultado de que la forma de la información que XML y JSON pueden contener es distinta de entrada.

Resumen ① Un array de JSON se convierte en una estructura donde las etiquetas con el mismo nombre se repiten tantas veces como elementos haya, sin ninguna etiqueta que las envuelva, porque en XML no existe el concepto de array. ② Un elemento XML puede tener a la vez atributos, elementos hijos y texto, pero un objeto JSON no distingue esas tres cosas, así que el conversor separa los atributos en una clave aparte, como @attributes. ③ Esta forma de representarlo no es una regla fijada por los estándares de XML y JSON, sino una convención que decide el conversor, así que con otra herramienta la forma del JSON resultante puede variar un poco.

El problema

Cuando conviertes a JSON datos que llegan en XML para usarlos en tu código, te atascas en dos puntos. Uno es «si hay varias etiquetas con el mismo nombre es un array, entonces por qué cuando hay una sola no sale un array, sino un único objeto». El otro es «por qué un valor de atributo como category="cooking" no aparece al mismo nivel que otros campos como title o author, sino dentro de una clave que no conoces, @attributes».

En la dirección contraria pasa lo mismo. Cuando tienes que exportar datos de un array de JSON a un formato XML y ves por primera vez que no aparece una etiqueta que envuelva el array, sino solo etiquetas con el mismo nombre repetidas tantas veces como elementos haya, te quedas pensando si la estructura del array no habrá desaparecido.

En los dos casos no es un resultado mal generado por el conversor, sino una consecuencia inevitable de que XML y JSON pueden expresar la información de formas distintas.

La solución

Si ordenas las dos direcciones en forma de reglas, puedes anticipar la forma del resultado incluso sin herramienta.

Array de JSON → XML: por qué se repiten las etiquetas En XML no existe un tipo de dato array. Lo que hay son «elementos», y un elemento puede aparecer varias veces seguidas con el mismo nombre. Así que al pasar "book": [ {...}, {...} ] de JSON a XML, en lugar de crear una etiqueta nueva que envuelva el array se usa el método de repetir la etiqueta <book> tantas veces como elementos haya dentro. Con 2 elementos, <book> aparece 2 veces; con 5, 5 veces.

Atributos XML → JSON: por qué se separan en @attributes Un solo elemento XML puede tener a la vez tres cosas: atributos (por ejemplo, category="cooking"), elementos hijos (por ejemplo, <title>) y texto (los caracteres que van entre las etiquetas). En cambio, un objeto JSON solo tiene pares clave-valor y no cuenta con una sintaxis que distinga «si este valor es un atributo o un elemento hijo». Para que esa distinción no se pierda, el conversor agrupa los atributos bajo una clave aparte llamada @attributes, de modo que no se mezclen con los elementos hijos ni con el texto. Si un elemento tiene atributos y texto a la vez, el texto se guarda aparte en otra clave llamada #text.

Si no hay atributos ni elementos hijos, el texto tal cual Al contrario, si un elemento solo tiene texto, sin atributos ni elementos hijos (por ejemplo, <author>Giada De Laurentiis</author>), no se envuelve en un objeto: se devuelve ese valor directamente como texto. Esa es la razón por la que ves algo tan simple como {"author": "Giada De Laurentiis"}.

Si el JSON tiene varias claves en el nivel superior, se crea automáticamente una etiqueta que las envuelve En XML tiene que haber exactamente un elemento raíz. Por eso, si el JSON que conviertes tiene una sola clave en el nivel superior, se usa ese nombre de clave tal cual como etiqueta raíz; pero si tiene dos o más claves, no hay ninguna etiqueta que las envuelva, así que el conversor crea por su cuenta una etiqueta llamada <root> y mete dentro todas las claves como hijas.

Con estas cuatro reglas ya puedes explicar la mayoría de las veces por qué la estructura resultante sale así al ir de XML a JSON y de JSON a XML. Compruébalo tú mismo con ejemplos reales en nuestra herramienta.

Conversor XML ↔ JSON

Pega tu XML y lo verás al instante en JSON, o pega tu JSON y lo obtendrás en XML: la conversión funciona en ambos sentidos.

Puntos donde sueles atascarte

SituaciónMotivo
Un hijo con el mismo nombre aparece una sola vez y sale como objeto, no como arrayLa regla es que se pasa a array a partir de la segunda vez que aparece el mismo nombre, así que tu código puede comportarse de forma distinta según si hay 1 elemento o 2 o más
Un valor que parece numérico sale como texto entre comillasEl texto de XML no tiene concepto de tipo, así que valores como 2005 o 30.00 también se convierten a texto
Atributos, elementos hijos y texto mezclados en una misma etiquetaLos atributos van a @attributes, los elementos hijos a la clave con el nombre de su etiqueta y el texto restante a la clave #text
Varias claves en el nivel superior del JSONComo no hay ninguna etiqueta que las envuelva, el conversor crea automáticamente una etiqueta llamada root y envuelve todo con ella
Un valor null en el JSONSe convierte en una etiqueta autocerrada sin contenido (<tag/>)

En resumen

  • Un array de JSON se convierte en una estructura donde las etiquetas con el mismo nombre se repiten tantas veces como elementos haya, sin ninguna etiqueta que las envuelva, porque en XML no existe el concepto de array.
  • Un elemento XML puede tener a la vez atributos, elementos hijos y texto, pero un objeto JSON no hace esa distinción, así que el conversor separa los atributos en @attributes y el texto restante en #text.
  • Un elemento que solo tiene texto, sin atributos ni elementos hijos, no se envuelve en un objeto: sale directamente como valor de texto.
  • En XML tiene que haber un único elemento raíz, así que si el JSON tiene varias claves en el nivel superior, el conversor crea automáticamente una etiqueta root que las envuelve.
  • Esta forma de representarlo no es una regla fijada por los estándares de XML y JSON, sino una convención del conversor, así que si conviertes con otra herramienta los nombres de las claves pueden salir distintos.
Conversor XML ↔ JSON

Pega tu XML y lo verás al instante en JSON, o pega tu JSON y lo obtendrás en XML: la conversión funciona en ambos sentidos.

Preguntas frecuentes

¿Se puede hacer que salga como array aunque solo haya un elemento hijo?

Esta regla de conversión pasa a array a partir de la segunda vez que aparece un elemento con el mismo nombre, así que si solo hay un elemento sale únicamente como un objeto. Si quieres tratarlo siempre como array, sin importar el número de elementos, tienes que añadir tú mismo en tu código, después de recibir el JSON convertido, un paso que envuelva el valor en un array cuando no lo sea.

¿Los nombres @attributes y #text son un estándar fijado?

Entre XML y JSON no existe un estándar oficial que obligue a usar estos nombres. @attributes y #text son la notación que ha adoptado este conversor para distinguir atributos y texto de los demás valores, y otras bibliotecas o herramientas usan otros enfoques, como poner una @ delante del nombre del atributo. Por eso, cuando pases el JSON convertido a otro sistema, lo más seguro es comprobar antes si el otro lado usa la misma notación.

Al convertir JSON a XML, ¿puedo elegir el nombre de la etiqueta raíz?

Si el JSON tiene exactamente una clave en el nivel superior, ese nombre de clave se convierte tal cual en la etiqueta raíz, así que basta con fijar de antemano el nombre que quieras como esa clave. Si hay varias claves en el nivel superior no hay etiqueta que las envuelva y se pone automáticamente el nombre root, así que para usar el nombre que quieras tienes que envolver antes el JSON en la forma { "nombreQueQuieras": { ...resto de claves } }.

Este artículo está adaptado de nuestro original en coreano. Leer el original en coreano

Artículos relacionados

  1. XML bien formado: qué es y por qué es más estricto que HTMLEl navegador repara las etiquetas sin cerrar de HTML, pero XML rechaza el documento entero por un solo error. Aprende las reglas y cómo comprobarlas.
  2. Convertir YAML a JSON: reglas y errores al pasar tu configuraciónPor qué YAML no sirve en código o en una petición a la API, las reglas para convertir a JSON a mano y los puntos donde es fácil equivocarse.
  3. Error de indentación en YAML: por qué falla tu despliegueUn espacio de más en el YAML de GitHub Actions o GitLab CI puede tumbar el despliegue. Aprende a localizar la línea exacta del error sin contar a mano.
  4. Subtítulos automáticos de YouTube: por qué fallan y SRT vs VTTPor qué los subtítulos automáticos de YouTube fallan en nombres y términos técnicos, en qué se diferencian de los manuales y cuándo elegir SRT, VTT o TXT.
  5. Numerar líneas de texto: 5 formatos y alineación de dígitosAñade 1., [1] o 01. al inicio de cada línea de un texto o código, excluye las líneas vacías y calcula el relleno con ceros.
  6. Anagramas: cómo comprobar si dos textos lo son (4 pasos)Aprende a comprobar si dos palabras o frases son anagramas: pasos manuales, reglas para mayúsculas y espacios, ejemplos y un algoritmo con tablas hash.

Herramientas relacionadas