行動網路時代,App 既要和伺服器交換資料,也要彼此傳遞資料。承擔這份工作的,長期以來就是 XML 與 JSON 兩兄弟。理解它們各自的設計取向,才能在不同場景做出合理選擇。
XML(eXtensible Markup Language)的核心概念是「標記」——用電腦能解析的符號描述資訊結構。它從 SGML 簡化而來,允許你自行定義標籤,這就是「可擴充」的意思。
一句話概括:XML 是一種資料描述語言,本身不具備執行能力,必須由另一支程式來解析才有意義。
因此,XML 是獨立於軟硬體的資訊傳輸工具,在資料交換與描述領域無所不在。
XML 不是 HTML 的替代品,兩者目的不同:
還有個常被誤解的特點:XML 什麼都不做。它只是被結構化包裝的純資訊。
<note> <to>George</to> <from>John</from> <heading>Reminder</heading> <body>Don't forget the meeting!</body> </note>
這段便條自我描述得相當清楚,但它不會主動傳送、接收或顯示自己。要讓它發揮作用,仍然需要一支程式。此外,XML 本質上就是純文字,任何能處理純文字的軟體都能處理它。
規則簡單且邏輯清楚,主要有八條:
(1)所有元素都必須有結束標籤。HTML 允許 <p> 不閉合,XML 不行:
<p>This is a paragraph</p> <p>This is another paragraph</p>
(XML 宣告不是元素,所以不需要結束標籤。)
(2)標籤對大小寫敏感。<Message> 與 </message> 不成對,必須一致:
<message>這是正確的。</message>
(3)必須正確嵌套。HTML 常見的 <b><i>...</b></i> 在 XML 中非法:
<b><i>This text is bold and italic</i></b>
(4)必須有唯一的根元素:
<root>
<child>
<subchild>.....</subchild>
</child>
</root>
(5)屬性值必須加引號。<note date=08/08/2008> 錯誤,應寫成 <note date="08/08/2008">。
(6)實體引用。< 與 & 在 XML 中確實非法,必須轉義:
<message>if salary < 1000 then</message>
五個預定義實體:<(小於)、>(大於)、&(和號)、'(單引號)、"(引號)。嚴格說只有前兩者與 & 是必要的,但習慣性轉義 > 是好習慣。
(7)註解語法與 HTML 相同:
<!-- This is a comment -->
(8)空格會被保留。HTML 會把連續空格合併為一個,XML 不會刪節文件中的空格。換行符的儲存方式則依平台而異:Windows 用 CR + LF,Unix 用 LF,Macintosh 傳統上用 CR。
XML 解析器預設會解析文件中的所有文字,這類文字稱為 PCDATA(Parsed Character Data)。當元素內含子元素時,解析器會把它拆開:
<name><first>Bill</first><last>Gates</last></name>
但如果你的文字內容大量包含 < 或 &(例如 JavaScript 程式碼),就會引發錯誤。這時用 CDATA 區段包住,解析器會完全跳過其中的內容:
<script>
<![CDATA[
if (a < b && c > d) { alert("ok"); }
]]>
</script>
CDATA 由 <![CDATA[ 開始、]]> 結束。實際 API 回應中,常可見到把標題、導演、演員等欄位包在 CDATA 裡,避免特殊字元把文件弄壞。
XML 文件形成樹結構,從根元素出發向外擴展。父子、兄弟這些術語用來描述元素關係,每個元素都可以有文字內容與屬性。
要操作這棵樹,標準方式是 XML DOM(Document Object Model):它把文件視為樹,元素、文字與屬性都是節點,你可以透過它遍歷、修改、刪除或新增節點。DOM 中立於平台與語言,是 W3C 標準。
以一個影音搜尋 API 的回應為例,實務上的解析通常分四步:
Step 1:定位到目標節點。先讀取狀態碼確認請求成功,再用 selectNodes 取出感興趣的節點集合。
public ResultInfo onParser(Element rootElement) {
int resp = -1;
try {
resp = Integer.parseInt(selectNodeString(rootElement, "header/respcode"));
} catch (NumberFormatException e) {
e.printStackTrace();
}
if (resp != 0) return null;
ResultInfo searchResultInfo = new ResultInfo();
// 解析 weights
final List weights = rootElement.selectNodes(
rootElement.getPath() + "/" + "result/weights/weight");
ResultInfo[] resultFilterInfos = parseVideos(weights);
if (resultFilterInfos != null) {
ResultInfo weight = new ResultInfo();
weight.putResultInfoArray(ResultInfo.KEY_VIDEOS, resultFilterInfos);
searchResultInfo.putResultInfo(ResultInfo.KEY_WEIGHT, weight);
}
// 解析 albums
final List albums = rootElement.selectNodes(
rootElement.getPath() + "/" + "result/albums/album");
ResultInfo[] resultInfos = parseVideos(albums);
if (resultInfos != null) {
ResultInfo album = new ResultInfo();
album.putResultInfoArray(ResultInfo.KEY_VIDEOS, resultInfos);
searchResultInfo.putResultInfo(ResultInfo.KEY_SEARCH, album);
}
return searchResultInfo;
}
Step 2:遞迴下降到最小單元。從節點出發逐層往下,直到每個 Element。
private ResultInfo[] parseVideos(final List nodes) {
if (nodes != null && nodes.size() > 0) {
final ResultInfo[] vis = new ResultInfo[nodes.size()];
int i = 0;
for (Object o : nodes) {
if (o instanceof Element) {
vis[i] = parseVideo((Element) o);
}
i++;
}
return vis;
}
return null;
}
Step 3:把 Element 內容讀成欄位。
private ResultInfo parseVideo(final Element videoElement) {
final String id = videoElement.elementText("album_id");
final String title = videoElement.elementText("title");
final String imgUrl = videoElement.elementText("img180236");
final String duration = videoElement.elementText("duration");
final String mainactors = videoElement.elementText("mainactors");
// ...其餘欄位同理
ResultInfo vi = new ResultInfo();
vi.putString(VideoInfo.ID, id);
vi.putString(VideoInfo.TITLE, title);
vi.putString(VideoInfo.IMG_URL, imgUrl);
vi.putString(VideoInfo.DURATION, duration);
vi.putString(VideoInfo.MAINACTORS, mainactors);
return vi;
}
Step 4:攤平成清單物件,交給 Adapter 渲染。把逐層包裝的結構轉成一維的 ArrayList,再與列表元件綁定,畫面就能呈現出來。
JSON(JavaScript Object Notation)是一種輕量級的資料交換格式,易於人閱讀與撰寫,也易於機器解析與生成。它採用完全獨立於語言的文字格式,但語法習慣借自 C 家族(C、C++、C#、Java、JavaScript、Perl、Python 等),因此跨語言門檻極低。
(1)名/). 值 對的集合——在不同語言中被稱為物件、紀錄、結構、字典、雜湊表或關聯陣列。
(2)值的有序列表——多數語言稱為陣列、向量、列表或序列。
物件以 { 開始、} 結束,名稱後接冒號,成對之間以逗號分隔。陣列以 [ 開始、] 結束,值之間以逗號分隔。值可以是雙引號字串、數字、true、false、null、物件或陣列,且可任意嵌套。
{
"code": 1,
"data": 0,
"albumIdList": [
{ "totalidnum": 2000, "idlist": ["319281600"] }
],
"albumArray": {
"319281600": {
"_id": 319281600,
"_t": "末代獨裁",
"_img": "https://pic2.qiyipic.com/image/20141016/19/ca/v_108628048_m_601_m1_120_160.jpg",
"_ct": "2014-10-10 17:55:06",
"year": "2007",
"tag": "當代 美國 鄉村 大片",
"tvfcs": "雄心壯志背後的真相"
}
},
"before": "2~4~1~7~3",
"exp_ts": 120
}
相較於等價的 XML,JSON 少了大量結束標籤,同一份資訊的文字量明顯更小。要注意的是,未格式化的 JSON 原始字串幾乎無法閱讀,除錯時記得先美化。
以 Android 為例,相關類別都在 org.json 套件下:JSONObject、JSONArray、JSONStringer、JSONTokener、JSONWriter、JSONException。
get 與 opt 的選擇:建議使用 opt 系列,因為 get 在鍵不存在或內容為空時會直接拋出異常。不過 JsonArray.opt(index) 仍有越界問題要留意。
opt / optBoolean / optDouble / optInt / optLong / optString / optJSONArray / optJSONObject get / getBoolean / getDouble / getInt / getLong / getString / getJSONArray / getJSONObject
建立 JSON:
private String createJson() throws JSONException {
JSONObject jsonObject = new JSONObject();
jsonObject.put("intKey", 123);
jsonObject.put("doubleKey", 10.1);
jsonObject.put("stringKey", "lalala");
jsonObject.put("booleanKey", true);
JSONArray jsonArray = new JSONArray();
jsonArray.put(0, 111);
jsonArray.put("second");
jsonObject.put("arrayKey", jsonArray);
JSONObject inner = new JSONObject();
inner.put("innerStr", "inner");
jsonObject.put("innerObjectKey", inner);
return jsonObject.toString();
}
輸出:
{"intKey":123,"doubleKey":10.1,"stringKey":"lalala","booleanKey":true,"arrayKey":[111,"second"],"innerObjectKey":{"innerStr":"inner"}}
解析 JSON:流程是「發請求 → 取得 JSONObject → 逐層取出 → 轉成清單物件」。逐層取出的寫法相當直觀:
jsonObject = response.getJSONObject("response");
jsonArray = jsonObject.getJSONObject("result").getJSONArray("album");
再對每個元素取值:
for (int index = 0; index < albumJSONObject.length(); index++) {
VideoConstant video = new VideoConstant();
JSONObject item = albumJSONObject.getJSONObject(
albumIdJSONArrayList.get(index).toString());
video.mAlbumId = item.optString(InterfaceParameterName.ID);
video.mAtitle = item.optString(InterfaceParameterName.TITLE);
video.mDesc = item.optString(InterfaceParameterName.DESCRIPTION);
video.mImg = item.optString(InterfaceParameterName.IMG);
video.mDuration = item.optString(InterfaceParameterName.DURATION);
videos.add(video);
}
第三方解析庫:若不想用原生類別,可考慮 Jackson、google-gson、Json-lib。使用原生實作的好處是不必引入額外套件;引入第三方庫則通常能省下不少樣板程式碼。
一句話:JSON 比 XML 更小、更快、更易解析。
XML 的主要成分是元素、屬性與元素內容;JSON 則是物件、陣列、字串、數字、布林與 null。
用 XML 表示一個物件,一開始可能直覺地用屬性:
<student name="John" age="10"/>
但若某個值本身也是物件,屬性就寫不下去了,只能改用嵌套元素:
<student name="John" age="10">
<address>
<country>China</country>
<province>Guang Dong</province>
<city>...</city>
</address>
</student>
於是「什麼時候該用屬性、什麼時候該用元素」變成一個需要靠團隊約定解決的問題。JSON 因為有物件型別,可以自然映射:
{
"name": "John",
"age": 10,
"address": {
"country": "China",
"province": "Guang Dong",
"city": ".."
}
}
true/false/null 能對應到多數語言的相同語義XML 可以附上 DTD、Schema,還有一整套 XPath 之類的規範。透過自訂元素與屬性,能為資料附加約束條件與額外資訊。單看資料表達能力,XML 強於 JSON。
但問題是:很多場景並不需要這麼重的東西。如果完成某件事有簡單與複雜兩種方式,而簡單那種已經足夠,多數人會選簡單的。
選擇取決於場景:
今天的趨勢很明確:新的公開 API 幾乎清一色提供 JSON。但理解 XML 的規則與解析方式依然重要,因為大量既有系統仍在用它溝通。