Android 读取 XML 文件之 XmlPullParser 编码模板

一、XmlPullParser 概述

1. XmlPullParser 是 Android 平台上用于解析 XML 数据的一个接口，它提供了更高效的方式来读取 XML 文档

2. XmlPullParser 不会一次性将整个 XML 文档加载到内存中，而是采用流式读取的方式，即边读取边解析，这样可以大大减少对内存的使用，特别适合处理大型 XML 文件

---

二、XmlPullParser 基本使用

1、使用步骤

1. 获取解析器实例

XmlPullParser xmlPullParser = Xml.newPullParser();

2. 设置输入源并指定字符编码，这里设置为 null 表示使用默认的字符编码，通常是 UTF-8

InputStream inputStream = getResources().openRawResource(R.raw.users);

xmlPullParser.setInput(inputStream, null);

3. 获取事件类型

int eventType = xmlPullParser.getEventType();

• 每当解析器遇到 XML 文档中的一个重要部分时，它都会触发一个事件，我们通过检查事件类型来决定如何处理数据，有如下事件类型

int START_DOCUMENT = 0;
int END_DOCUMENT = 1;
int START_TAG = 2;
int END_TAG = 3;
int TEXT = 4;

事件	说明
START_DOCUMENT	表示文档开始
END_DOCUMENT	表示文档结束
START_TAG	表示开始标签
END_TAG	表示结束标签
TEXT	表示标签之间的文本内容

4. 移动到 XML 文档中的下一个元素，并返回新的事件类型

int next = xmlPullParser.next();

5. 获取标签的名称，该方法只有在 START_TAG 或 END_TAG 事件上调用时，才会返回标签的名称，否则返回 null

String name = xmlPullParser.getName();

6. 获取标签之间的文本内容

String text = xmlPullParser.getText();

2、演示

1. user.xml，准备好 XML 文件，该文件放置在 res/raw 目录下，这样，在 Activity 中可通过 getResources().openRawResource() 获取到该目录下的资源

<users>
    <user>
        <name>jack</name>
        <age>21</age>
    </user>
    <user>
        <name>tom</name>
        <age>22</age>
    </user>
</users>

2. 测试代码

InputStream inputStream = getResources().openRawResource(R.raw.users);

XmlPullParser xmlPullParser = Xml.newPullParser();
try {
    xmlPullParser.setInput(inputStream, null);

    Log.i(TAG, "------------------------------ 文档开始");
    Log.i(TAG, "--------------- " + xmlPullParser.getEventType());
    Log.i(TAG, "--------------- " + xmlPullParser.getName());
    Log.i(TAG, "--------------- " + xmlPullParser.getText());

    Log.i(TAG, "------------------------------ 到 users 开始标签");
    xmlPullParser.next();
    Log.i(TAG, "--------------- " + xmlPullParser.getEventType());
    Log.i(TAG, "--------------- " + xmlPullParser.getName());
    Log.i(TAG, "--------------- " + xmlPullParser.getText());

    Log.i(TAG, "------------------------------ 到 users 标签之间的文本内容");
    xmlPullParser.next();
    Log.i(TAG, "--------------- " + xmlPullParser.getEventType());
    Log.i(TAG, "--------------- " + xmlPullParser.getName());
    Log.i(TAG, "--------------- " + xmlPullParser.getText());

    Log.i(TAG, "------------------------------ 到 user 开始标签");
    xmlPullParser.next();
    Log.i(TAG, "--------------- " + xmlPullParser.getEventType());
    Log.i(TAG, "--------------- " + xmlPullParser.getName());
    Log.i(TAG, "--------------- " + xmlPullParser.getText());

    Log.i(TAG, "------------------------------ 到 user 标签之间的文本内容");
    xmlPullParser.next();
    Log.i(TAG, "--------------- " + xmlPullParser.getEventType());
    Log.i(TAG, "--------------- " + xmlPullParser.getName());
    Log.i(TAG, "--------------- " + xmlPullParser.getText());

    Log.i(TAG, "------------------------------ 到 name 开始标签");
    xmlPullParser.next();
    Log.i(TAG, "--------------- " + xmlPullParser.getEventType());
    Log.i(TAG, "--------------- " + xmlPullParser.getName());
    Log.i(TAG, "--------------- " + xmlPullParser.getText());

    Log.i(TAG, "------------------------------ 到 name 标签之间的文本内容");
    xmlPullParser.next();
    Log.i(TAG, "--------------- " + xmlPullParser.getEventType());
    Log.i(TAG, "--------------- " + xmlPullParser.getName());
    Log.i(TAG, "--------------- " + xmlPullParser.getText());

    Log.i(TAG, "------------------------------ 到 name 结束标签");
    xmlPullParser.next();
    Log.i(TAG, "--------------- " + xmlPullParser.getEventType());
    Log.i(TAG, "--------------- " + xmlPullParser.getName());
    Log.i(TAG, "--------------- " + xmlPullParser.getText());
} catch (XmlPullParserException | IOException e) {
    e.printStackTrace();
}

