Kotlin怎么解析XML文件 XmlPullParser使用方法

在Android开发场景中，XML文件常被用来存储配置信息、接口返回数据等内容，Kotlin作为主流开发语言，需要配合XmlPullParser完成XML解析工作。XmlPullParser是基于事件驱动的解析器，不需要一次性加载整个XML文件到内存，适合处理大文件或移动端资源有限的环境。

XmlPullParser核心工作原理

XmlPullParser通过触发不同的事件来通知解析进度，常见的事件类型有三种：

• START_DOCUMENT：解析开始时的事件
• START_TAG：遇到XML开始标签时触发
• END_TAG：遇到XML结束标签时触发
• TEXT：遇到标签之间的文本内容时触发
• END_DOCUMENT：解析结束时的事件

解析过程就是循环获取这些事件，根据不同事件类型做对应的处理逻辑。

基础解析步骤

1. 准备XML测试数据

我们先准备一个简单的本地XML文件，放在Android项目的assets目录下，文件名为test.xml，内容如下：

<?xml version="1.0" encoding="utf-8"?>
<users>
    <user id="1">
        <name>张三</name>
        <age>25</age>
    </user>
    <user id="2">
        <name>李四</name>
        <age>28</age>
    </user>
</users>

2. 初始化XmlPullParser

首先需要获取XML文件的输入流，然后初始化解析器实例，Kotlin中可以通过以下步骤完成：

import android.util.Xml
import org.xmlpull.v1.XmlPullParser
import java.io.InputStream

fun initParser(inputStream: InputStream): XmlPullParser {
    val parser = Xml.newPullParser()
    // 设置输入流和编码格式
    parser.setInput(inputStream, "utf-8")
    return parser
}

3. 完整解析逻辑实现

接下来编写解析的核心逻辑，循环获取事件类型，根据不同事件处理对应内容：

import org.xmlpull.v1.XmlPullParser
import java.io.InputStream

data class User(val id: String, val name: String, val age: String)

fun parseXml(inputStream: InputStream): List<User> {
    val userList = mutableListOf<User>()
    var currentUser: User? = null
    var currentTagName = ""
    
    val parser = initParser(inputStream)
    // 获取第一个事件类型
    var eventType = parser.eventType
    
    while (eventType != XmlPullParser.END_DOCUMENT) {
        when (eventType) {
            XmlPullParser.START_TAG -> {
                currentTagName = parser.name
                if (currentTagName == "user") {
                    // 获取user标签的id属性
                    val id = parser.getAttributeValue(null, "id")
                    currentUser = User(id, "", "")
                }
            }
            XmlPullParser.TEXT -> {
                // 处理标签内的文本内容
                val text = parser.text.trim()
                if (text.isNotEmpty() && currentUser != null) {
                    when (currentTagName) {
                        "name" -> currentUser = currentUser!!.copy(name = text)
                        "age" -> currentUser = currentUser!!.copy(age = text)
                    }
                }
            }
            XmlPullParser.END_TAG -> {
                if (parser.name == "user" && currentUser != null) {
                    userList.add(currentUser!!)
                    currentUser = null
                }
                currentTagName = ""
            }
        }
        // 获取下一个事件
        eventType = parser.next()
    }
    inputStream.close()
    return userList
}

4. 调用解析方法

在Activity中调用上述方法，读取assets目录下的XML文件并解析：

import android.content.Context
import java.io.IOException

fun readAndParseXml(context: Context) {
    try {
        val inputStream = context.assets.open("test.xml")
        val userList = parseXml(inputStream)
        // 打印解析结果
        userList.forEach { user ->
            println("用户ID：${user.id}，姓名：${user.name}，年龄：${user.age}")
        }
    } catch (e: IOException) {
        e.printStackTrace()
    }
}

常见问题与注意事项

• 解析前需要确认输入流的编码和XML文件声明的编码一致，否则可能出现乱码
• 处理TEXT事件时，需要先过滤掉空白字符，避免把换行、缩进当成有效内容
• 如果XML文件存在命名空间，需要使用getAttributeValue方法时传入对应的命名空间参数
• 解析完成后要及时关闭输入流，避免内存泄漏

XmlPullParser优势总结

相比DOM解析，XmlPullParser不需要加载整个XML到内存，适合移动端场景；相比SAX解析，它的接口更简洁，不需要额外实现监听器，代码逻辑更清晰。在Kotlin中使用XmlPullParser可以高效完成各类XML解析需求，是Android开发中处理XML的首选方案。

KotlinXmlPullParserXML解析Android开发修改时间：2026-06-18 05:27:38