Android 中通过 Pull 解析方式创建 XML 文件

在 Android 开发中，XML 文件常用于存储配置信息、数据交换等场景。除了使用 DOM、SAX 解析 XML 之外，Pull 解析也是 Android 原生支持的轻量级解析方式，同时我们也可以通过 Pull 相关的 API 反向生成 XML 文件。本文将介绍如何在 Android 中通过 Pull 解析器创建 XML 文件，包含完整的实现步骤和代码示例。

准备工作

Android 系统已经内置了 Pull 解析相关的类，位于 org.xmlpull.v1 包下，因此不需要额外引入第三方依赖。我们需要用到的核心类包括：

• XmlPullParserFactory：用于创建 Pull 解析器工厂和序列化器
• XmlSerializer：XML 序列化器，负责将数据结构转换为 XML 格式内容

实现步骤

通过 Pull 创建 XML 文件的整体流程可以分为以下几步：

1. 获取 XML 序列化器实例
2. 设置序列化器的输出目标（比如输出到文件流、字符串构建器）
3. 按照 XML 结构依次写入文档声明、标签、属性、文本内容
4. 结束文档写入，完成 XML 生成

完整代码示例

以下示例演示了在 Android 中创建一个包含学生信息的 XML 文件，最终将 XML 内容保存到应用的内部存储目录中。

import android.content.Context;
import org.xmlpull.v1.XmlPullParserFactory;
import org.xmlpull.v1.XmlSerializer;
import java.io.FileOutputStream;
import java.io.StringWriter;

public class XmlPullCreator {
    /**
     * 创建学生信息XML文件并保存到内部存储
     * @param context 上下文对象，用于获取内部存储路径
     * @param fileName 要保存的XML文件名
     * @return 生成的XML字符串，方便调试查看
     */
    public static String createStudentXml(Context context, String fileName) {
        StringWriter stringWriter = new StringWriter();
        FileOutputStream fos = null;
        try {
            // 1. 获取XmlPullParserFactory实例
            XmlPullParserFactory factory = XmlPullParserFactory.newInstance();
            // 设置支持命名空间
            factory.setNamespaceAware(true);
            // 2. 获取XmlSerializer序列化器
            XmlSerializer serializer = factory.newSerializer();
            
            // 先输出到字符串构建器，方便返回查看内容
            serializer.setOutput(stringWriter);
            // 同时输出到文件流，保存到本地
            fos = context.openFileOutput(fileName, Context.MODE_PRIVATE);
            serializer.setOutput(fos, "UTF-8");
            
            // 3. 开始写入XML内容
            // 写入文档声明，encoding为UTF-8，standalone为yes
            serializer.startDocument("UTF-8", true);
            // 写入根标签 <students>
            serializer.startTag(null, "students");
            
            // 第一个学生信息
            serializer.startTag(null, "student");
            // 设置student标签的id属性
            serializer.attribute(null, "id", "1001");
            
            // 子标签<name>
            serializer.startTag(null, "name");
            serializer.text("张三");
            serializer.endTag(null, "name");
            
            // 子标签<age>
            serializer.startTag(null, "age");
            serializer.text("20");
            serializer.endTag(null, "age");
            
            // 子标签<major>
            serializer.startTag(null, "major");
            serializer.text("计算机科学与技术");
            serializer.endTag(null, "major");
            
            serializer.endTag(null, "student");
            
            // 第二个学生信息
            serializer.startTag(null, "student");
            serializer.attribute(null, "id", "1002");
            
            serializer.startTag(null, "name");
            serializer.text("李四");
            serializer.endTag(null, "name");
            
            serializer.startTag(null, "age");
            serializer.text("21");
            serializer.endTag(null, "age");
            
            serializer.startTag(null, "major");
            serializer.text("软件工程");
            serializer.endTag(null, "major");
            
            serializer.endTag(null, "student");
            
            // 结束根标签
            serializer.endTag(null, "students");
            // 结束文档
            serializer.endDocument();
            
            // 刷新输出流
            fos.flush();
            return stringWriter.toString();
        } catch (Exception e) {
            e.printStackTrace();
            return null;
        } finally {
            try {
                if (fos != null) {
                    fos.close();
                }
            } catch (Exception e) {
                e.printStackTrace();
            }
        }
    }
}

调用上述方法后，生成的 XML 文件内容结构如下：

<?xml version='1.0' encoding='UTF-8' standalone='yes' ?>
<students>
  <student id="1001">
    <name>张三</name>
    <age>20</age>
    <major>计算机科学与技术</major>
  </student>
  <student id="1002">
    <name>李四</name>
    <age>21</age>
    <major>软件工程</major>
  </student>
</students>

代码说明

上述代码中，我们首先通过 XmlPullParserFactory.newInstance() 获取工厂实例，再调用 newSerializer() 得到 XML 序列化器。序列化器的 setOutput 方法可以设置输出目标，示例中同时设置了字符串写入器和文件输出流，既方便返回生成的 XML 字符串用于调试，也能直接将内容保存到本地文件。

写入 XML 内容时，需要严格遵循标签的嵌套规则：先调用 startTag 开始一个标签，写入内容后调用 endTag 结束该标签，属性通过 attribute 方法在 startTag 之后、标签内容之前设置。文本内容通过 text 方法写入，最后调用 endDocument 结束整个 XML 文档的写入。

注意事项

• 如果不需要同时输出到字符串和文件，可以只设置一个输出目标，避免不必要的资源占用
• 写入文件时需要处理权限问题，如果是保存到内部存储，不需要额外申请存储权限；如果保存到外部存储，需要动态申请读写权限
• 生成的 XML 文件编码建议统一使用 UTF-8，避免中文乱码问题
• 所有流操作都需要放在 try-catch 块中，并且在 finally 中关闭流，防止资源泄漏

AndroidPull解析XmlSerializerXML生成数据存储 本作品最后修改时间：2026-05-22 21:23:53