Android XML数据解析

在 Android 开发中，XML 数据解析是处理网络请求返回的 XML 格式数据或本地 XML 文件的常见任务。尽管 JSON 更流行，但某些 API 或遗留系统仍使用 XML。Android 提供了多种方式解析 XML 数据，包括 SAX、DOM 和 XmlPullParser，每种方法有其特点和适用场景。以下是 Android XML 数据解析的详细学习指南，涵盖解析方法、代码示例、注意事项和实践建议。

一、XML 解析方法概述

Android 支持以下三种主要的 XML 解析方式：

SAX（Simple API for XML）：

特点：基于事件驱动的流式解析，逐行读取 XML，内存占用低。
优点：适合大型 XML 文件，高效且节省内存。
缺点：只读解析，不支持随机访问，代码复杂。
适用场景：处理大文件或只需要读取数据的场景。

DOM（Document Object Model）：

特点：将 XML 加载到内存中，构建树形结构，支持读写操作。
优点：支持随机访问和修改，适合复杂 XML 结构。
缺点：内存占用高，不适合大文件。
适用场景：小型 XML 文件或需要修改 XML 的场景。

XmlPullParser：

特点：Android 推荐的轻量级解析器，基于拉解析（Pull Parsing），逐个事件处理。
优点：内存占用低，灵活，支持读写，易于使用。
缺点：需要手动处理事件，代码稍复杂。
适用场景：Android 开发中最常用的 XML 解析方式，适合大多数场景。

二、准备工作

网络权限（如从网络获取 XML 数据）：
在 AndroidManifest.xml 中添加：

   <uses-permission android:name="android.permission.INTERNET" />
   <uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />

示例 XML 数据：
假设以下 XML 数据用于解析：

   <?xml version="1.0" encoding="UTF-8"?>
   <users>
       <user id="1">
           <name>Alice</name>
           <age>25</age>
       </user>
       <user id="2">
           <name>Bob</name>
           <age>30</age>
       </user>
   </users>

数据来源：

网络请求：通过 HttpURLConnection 或 OkHttp 获取 XML 数据。
本地文件：将 XML 文件放入 res/raw 或 assets 目录。
字符串：直接解析 XML 字符串。

三、XML 解析方法详解与代码示例

以下是使用 SAX、DOM 和 XmlPullParser 解析上述 XML 的代码示例。

1. SAX 解析

SAX 通过事件处理解析 XML，需自定义处理器继承 DefaultHandler。

步骤：

创建 SAXParser 和处理器。
定义事件处理逻辑（startElement、characters、endElement）。
解析输入流。

