Lecciones

Una introducción breve y práctica a XML: estructura básica (elementos, atributos, nodos de texto, comentarios, CDATA), el prólogo y, sobre todo, para qué sirven los espacios de nombres y cómo declararlos y usarlos mediante los atributos xmlns y xmlns:prefix. Veremos los prefijos, el espacio por defecto ( xmlns= "URI"), la mezcla de diferentes “vocabularios” en un mismo documento y los errores típicos de análisis.

En esta lección analizamos dos enfoques clásicos para procesar XML: el basado en árbol, DOM, y el basado en eventos, SAX. Aprenderás a leer y modificar documentos a través del árbol ( Document, Element, NodeList) y a procesar archivos grandes en streaming con manejadores de eventos ( SAXParser, DefaultHandler, startElement/ characters/ endElement). Mostraremos pros y contras de cada enfoque, ejemplos prácticos y revisaremos errores típicos (memoria, división del texto en characters, intentos de modificar XML en SAX).

Analizamos el análisis sintáctico en flujo (streaming) de XML con StAX: en qué se diferencia el modelo pull del enfoque push de SAX, cómo crear un parser mediante XMLInputFactory y leer eventos de XMLStreamReader con un bucle que llama a reader. next(), qué tipos de eventos existen ( START_ELEMENT, CHARACTERS, END_ELEMENT, END_DOCUMENT) y cuándo StAX es preferible a DOM/ SAX. Además: tabla comparativa de enfoques, diagrama Mermaid y revisión de errores típicos (fugas de flujos, anidamiento de elementos, excepciones XMLStreamException, IOException).

Cómo, con JAXB (Jakarta XML Binding), convertir objetos de Java a XML y viceversa: anotaciones clave @XmlRootElement, @XmlElement, @XmlAttribute, @XmlType, @XmlTransient; clases básicas JAXBContext, Marshaller, Unmarshaller; configuración del formato mediante la propiedad Marshaller.JAXB_FORMATTED_OUTPUT. Revisamos las dependencias de Maven para Java 11+ ( jakarta.xml.bind-api, jaxb-runtime), el trabajo con colecciones y objetos anidados, el control del orden de los elementos ( propOrder), la exclusión de campos y los errores típicos.

Cómo enseñar a JAXB a serializar tipos «no estándar» y a representar los datos en el formato deseado: usamos la anotación @XmlJavaTypeAdapter y escribimos adaptadores propios basados en XmlAdapter<ValueType, BoundType>. Veremos el formateo de fechas ( LocalDate → "dd.MM.yyyy"), números ( BigDecimal), el trabajo con colecciones, cómo pasar valores a atributos con @XmlAttribute, a elementos con @XmlElement y excluir campos con @XmlTransient. Practicaremos la serialización/deserialización con Marshaller/ Unmarshaller y analizaremos errores típicos.