JSON(JavaScript Object Notation)是儲存與交換文字資訊的語法格式,概念上類似 XML,但體積更小、解析更快。所謂輕量,指的是描述相同資料所需的字元數遠少於 XML。
簡單說,JSON 由兩種資料型別組成:陣列與字典。
JSON 語法是 JavaScript 語法的子集,但對 iOS 開發而言不需深入研究 JavaScript。
(1)基本規則
(2)名稱/值對
相當於 iOS 中的字典,也就是映射表;但 JSON 的「名稱」必須是字串。格式為:名稱置於雙引號中,接一個冒號,然後是值。
"firstName": "John"
(3)值的型別

圖 1
(4)物件
物件寫在大括號中,可包含多組「名稱/值」對,本質上是無序的鍵值集合。

圖 2
{ "firstName": "John", "lastName": "Doe" }(5)陣列
陣列寫在中括號中,可包含多個物件,本質上是值的有序集合。

圖 3
{
"employees": [
{ "firstName": "John", "lastName": "Doe" },
{ "firstName": "Anna", "lastName": "Smith" },
{ "firstName": "Peter", "lastName": "Jones" }
]
}上例中,employees 是一個包含三個物件的陣列,每個物件代表一筆員工紀錄。
依效能由低到高分列:
這個類別的用法相當簡便,設計思路是透過一個「中介物件」與 JSON 資料互相轉換。中介可以是 NSData,也可以是串流。
2.2.1 以 NSData 為中介
NSData 能直接與檔案互動,因此最常這樣用:

注意:還原出來的物件型別取決於 JSON 最外層的符號——大括號對應字典,中括號對應陣列。
以如下的 Notes.json 為例:
{
"ResultCode": 110,
"Record": 112
}解析為字典後再反向編碼回檔案:
- (void)viewDidLoad {
[super viewDidLoad];
NSString *path = [[NSBundle mainBundle] pathForResource:@"Notes" ofType:@"json"];
NSData *jsonData = [[NSData alloc] initWithContentsOfFile:path];
// 反序列化:NSData → 物件(此例最外層為大括號,故得字典)
id jsonObj = [NSJSONSerialization JSONObjectWithData:jsonData options:0 error:nil];
NSLog(@"%@", [jsonObj objectForKey:@"ResultCode"]);
// 序列化:物件 → NSData
NSData *outData = [NSJSONSerialization dataWithJSONObject:jsonObj options:0 error:nil];
[outData writeToFile:@"/Users/tengfei/Desktop/s.json" atomically:YES];
}2.2.2 以串流為中介
串流方式分別用兩個類別處理:解析時用 NSInputStream,編碼時用 NSOutputStream。

兩者的建立方式:
| 類別 | 建立方法 |
| NSInputStream | + inputStreamWithData: |
| + inputStreamWithFileAtPath: | |
| + inputStreamWithURL: | |
| - initWithData: | |
| - initWithFileAtPath: | |
| - initWithURL: | |
| NSOutputStream | + outputStreamToMemory |
| + outputStreamToFileAtPath:append: | |
| + outputStreamWithURL:append: | |
| - initToMemory | |
| - initToFileAtPath:append: | |
| - initWithURL:append: |
完整範例:
- (void)testJsonWithStream {
NSString *path = [[NSBundle mainBundle] pathForResource:@"Notes" ofType:@"json"];
// 建立輸入串流並開啟
NSInputStream *inputStream = [[NSInputStream alloc] initWithFileAtPath:path];
[inputStream open];
id jsonObj = [NSJSONSerialization JSONObjectWithStream:inputStream
options:NSJSONReadingMutableLeaves
error:nil];
NSLog(@"%@", [jsonObj objectForKey:@"ResultCode"]);
// 建立輸出串流並開啟
NSOutputStream *outputStream =
[[NSOutputStream alloc] initToFileAtPath:@"/Users/tengfei/Desktop/s.json" append:YES];
[outputStream open];
[NSJSONSerialization writeJSONObject:jsonObj
toStream:outputStream
options:0
error:nil];
[inputStream close];
[outputStream close];
}兩種方式該怎麼選?小檔案用 NSData 最省事;處理大型 JSON(例如幾十 MB 的匯出檔)時,串流方式不必一次把整份資料讀進記憶體,明顯佔優勢。另外提醒,實務上傳入的 error 參數不該一律丟 nil——JSON 格式錯誤時若沒有接收 NSError,除錯會非常痛苦。