代码示例：

  import org.xml.sax.Attributes;
  import org.xml.sax.SAXException;
  import org.xml.sax.helpers.DefaultHandler;
  import javax.xml.parsers.SAXParser;
  import javax.xml.parsers.SAXParserFactory;
  import java.io.InputStream;

  public class SAXParserHandler extends DefaultHandler {
      private StringBuilder currentValue = new StringBuilder();
      private User currentUser;

      public static class User {
          String id, name, age;

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

      private List<User> users = new ArrayList<>();

      @Override
      public void startElement(String uri, String localName, String qName, Attributes attributes) {
          currentValue.setLength(0); // 清空缓冲区
          if (qName.equals("user")) {
              currentUser = new User();
              currentUser.id = attributes.getValue("id");
          }
      }

      @Override
      public void characters(char[] ch, int start, int length) {
          currentValue.append(ch, start, length); // 累积文本内容
      }

      @Override
      public void endElement(String uri, String localName, String qName) {
          if (qName.equals("name")) {
              currentUser.name = currentValue.toString().trim();
          } else if (qName.equals("age")) {
              currentUser.age = currentValue.toString().trim();
          } else if (qName.equals("user")) {
              users.add(currentUser);
          }
      }

      public List<User> getUsers() {
          return users;
      }

      // 解析方法
      public static List<User> parseXMLWithSAX(InputStream inputStream) throws Exception {
          SAXParserFactory factory = SAXParserFactory.newInstance();
          SAXParser parser = factory.newSAXParser();
          SAXParserHandler handler = new SAXParserHandler();
          parser.parse(inputStream, handler);
          return handler.getUsers();
      }
  }

使用示例（从网络获取 XML）：

  new Thread(() -> {
      try {
          URL url = new URL("https://api.example.com/users.xml");
          HttpURLConnection conn = (HttpURLConnection) url.openConnection();
          conn.setRequestMethod("GET");
          InputStream inputStream = conn.getInputStream();
          List<SAXParserHandler.User> users = SAXParserHandler.parseXMLWithSAX(inputStream);
          inputStream.close();
          conn.disconnect();
          // 在主线程更新 UI
          runOnUiThread(() -> {
              for (SAXParserHandler.User user : users) {
                  Log.d("SAX", user.toString());
              }
          });
      } catch (Exception e) {
          e.printStackTrace();
      }
  }).start();

2. DOM 解析

DOM 将 XML 加载到内存，构建树形结构，支持随机访问。

步骤：

创建 DocumentBuilder。
解析 XML 为 Document 对象。
遍历节点提取数据。

代码示例：

  import org.w3c.dom.Document;
  import org.w3c.dom.Element;
  import org.w3c.dom.NodeList;
  import javax.xml.parsers.DocumentBuilder;
  import javax.xml.parsers.DocumentBuilderFactory;
  import java.io.InputStream;
  import java.util.ArrayList;
  import java.util.List;

  public class DOMParser {
      public static class User {
          String id, name, age;

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

      public static List<User> parseXMLWithDOM(InputStream inputStream) throws Exception {
          List<User> users = new ArrayList<>();
          DocumentBuilderFactory factory = DocumentBuilderFactory.newInstance();
          DocumentBuilder builder = factory.newDocumentBuilder();
          Document document = builder.parse(inputStream);
          document.getDocumentElement().normalize();

          NodeList userNodes = document.getElementsByTagName("user");
          for (int i = 0; i < userNodes.getLength(); i++) {
              Element userElement = (Element) userNodes.item(i);
              User user = new User();
              user.id = userElement.getAttribute("id");
              user.name = userElement.getElementsByTagName("name").item(0).getTextContent();
              user.age = userElement.getElementsByTagName("age").item(0).getTextContent();
              users.add(user);
          }
          return users;
      }
  }

使用示例（从本地 assets 文件解析）：

  new Thread(() -> {
      try {
          InputStream inputStream = getAssets().open("users.xml");
          List<DOMParser.User> users = DOMParser.parseXMLWithDOM(inputStream);
          inputStream.close();
          runOnUiThread(() -> {
              for (DOMParser.User user : users) {
                  Log.d("DOM", user.toString());
              }
          });
      } catch (Exception e) {
          e.printStackTrace();
      }
  }).start();

3. XmlPullParser 解析

XmlPullParser 是 Android 推荐的轻量级解析器，基于事件驱动，类似于 SAX 但更灵活。

步骤：

创建 XmlPullParser 实例。
设置输入流，处理事件（START_TAG、TEXT、END_TAG）。
提取数据。

代码示例：

  import org.xmlpull.v1.XmlPullParser;
  import org.xmlpull.v1.XmlPullParserFactory;
  import java.io.InputStream;
  import java.util.ArrayList;
  import java.util.List;

  public class XmlPullParserHandler {
      public static class User {
          String id, name, age;

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

      public static List<User> parseXMLWithPull(InputStream inputStream) throws Exception {
          List<User> users = new ArrayList<>();
          User currentUser = null;

          XmlPullParserFactory factory = XmlPullParserFactory.newInstance();
          XmlPullParser parser = factory.newPullParser();
          parser.setInput(inputStream, "UTF-8");

          int eventType = parser.getEventType();
          while (eventType != XmlPullParser.END_DOCUMENT) {
              String tagName = parser.getName();
              switch (eventType) {
                  case XmlPullParser.START_TAG:
                      if ("user".equals(tagName)) {
                          currentUser = new User();
                          currentUser.id = parser.getAttributeValue(null, "id");
                      }
                      break;
                  case XmlPullParser.TEXT:
                      if (currentUser != null) {
                          if ("name".equals(tagName)) {
                              currentUser.name = parser.getText();
                          } else if ("age".equals(tagName)) {
                              currentUser.age = parser.getText();
                          }
                      }
                      break;
                  case XmlPullParser.END_TAG:
                      if ("user".equals(tagName) && currentUser != null) {
                          users.add(currentUser);
                          currentUser = null;
                      }
                      break;
              }
              eventType = parser.next();
          }
          return users;
      }
  }

使用示例（从网络获取 XML）：

  new Thread(() -> {
      try {
          URL url = new URL("https://api.example.com/users.xml");
          HttpURLConnection conn = (HttpURLConnection) url.openConnection();
          conn.setRequestMethod("GET");
          InputStream inputStream = conn.getInputStream();
          List<XmlPullParserHandler.User> users = XmlPullParserHandler.parseXMLWithPull(inputStream);
          inputStream.close();
          conn.disconnect();
          runOnUiThread(() -> {
              for (XmlPullParserHandler.User user : users) {
                  Log.d("XmlPull", user.toString());
              }
          });
      } catch (Exception e) {
          e.printStackTrace();
      }
  }).start();

四、结合 HttpURLConnection 获取 XML 数据

以下是使用 HttpURLConnection 获取 XML 数据并用 XmlPullParser 解析的完整示例：

public void fetchAndParseXML(String urlString) {
    new Thread(() -> {
        HttpURLConnection conn = null;
        try {
            // 1. 获取 XML 数据
            URL url = new URL(urlString);
            conn = (HttpURLConnection) url.openConnection();
            conn.setRequestMethod("GET");
            conn.setConnectTimeout(5000);
            conn.setReadTimeout(5000);
            conn.setRequestProperty("Accept", "application/xml");

            int responseCode = conn.getResponseCode();
            if (responseCode == HttpURLConnection.HTTP_OK) {
                InputStream inputStream = conn.getInputStream();
                // 2. 解析 XML
                List<XmlPullParserHandler.User> users = XmlPullParserHandler.parseXMLWithPull(inputStream);
                inputStream.close();
                // 3. 更新 UI
                runOnUiThread(() -> {
                    for (XmlPullParserHandler.User user : users) {
                        Log.d("XmlPull", user.toString());
                    }
                });
            } else {
                Log.e("Error", "Response Code: " + responseCode);
            }
        } catch (Exception e) {
            e.printStackTrace();
        } finally {
            if (conn != null) {
                conn.disconnect();
            }
        }
    }).start();
}

五、解析方法对比

解析方法	内存占用	速度	灵活性	适用场景
SAX	低	快	较低（只读）	大型 XML 文件，简单读取
DOM	高	慢	高（读写）	小型 XML 文件，需修改结构
XmlPullParser	低	快	中等	Android 推荐，通用场景

推荐：XmlPullParser 是 Android 开发的首选，平衡了性能和易用性。
选择依据：
大型 XML 文件：使用 SAX 或 XmlPullParser。
小型 XML 文件或需修改：使用 DOM。
Android 项目：优先 XmlPullParser。

六、注意事项

异步处理：

XML 解析通常与网络请求结合，必须在子线程执行，避免 NetworkOnMainThreadException。
使用 Thread、AsyncTask（已废弃）或 Kotlin 协程。

编码处理：

确保 XML 数据编码与解析器一致（如 UTF-8）。
设置 XmlPullParser.setInput(inputStream, "UTF-8")。

错误处理：

处理 IOException（网络错误）、XmlPullParserException（解析错误）。
检查 HTTP 状态码和 XML 格式是否正确。

资源释放：

关闭 InputStream 和 HttpURLConnection。
示例：
java inputStream.close(); conn.disconnect();

性能优化：

对于大型 XML，使用 SAX 或 XmlPullParser 避免内存溢出。
缓存解析结果，减少重复解析。

安全性：

验证 XML 数据来源，避免解析恶意 XML（XXE 攻击）。
使用 SAXParserFactory.setFeature 禁用外部实体：
java factory.setFeature("http://xml.org/sax/features/external-general-entities", false); factory.setFeature("http://xml.org/sax/features/external-parameter-entities", false);

七、学习建议与实践

学习路径：

了解 XML 结构（标签、属性、文本）。
学习 XmlPullParser 的基本使用（Android 推荐）。
尝试 SAX 和 DOM，理解其优缺点。
结合 HttpURLConnection 或 OkHttp 获取 XML 数据。
使用第三方库（如 Simple XML）简化复杂解析。

实践项目：

简单项目：解析 RSS 订阅（如新闻 RSS），显示标题和内容。
进阶项目：调用 XML 格式的公开 API（如某些 SOAP API），解析用户数据。
本地文件：将 XML 文件放入 res/raw 或 assets，练习解析。

调试工具：

使用 Postman 测试 XML API，验证响应。
使用 Charles 抓包，分析 XML 数据。
使用 Android Studio 的 Logcat 查看解析结果。

推荐资源：

Android 官方文档：https://developer.android.com/reference/org/xmlpull/v1/XmlPullParser
SAX 文档：https://docs.oracle.com/javase/7/docs/api/org/xml/sax/package-summary.html
DOM 文档：https://docs.oracle.com/javase/7/docs/api/javax/xml/parsers/DocumentBuilder.html
实践 API：RSS 订阅（如 https://www.nasa.gov/rss/dyn/breaking_news.rss）

八、Kotlin 协程示例

结合 Kotlin 协程，使 XML 解析更简洁：

suspend fun fetchAndParseXML(urlString: String): List<XmlPullParserHandler.User> = withContext(Dispatchers.IO) {
    val url = URL(urlString)
    val conn = url.openConnection() as HttpURLConnection
    try {
        conn.requestMethod = "GET"
        conn.setRequestProperty("Accept", "application/xml")
        if (conn.responseCode == HttpURLConnection.HTTP_OK) {
            val inputStream = conn.inputStream
            val users = XmlPullParserHandler.parseXMLWithPull(inputStream)
            inputStream.close()
            users
        } else {
            emptyList()
        }
    } finally {
        conn.disconnect()
    }
}

// 调用
lifecycleScope.launch {
    try {
        val users = fetchAndParseXML("https://api.example.com/users.xml")
        users.forEach { Log.d("XmlPull", it.toString()) }
    } catch (e: Exception) {
        e.printStackTrace()
    }
}

九、总结

解析方法：
SAX：事件驱动，适合大型 XML，内存高效。
DOM：树形结构，适合小型 XML，支持修改。
XmlPullParser：Android 推荐，平衡性能和灵活性。
结合网络：使用 HttpURLConnection 获取 XML 数据，异步解析。
注意事项：异步处理、资源释放、错误处理、编码一致。
推荐：优先使用 XmlPullParser，新项目考虑 JSON 替代 XML。
实践：调用 XML API 或解析本地文件，结合调试工具验证。

如果需要更详细的代码示例（如解析复杂 XML、处理 SOAP）、第三方库（如 Simple XML）介绍或特定场景的讲解，请告诉我！

一、XML 解析方法概述

二、准备工作

三、XML 解析方法详解与代码示例

1. SAX 解析

2. DOM 解析

3. XmlPullParser 解析

四、结合 HttpURLConnection 获取 XML 数据

五、解析方法对比

六、注意事项

七、学习建议与实践

八、Kotlin 协程示例

九、总结

Fragment实例精讲——新闻(购物)类App列表Fragment的简单实现

ViewFlipper(翻转视图)的基本使用

Intent的基本使用

Genymotion模拟器安装

Date & Time组件(下)

BroadcastReceiver庖丁解牛

发表回复取消回复

一、XML 解析方法概述

二、准备工作

三、XML 解析方法详解与代码示例

1. SAX 解析

2. DOM 解析

3. XmlPullParser 解析

四、结合 HttpURLConnection 获取 XML 数据

五、解析方法对比

六、注意事项

七、学习建议与实践

八、Kotlin 协程示例

九、总结

类似文章

发表回复 取消回复

发表回复取消回复