JSON(JavaScript Object Notation)是一種輕量級的資料交換格式,它既便於人閱讀撰寫,也便於機器解析與生成。作為 JavaScript 語言(ECMA-262 第三版子集)的產物,JSON 採用完全獨立於語言的純文字格式,卻沿用了 C 語言家族的書寫習慣,因此 C、C++、C#、Java、Perl、Python 等語言都能輕鬆接納。正因如此,JSON 成為跨平台資料交換的理想選擇。
在 Web 領域,JSON 的表現可圈可點。XML 立意雖好,卻顯得冗長、解析繁瑣;而 JSON 作為 JavaScript 的原生描述語言,幾乎不必手動解析,交給 JavaScript 的 eval 就能得到結果。PHP 5.2 以後更內建了 JSON 解析函式,一行就能把 PHP 物件轉成 JSON,無論速度還是便利性都遠勝 XML。
那麼在 C 與 C++ 中該如何讀取 JSON 呢?其實解析並不難,真正的門檻在於「讀取」與型別處理。目前市面上的 JSON 解析庫多如過江之鯉,除非是商業專案有特別考量,否則大可不必自己造輪子。筆者陸續試過 JsonCpp、QJson、Json-Spirit、jaula 等 C++ 庫,卻各遇到不同麻煩:有的不支援中文(即便使用 UTF-8 編碼亦然),有的在 Windows 下編譯不便,有的體積過於臃腫。最後我選擇了 C 語言編寫的 json-c,因為它在相容性與中文支援(UTF-8)方面表現最為出色。
json-c 的編譯不算輕鬆,需要用到 configure 與 GCC,這就意味著你必須準備 MSYS 或 Cygwin 以便使用 Bash,同時 MinGW 也必不可少,因為要用到 GCC 與 Make。Windows 使用者若需要編譯,建議自行搜尋並安裝最基礎的 MSYS 或 Cygwin 環境。
若要在 C++ 中使用 C 編寫的庫,標頭檔必須做特殊處理。由於 C 編譯器與 C++ 編譯器產生的中間碼符號命名規則不一致,若不妥善處理,最終在連結階段必然會出現「找不到符號」的錯誤。解決之道是使用 extern "C" 包裹標頭檔:
#include <QString>
#include <QList>
#include <QMap>
extern "C" {
#include <stdio.h>
#include <stdlib.h>
#include <json.h>
#include <json_object.h>
#include <json_tokener.h>
}
// 1) 解析陣列
char *json_string = "[ 10, 20, \"nice\" ]";
struct json_object *obj, *temp_obj;
QList<QVariant> data;
obj = json_tokener_parse(json_string); /* 此時 obj 是一個 Array */
for (int i = 0; i < json_object_array_length(obj); i++) {
temp_obj = json_object_array_get_idx(obj, i); /* 取得陣列第 i 個元素 */
switch (json_object_get_type(temp_obj)) { /* 判斷型別 */
case json_type_string: /* 若是字串 */
data.append(json_object_get_string(temp_obj));
break;
case json_type_int: /* 若是整數 */
data.append(json_object_get_int(temp_obj));
break;
default: /* 其餘型別暫不處理 */
break;
}
}
// 2) 解析物件
char *json_string = "{ \"one\": \"good\", \"two\": 2 }";
struct json_object *obj, *temp_obj;
QMap<QString, QVariant> data;
obj = json_tokener_parse(json_string);
json_object_object_foreach(obj, key, value) { // key 與 value 由巨集自行宣告
switch (json_object_get_type(value)) {
case json_type_string: /* 若是字串 */
data.insert(key, json_object_get_string(value));
break;
case json_type_int: /* 若是整數 */
data.insert(key, json_object_get_int(value));
break;
default: /* 其餘型別暫不處理 */
break;
}
}
上述範例直接將解析結果導向 QVariant,最大的遺憾是尚未加入錯誤處理。實務上建議參考 json-c 的官方文件補上完整的錯誤判斷,讓程式在遇到格式異常時能更穩健地應對。