XML (Extensible Markup Language) 是結構化資料交換標準,規則:標籤成對、正確巢狀、區分大小寫。Android 常用於網路傳輸、檔案儲存、SharedPreferences 內部格式。
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("'", "'");
}
⚠️ **缺點**:易漏轉義、巢狀層次深時難維護、效能差 (大量字串複製)。
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();
}
}
| 方法 | 說明 |
|---|---|
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 區塊 (不轉義) |
Damon0
18600000000
beijing0
Damon1
18600000001
beijing1
...
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;
}
XmlSerializer 本身即流式,記憶體佔用恆定。getExternalFilesDir(null) (應用專屬、免權限、隨應用卸載刪除) 或 getCacheDir() (臨時)。