Как се работи с XML в Kotlin?

Работата с XML в Kotlin може да се извършва по няколко начина, в зависимост от задачата и предпочитанията:

1. Стандартни Java API: Kotlin е напълно съвместим с Java, затова може да се използват стандартните Java XML API:

   • javax.xml.parsers.DocumentBuilderFactory и org.w3c.dom.Document за DOM парсинг (удобно за навигация по структурата).
   • javax.xml.stream.XMLInputFactory и javax.xml.stream.events.XMLEvent или javax.xml.stream.XMLStreamReader за StAX парсинг (събитийно, по-ефективно за големи файлове).
   • javax.xml.transform.TransformerFactory за трансформация на XML (XSLT).
   • javax.xml.bind.JAXBContext за JAXB (връзване на XML към Java обекти, въпреки че в съвременния Kotlin често предпочитани са kotlinx.serialization или Moshi с плъгин за XML).

2. Корутини и Flow (за асинхронна обработка): При работа с мрежови заявки, връщащи XML, може да се използват корутини за изпълнение на парсинга във фонов поток и Flow за обработка на последователност от елементи или събития на XML.

3. Външни библиотеки: Съществуват много външни библиотеки, които предоставят по-удобни или специализирани начини за работа с XML в Kotlin:

   • Kotlinx.serialization-xml: Експериментален плъгин за kotlinx.serialization, позволяващ сериализация/десериализация на Kotlin обекти към XML.
   • Moshi: Въпреки че е основно за JSON, има разширения или адаптери за работа с XML.
   • Simple XML Serialization: Популярна Java библиотека, която може да се използва и в Kotlin.
   • Jackson XML: Част от библиотеката Jackson, с поддръжка за сериализация/десериализация на Java/Kotlin обекти към XML.

Пример за DOM парсинг:

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")
    // Дальнейшая работа с DOM дървото
    // println("Root element :" + doc.documentElement.nodeName)
}

Пример за StAX парсинг (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 -> {
                // Обработка на началния таг
            }
            javax.xml.stream.XMLStreamConstants.CHARACTERS -> {
                // Обработка на текстовото съдържание
            }
            // Други събития (END_ELEMENT, COMMENT и др.)
        }
    }
    xmlReader.close()
}

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

Изборът на метод зависи от размера на XML файла, необходимостта от навигация по структурата му, производителността и стила на програмиране (императивен срещу декларативен, използване на библиотеки). За прости случаи достатъчни са стандартните Java API, за сложни структури или binding към обекти може да са по-подходящи kotlinx.serialization-xml или Jackson XML.