• 输出结果

  I/GetXmlActivity: ------------------------------ 文档开始
  I/GetXmlActivity: --------------- 0
  I/GetXmlActivity: --------------- null
  I/GetXmlActivity: --------------- null
  I/GetXmlActivity: ------------------------------ 到 users 开始标签
  I/GetXmlActivity: --------------- 2
  I/GetXmlActivity: --------------- users
  I/GetXmlActivity: --------------- null
  I/GetXmlActivity: ------------------------------ 到 users 标签之间的文本内容
  I/GetXmlActivity: --------------- 4
  I/GetXmlActivity: --------------- null
  I/GetXmlActivity: ---------------

  I/GetXmlActivity: ------------------------------ 到 user 开始标签
  I/GetXmlActivity: --------------- 2
  I/GetXmlActivity: --------------- user
  I/GetXmlActivity: --------------- null
  I/GetXmlActivity: ------------------------------ 到 user 标签之间的文本内容
  I/GetXmlActivity: --------------- 4
  I/GetXmlActivity: --------------- null
  I/GetXmlActivity: ---------------

  I/GetXmlActivity: ------------------------------ 到 name 开始标签
  I/GetXmlActivity: --------------- 2
  I/GetXmlActivity: --------------- name
  I/GetXmlActivity: --------------- null
  I/GetXmlActivity: ------------------------------ 到 name 标签之间的文本内容
  I/GetXmlActivity: --------------- 4
  I/GetXmlActivity: --------------- null
  I/GetXmlActivity: --------------- jack
  I/GetXmlActivity: ------------------------------ 到 name 结束标签
  I/GetXmlActivity: --------------- 3
  I/GetXmlActivity: --------------- name
  I/GetXmlActivity: --------------- null

3、演示优化

（1）优化思路

1. 对于 <name>jack</name>，我们只关注 name 标签之间的文本内容

2. 即当 xmlPullParser.getEventType() == XmlPullParser.START_TAG 以及 xmlPullParser.getName().equals("name") 时，我们已经到 name 开始标签

3. 这个时候再走一步，即可获取到 name 标签之间的文本内容，即 xmlPullParser.next() 之后 xmlPullParser.getText()

（2）具体实现

• 测试代码，这次我们只关注标签之间的文本

InputStream inputStream = getResources().openRawResource(R.raw.users);

XmlPullParser xmlPullParser = Xml.newPullParser();

try {
    xmlPullParser.setInput(inputStream, null);

    int eventType = xmlPullParser.getEventType();

    while (eventType != XmlPullParser.END_DOCUMENT) {
        if (eventType == XmlPullParser.START_TAG) {
            String name = xmlPullParser.getName();
            if (name.equals("name")) {
                xmlPullParser.next();
                String text = xmlPullParser.getText();
                Log.i(TAG, "--------------- name: " + text);
            } else if (name.equals("age")) {
                xmlPullParser.next();
                String text = xmlPullParser.getText();
                Log.i(TAG, "--------------- age: " + text);
            }

        }
        eventType = xmlPullParser.next();
    }
} catch (XmlPullParserException | IOException e) {
    e.printStackTrace();
}

