在Android开发场景中，XML是常用的数据存储和传输格式，比如本地配置文件、接口返回的XML数据都需要解析后使用。Kotlin作为Android首选开发语言，使用内置的XmlPullParser解析XML是高效且低内存的方案，它基于事件驱动模式，逐行读取XML内容，不会一次性加载整个文件到内存，非常适合移动端环境。
XmlPullParser解析原理
XmlPullParser的工作模式是事件驱动，解析器会按照XML文档的顺序依次触发不同的事件，开发者只需要监听对应的事件，在事件回调中处理对应的节点内容即可。常见的事件类型有以下几种：
- START_DOCUMENT：XML文档开始解析时触发
- START_TAG：遇到XML开始标签时触发，比如<user>
- TEXT：遇到标签内的文本内容时触发
- END_TAG：遇到XML结束标签时触发，比如</user>
- END_DOCUMENT：XML文档解析完成时触发
核心解析步骤
使用XmlPullParser解析XML的完整流程可以分为以下几个步骤：
- 获取XmlPullParser实例，Android中可以通过Xml.newPullParser()方法创建
- 设置解析器的输入源，可以是本地文件的输入流，也可以是网络请求返回的输入流
- 调用next()方法推进解析事件，根据返回的事件类型做对应处理
- 循环解析直到触发END_DOCUMENT事件，结束解析流程
完整代码示例
待解析的XML示例
假设我们需要解析如下结构的XML数据，存储了用户的基本信息：
<?xml version="1.0" encoding="utf-8"?>
<users>
<user>
<id>1</id>
<name>张三</name>
<age>25</age>
</user>
<user>
<id>2</id>
<name>李四</name>
<age>30</age>
</user>
</users>
定义数据实体类
首先定义对应的Kotlin数据类，用来存储解析后的用户数据：
data class User(
val id: Int,
val name: String,
val age: Int
)
解析XML的核心逻辑
下面是Kotlin实现的XmlPullParser解析逻辑，支持从输入流解析XML并返回用户列表：
import android.util.Xml
import org.xmlpull.v1.XmlPullParser
import org.xmlpull.v1.XmlPullParserException
import java.io.IOException
import java.io.InputStream
fun parseUsersXml(inputStream: InputStream): List<User> {
val users = mutableListOf<User>()
var currentUser: User? = null
var currentTagName: String? = null
try {
// 获取XmlPullParser实例
val parser: XmlPullParser = Xml.newPullParser()
// 设置输入源，指定编码为utf-8
parser.setInput(inputStream, "utf-8")
// 获取第一个事件类型
var eventType = parser.eventType
// 循环解析直到文档结束
while (eventType != XmlPullParser.END_DOCUMENT) {
when (eventType) {
// 遇到开始标签
XmlPullParser.START_TAG -> {
currentTagName = parser.name
if ("user" == currentTagName) {
// 遇到user标签，创建新的User对象
currentUser = User(0, "", 0)
}
}
// 遇到文本内容
XmlPullParser.TEXT -> {
val text = parser.text
currentUser?.let { user ->
when (currentTagName) {
"id" -> {
// 解析id字段
currentUser = user.copy(id = text.toInt())
}
"name" -> {
// 解析name字段
currentUser = user.copy(name = text)
}
"age" -> {
// 解析age字段
currentUser = user.copy(age = text.toInt())
}
}
}
}
// 遇到结束标签
XmlPullParser.END_TAG -> {
if ("user" == parser.name) {
// user标签结束，将当前用户添加到列表
currentUser?.let { users.add(it) }
currentUser = null
}
currentTagName = null
}
}
// 推进到下一个事件
eventType = parser.next()
}
} catch (e: XmlPullParserException) {
e.printStackTrace()
} catch (e: IOException) {
e.printStackTrace()
} finally {
try {
inputStream.close()
} catch (e: IOException) {
e.printStackTrace()
}
}
return users
}
调用方式示例
如果是解析本地assets目录下的xml文件，调用方式如下：
// 在Activity或Fragment中调用
fun loadLocalXml() {
try {
val inputStream = assets.open("users.xml")
val userList = parseUsersXml(inputStream)
// 处理解析后的用户列表
userList.forEach { user ->
println("用户id: ${user.id}, 姓名: ${user.name}, 年龄: ${user.age}")
}
} catch (e: IOException) {
e.printStackTrace()
}
}
常见问题与注意事项
- 设置输入源时一定要指定正确的编码，否则可能出现中文乱码问题
- 解析数字类型的节点内容时，需要做异常捕获，避免XML格式错误导致崩溃
- 输入流使用完成后一定要及时关闭，避免内存泄漏
- 如果XML结构嵌套较深，需要注意标签匹配逻辑，避免解析错乱
XmlPullParser是Android内置的解析工具，不需要额外引入依赖，适配性好，是Kotlin解析XML的首选方案，适合大多数常规XML解析场景。
KotlinXmlPullParserXML解析Android开发修改时间：2026-06-14 03:00:39