Lezioni

Una introduzione breve e pratica a XML: struttura di base (elementi, attributi, nodi di testo, commenti, CDATA), composizione del prologo e, soprattutto, perché servono i namespace e come dichiararli e applicarli tramite gli attributi xmlns e xmlns:prefix. Analizzeremo i prefissi, il namespace predefinito ( xmlns= "URI"), la commistione di diversi «vocabolari» in un unico documento e gli errori tipici di parsing.

In questa lezione analizziamo due approcci classici al parsing di XML: il modello ad albero DOM e il modello basato su eventi SAX. Imparerete a leggere e modificare i documenti tramite l'albero ( Document, Element, NodeList) e a elaborare file grandi in streaming con i gestori di eventi ( SAXParser, DefaultHandler, startElement/ characters/ endElement). Mostreremo pro e contro di ciascun approccio, esempi pratici e analizzeremo gli errori tipici (memoria, frammentazione del testo in characters, tentativi di modificare l'XML con SAX).

Analizziamo il parsing XML in streaming con StAX: in cosa il modello pull differisce dall’approccio push di SAX, come creare un parser tramite XMLInputFactory e leggere gli eventi da XMLStreamReader con un ciclo che chiama reader. next(), quali tipi di eventi esistono ( START_ELEMENT, CHARACTERS, END_ELEMENT, END_DOCUMENT) e quando StAX è preferibile a DOM/ SAX. In più: una tabella di confronto degli approcci, un diagramma Mermaid e l’analisi degli errori tipici (leak di stream/risorse, nidificazione degli elementi, eccezioni XMLStreamException, IOException).

Come usare JAXB (Jakarta XML Binding) per trasformare oggetti Java in XML e viceversa: annotazioni chiave @XmlRootElement, @XmlElement, @XmlAttribute, @XmlType, @XmlTransient; classi di base JAXBContext, Marshaller, Unmarshaller; impostazione del formato tramite la proprietà Marshaller.JAXB_FORMATTED_OUTPUT. Consideriamo le dipendenze Maven per Java 11+ ( jakarta.xml.bind-api, jaxb-runtime), il lavoro con collezioni e oggetti annidati, la gestione dell’ordine degli elementi ( propOrder), l’esclusione di campi ed errori tipici.

Come insegnare a JAXB a serializzare tipi «non standard» e a rappresentare i dati nel formato desiderato: usiamo l’annotazione @XmlJavaTypeAdapter e scriviamo adapter personalizzati basati su XmlAdapter<ValueType, BoundType>. Vedremo la formattazione delle date ( LocalDate → "dd.MM.yyyy"), dei numeri ( BigDecimal), il lavoro con le collezioni, lo spostamento dei valori negli attributi tramite @XmlAttribute, negli elementi tramite @XmlElement e l’esclusione dei campi con @XmlTransient. Faremo pratica di serializzazione/deserializzazione tramite Marshaller/ Unmarshaller e analizzeremo gli errori tipici.