Kotlin中常用XmlPullParser解析XML,它是Android官方推荐的轻量级事件驱动解析器,内存小、速度快;需注意权限配置、编码匹配、空白处理及流关闭。

Kotlin 中解析 XML 文件常用 XmlPullParser,它是 Android 官方推荐的轻量级、事件驱动式 XML 解析器,内存占用小、解析速度快,特别适合移动端处理中小型 XML 数据。
添加权限(仅限从网络或外部存储读取时)
如果 XML 来自网络或 SD 卡,需确保已申请对应权限:
- 网络:在
AndroidManifest.xml中添加 - 外部存储(Android 10+ 推荐用
Scoped Storage):如需读取本地文件,注意适配运行时权限和存储访问框架
初始化 XmlPullParser 并设置输入源
使用 XmlPullParserFactory 创建解析器实例,并传入 InputStream(如 assets 下的文件、网络响应流或本地文件流):
val factory = XmlPullParserFactory.newInstance()
factory.isNamespaceAware = false // 一般可设为 false,除非 XML 含命名空间
val parser = factory.newPullParser()
// 示例:解析 assets/xml/data.xml
val inputStream = context.assets.open("xml/data.xml")
parser.setFeature(XmlPullParser.FEATURE_PROCESS_NAMESPACES, false)
parser.setInput(inputStream, "UTF-8")
⚠️ 注意:setInput() 第二个参数是字符编码,务必与 XML 声明一致(如 ),否则可能乱码或抛异常。
循环解析,按事件类型处理节点
XmlPullParser 是事件驱动的,通过 next() 或 nextToken() 获取下一个事件,常见事件类型有:
-
XmlPullParser.START_TAG:遇到开始标签(如) -
XmlPullParser.END_TAG:遇到结束标签(如) -
XmlPullParser.TEXT:遇到标签内文本内容(注意前后可能含空白) -
XmlPullParser.END_DOCUMENT:解析完成
典型解析逻辑如下(以解析用户列表为例):
val users = mutableListOf() var currentUser: User? = null while (parser.next() != XmlPullParser.END_DOCUMENT) { when (parser.eventType) { XmlPullParser.START_TAG -> { when (parser.name) { "user" -> currentUser = User() "name" -> if (currentUser != null) { parser.next() // 移动到 TEXT 事件 currentUser.name = parser.text.trim() } "age" -> if (currentUser != null) { parser.next() currentUser.age = parser.text.toIntOrNull() ?: 0 } } } XmlPullParser.END_TAG -> { if (parser.name == "user" && currentUser != null) { users.add(currentUser) currentUser = null } } } }
? 小技巧:对简单字段(如 ),先判断 START_TAG,再调用 next() 跳到内部文本;避免在 TEXT 事件中盲目取值——因为换行/缩进也会触发 TEXT 事件。
关闭流并异常处理
务必在 finally 块中关闭输入流,防止资源泄漏:
var inputStream: InputStream? = null
try {
inputStream = context.assets.open("xml/data.xml")
parser.setInput(inputStream, "UTF-8")
// ... 解析逻辑
} catch (e: XmlPullParserException) {
Log.e("XML", "解析异常", e)
} catch (e: IOException) {
Log.e("XML", "IO异常", e)
} finally {
inputStream?.close()
}
也可用 Kotlin 的 use 语句自动关闭:
context.assets.open("xml/data.xml").use { stream ->
parser.setInput(stream, "UTF-8")
// 解析...
}
基本上就这些。XmlPullParser 写法直接、可控性强,适合结构清晰的 XML;若 XML 嵌套深或需 XPath 查询,可考虑 DocumentBuilder(DOM)或第三方库如 Simple XML 或 klaxon(配合 JSON 更多)。不复杂但容易忽略编码和空格处理,写的时候留个心眼就行。