• 输出结果

  I/GetXmlActivity: --------------- name: jack
  I/GetXmlActivity: --------------- age: 21
  I/GetXmlActivity: --------------- name: tom
  I/GetXmlActivity: --------------- age: 22

---

三、XmlPullParser 实例实操

1、案例引入

• 将如下的 XML 文件，希望将它解析成 2 个 User 对象，并放入 List<User> users 集合中

<users>
    <user>
        <name>jack</name>
        <age>21</age>
    </user>
    <user>
        <name>tom</name>
        <age>22</age>
    </user>
</users>

2、案例思路

1. 当 xmlPullParser.getEventType() == XmlPullParser.START_TAG 以及 xmlPullParser.getName().equals("user") 时，我们已经到 user 开始标签

2. 这个时候我们创建 User 对象

3. 当 xmlPullParser.getEventType() == XmlPullParser.START_TAG 以及 xmlPullParser.getName().equals("name") 时，我们已经到 name 开始标签

4. 这个时候我们再走一步，即可获取到 name 标签之间的文本内容并传递给 User 对象

5. 当 xmlPullParser.getEventType() == XmlPullParser.START_TAG 以及 xmlPullParser.getName().equals("age") 时，我们已经到 name 开始标签

6. 这个时候我们再走一步，即可获取到 age 标签之间的文本内容并传递给 User 对象

7. 当 xmlPullParser.getEventType() == XmlPullParser.END_TAG 以及 xmlPullParser.getName().equals("user") 时，我们已经到 user 结束标签

8. 这个时候我们把 User 对象放入 users 集合中

3、具体实现

（1）Entity

public class User {
    private String name;
    private Integer age;

    public User() {
    }

    public User(String name, Integer age) {
        this.name = name;
        this.age = age;
    }

    public String getName() {
        return name;
    }

    public void setName(String name) {
        this.name = name;
    }

    public Integer getAge() {
        return age;
    }

    public void setAge(Integer age) {
        this.age = age;
    }

    @Override
    public String toString() {
        return "User{" +
                "name='" + name + '\'' +
                ", age=" + age +
                '}';
    }
}

（2）Test Code

List<User> users = new ArrayList<>();
User user = null;

InputStream inputStream = getResources().openRawResource(R.raw.users);

XmlPullParser xmlPullParser = Xml.newPullParser();

try {
    xmlPullParser.setInput(inputStream, null);

    int eventType = xmlPullParser.getEventType();

    while (eventType != XmlPullParser.END_DOCUMENT) {
        if (eventType == XmlPullParser.START_TAG) {
            String name = xmlPullParser.getName();
            if (name.equals("user")) {
                user = new User();
            } else if (name.equals("name")) {
                xmlPullParser.next();
                String text = xmlPullParser.getText();
                user.setName(text);
            } else if (name.equals("age")) {
                xmlPullParser.next();
                String text = xmlPullParser.getText();
                try {
                    user.setAge(Integer.parseInt(text));
                } catch (NumberFormatException e) {
                    e.printStackTrace();
                }
            }

        } else if (eventType == XmlPullParser.END_TAG) {
            String name = xmlPullParser.getName();
            if (name.equals("user")) {
                users.add(user);
            }
        }
        eventType = xmlPullParser.next();
    }
} catch (XmlPullParserException | IOException e) {
    e.printStackTrace();
}

for (User u : users) {
    Log.i(TAG, "---------- " + u);
}

• 输出结果

  I/GetXmlActivity: ---------- User{name='jack', age=21}
  I/GetXmlActivity: ---------- User{name='tom', age=22}