Hogyan működik az XML kezelése Kotlinben?

A Kotlinben az XML-fájlokkal való munka többféleképpen valósítható meg, a feladattól és az preferenciáktól függően:

1. Szabványos Java API-k: A Kotlin teljes mértékben kompatibilis a Java-val, így használhatók a szabványos Java XML API-k:

   • javax.xml.parsers.DocumentBuilderFactory és org.w3c.dom.Document DOM-parsinghez (kényelmes a struktúrában való navigáláshoz).
   • javax.xml.stream.XMLInputFactory és javax.xml.stream.events.XMLEvent vagy javax.xml.stream.XMLStreamReader StAX-parsinghez (eseményalapú, nagyobb fájlokhoz hatékonyabb).
   • javax.xml.transform.TransformerFactory XML-transzformációhoz (XSLT).
   • javax.xml.bind.JAXBContext JAXB-hez (XML kötés Java objektumokhoz, bár a modern Kotlinben inkább a kotlinx.serialization vagy Moshi XML kiegészítőkkel érdemes használni).

2. Koručinok és Flow (aszinkron feldolgozás): Hálózati kéréseknél, amelyek XML-t adnak vissza, koručinokat lehet használni a parsing háttérszálon való végrehajtására, és Flow-t az XML elemek vagy események sorozatának feldolgozására.

3. Harmadik féltől származó könyvtárak: Számos külső könyvtár kínál kényelmesebb vagy specializáltabb módszereket az XML kezelésére Kotlinben:

   • Kotlinx.serialization-xml: Kísérleti plugin a kotlinx.serialization-hoz, amely lehetővé teszi Kotlin objektumok XML-be való sorosítását/ deszerializálását.
   • Moshi: Bár elsősorban JSON-hez, léteznek kiterjesztések vagy adapterek XML-hez.
   • Simple XML Serialization: Népszerű Java könyvtár, amit Kotlinben is lehet használni.
   • Jackson XML: A Jackson könyvtár része, támogatja Java/Kotlin objektumok XML-be való sorosítását/ deszerializálását.

Példa DOM-parsing:

import javax.xml.parsers.DocumentBuilderFactory
import org.w3c.dom.Document
import java.io.File

fun parseXmlFile(filePath: String): Document {
    val factory = DocumentBuilderFactory.newInstance()
    val builder = factory.newDocumentBuilder()
    val inputFile = File(filePath)
    return builder.parse(inputFile)
}

fun main() {
    val doc = parseXmlFile("example.xml")
    // További munka a DOM-fával
    // println("Root element :" + doc.documentElement.nodeName)
}

StAX-parsing példa (Pull parser):

import javax.xml.stream.XMLInputFactory
import java.io.FileInputStream

fun processXmlStream(filePath: String) {
    val inputFactory = XMLInputFactory.newInstance()
    val xmlReader = inputFactory.createXMLStreamReader(FileInputStream(filePath))

    while (xmlReader.hasNext()) {
        when (xmlReader.next()) {
            javax.xml.stream.XMLStreamConstants.START_ELEMENT -> {
                // Kezdeti tag feldolgozása
            }
            javax.xml.stream.XMLStreamConstants.CHARACTERS -> {
                // Szöveg feldolgozása
            }
            // Egyéb események (END_ELEMENT, COMMENT stb.)
        }
    }
    xmlReader.close()
}

fun main() {
    // processXmlStream("example.xml")
}

A módszer kiválasztása az XML fájl méretétől, a struktúrában való navigáció szükségességétől, a teljesítménytől és a programozási stílustól (imperatív vs. deklaratív, könyvtárak használata) függ. Egyszerű esetekben elegendőek a szabványos Java API-k, összetettebb struktúrák vagy objektumhoz kötés esetén a kotlinx.serialization-xml vagy Jackson XML lehet előnyösebb.