Чӣ гуна кор бо XML дар Kotlin анҷом дода мешавад…

Коркаро бо XML дар Kotlin метавонад бо роҳҳои гуногун амалӣ карда шавад, вобаста ба вазифа ва афзалиятҳо:

API-ҳои стандартии Java: Kotlin пурра бо Java мувофиқ аст, бинобар ин метавон API-ҳои стандартии XML-и Java-ро истифода бурд:
- 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 тавсия мешавад).
Корутиниҳо ва Flow (барои коркарди асинхронӣ): Дар кор бо дархостҳои шабакавӣ, ки XML баргардонанд, метавон корутиниҳоро барои иҷрои парсинг дар пасзамана ва Flow барои коркарди пайдарпайии унсурҳо ё ҳодисаҳои XML истифода бурд.
Китобхонаҳои хориҷӣ: Маҳз китобхонаҳои хориҷӣ, ки роҳҳои қулайтар ё махсусгардонидашударо барои кор бо 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, ниёз ба навигатсия дар структура, иҷроиш ва услуби барномасозӣ (императивӣ ё декларативӣ, истифодаи китобхонаҳо). Барои ҳолатҳои содда, ки API-ҳои стандартии Java кофӣ мебошанд, барои структураҳои мураккаб ё пайвастшавӣ ба объектҳо, метавон истифодаи kotlinx.serialization-xml ё Jackson XML беҳтар аст.

Чӣ гуна кор бо XML дар Kotlin анҷом дода мешавад?