萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> Android 開發

Android XML 序列化完整指南:字串拼接 vs XmlSerializer 兩種方案實戰

XML 基礎知識

XML (Extensible Markup Language) 是結構化資料交換標準,規則:標籤成對、正確巢狀、區分大小寫。Android 常用於網路傳輸、檔案儲存、SharedPreferences 內部格式。

方案一:字串拼接 (StringBuilder) —— 簡單但易錯

private void backupContactsV1(List contacts) {
    StringBuilder sb = new StringBuilder();
    sb.append("");
    sb.append("");
    for (Contact c : contacts) {
        if (c == null) continue;
        sb.append("");
        sb.append("").append(escapeXml(c.getName())).append("");
        sb.append("").append(escapeXml(c.getNumber())).append("");
        sb.append("
").append(escapeXml(c.getAddress())).append("
"); sb.append("
"); } sb.append("
"); writeToFile(sb.toString(), "backup1.xml"); } /** 必須手動轉義特殊字元,否則 XML 解析失敗 */ private String escapeXml(String s) { return s.replace("&", "&") .replace("<", "<") .replace(">", ">") .replace("\"", """) .replace("'", "'"); }

⚠️ **缺點**:易漏轉義、巢狀層次深時難維護、效能差 (大量字串複製)。

方案二:XmlSerializer (官方推薦) —— 安全、高效、標準

private void backupContactsV2(List contacts) {
    File file = new File(getExternalFilesDir(null), "backup2.xml");
    try (FileOutputStream fos = new FileOutputStream(file)) {
        XmlSerializer serializer = Xml.newSerializer();
        serializer.setOutput(fos, "utf-8");
        serializer.startDocument("utf-8", true); // standalone=true

        serializer.startTag(null, "contacts");
        for (Contact c : contacts) {
            if (c == null) continue;
            serializer.startTag(null, "contact");
            serializer.attribute(null, "id", String.valueOf(c.getId()));

            serializer.startTag(null, "name");
            serializer.text(c.getName()); // 自動轉義
            serializer.endTag(null, "name");

            serializer.startTag(null, "number");
            serializer.text(c.getNumber());
            serializer.endTag(null, "number");

            serializer.startTag(null, "address");
            serializer.text(c.getAddress());
            serializer.endTag(null, "address");

            serializer.endTag(null, "contact");
        }
        serializer.endTag(null, "contacts");
        serializer.endDocument();
        // fos 自動關閉 (try-with-resources)
        Toast.makeText(this, "備份成功", Toast.LENGTH_SHORT).show();
    } catch (Exception e) {
        Log.e("XmlBackup", "寫入失敗", e);
        Toast.makeText(this, "備份失敗", Toast.LENGTH_SHORT).show();
    }
}

XmlSerializer 核心 API 速查

方法說明
setOutput(OutputStream, encoding)設定輸出流與編碼
startDocument(encoding, standalone)寫入 XML 宣告
endDocument()結束文檔,刷新緩衝區
startTag(ns, name)開始標籤,ns 通常傳 null
endTag(ns, name)結束標籤,必須與 startTag 配對
text(String)寫入文字內容,**自動轉義** < > & 等
attribute(ns, name, value)為**當前開啟的標籤**添加屬性
cdsect(String)寫入 CDATA 區塊 (不轉義)

生成結果對比 (兩種方式產出相同 XML)



  
    Damon0
    18600000000
    
beijing0
Damon1 18600000001
beijing1
...

讀取 XML (XmlPullParser)

private List parseContacts(InputStream is) throws XmlPullParserException, IOException {
    XmlPullParser parser = Xml.newPullParser();
    parser.setInput(is, "utf-8");
    List list = new ArrayList<>();
    int eventType = parser.getEventType();
    Contact current = null;
    while (eventType != XmlPullParser.END_DOCUMENT) {
        switch (eventType) {
            case XmlPullParser.START_TAG:
                if ("contact".equals(parser.getName())) {
                    current = new Contact();
                    current.setId(Integer.parseInt(parser.getAttributeValue(null, "id")));
                } else if (current != null) {
                    String tag = parser.getName();
                    String text = parser.nextText();
                    switch (tag) {
                        case "name": current.setName(text); break;
                        case "number": current.setNumber(text); break;
                        case "address": current.setAddress(text); break;
                    }
                }
                break;
            case XmlPullParser.END_TAG:
                if ("contact".equals(parser.getName()) && current != null) {
                    list.add(current);
                    current = null;
                }
                break;
        }
        eventType = parser.next();
    }
    return list;
}

最佳實踐建議

  1. 優先使用 XmlSerializer:避免手動轉義錯誤,代碼更清晰。
  2. 大量資料採用流式寫入:XmlSerializer 本身即流式,記憶體佔用恆定。
  3. 複雜物件圖:考慮 Jackson XML、Simple XML 等序列化框架 (需注意 Android 相容性與體積)。
  4. 儲存位置:getExternalFilesDir(null) (應用專屬、免權限、隨應用卸載刪除) 或 getCacheDir() (臨時)。
copyright © 萬盛學電腦網 all rights reserved