在 NSJSONSerialization 普及之前,SBJson 是 iOS 上最常見的 JSON 工具。以下是把它導入專案並完成序列化的基本步驟。
從官方 repository 取得 json-framework:https://github.com/stig/json-framework/
解壓後,把 class 資料夾下的所有檔案拖進目前的專案。SBJson 是純 Objective-C 原始碼,不需要 framework 搜尋路徑設定。
#import "SBJson.h"
把符合 key/value 結構的 NSDictionary 或 NSArray 轉成 JSON 字串:
NSString *jsonStr = [items JSONRepresentation];
反向操作則用 parser 把字串還原成物件:
SBJsonParser *parser = [[SBJsonParser alloc] init]; id result = [parser objectWithString:jsonStr]; // 回傳 NSDictionary 或 NSArray
objectWithString: 的傳回值型別是 id,實務上應先確認解析成功(失敗時回傳 nil)再轉型,否則後續取值容易出問題。NSJSONSerialization,不必再引入第三方庫:// 序列化 NSData *data = [NSJSONSerialization dataWithJSONObject:dict options:0 error:&error]; NSString *jsonStr = [[NSString alloc] initWithData:data encoding:NSUTF8StringEncoding]; // 反序列化 id obj = [NSJSONSerialization JSONObjectWithData:data options:0 error:&error];
兩者API 風格相近,若原本用 SBJson,遷移成本很低。