處理網路 API 時,JSON 幾乎是標配格式。iOS 內建的 NSJSONSerialization 就能在「JSON 資料」與「Foundation 物件(陣列、字典等)」之間雙向轉換,不必再依賴第三方庫。
官方文件指出,能被轉換成 JSON 的物件必須符合下列條件:
以登入請求為例,先把參數放進字典,再轉成 JSON。字典的 key 就是 JSON 的 key,value 就是 JSON 的 value:
NSDictionary *registerDic = [NSDictionary dictionaryWithObjectsAndKeys:
uuid, @"_id",
userName, @"login_name",
password, @"password",
nil];
if ([NSJSONSerialization isValidJSONObject:registerDic]) {
NSError *error;
NSData *registerData = [NSJSONSerialization dataWithJSONObject:registerDic
options:NSJSONWritingPrettyPrinted
error:&error];
NSLog(@"Register JSON:%@", [[NSString alloc] initWithData:registerData encoding:NSUTF8StringEncoding]);
}
這裡有兩個重點:isValidJSONObject: 用來檢查這個 Foundation 物件能否合法轉成 JSON;dataWithJSONObject:options:error: 才是真正執行轉換。參數 NSJSONWritingPrettyPrinted 會把輸出的 JSON 格式化(含縮排與換行),可讀性高;若不設定,輸出的就是一整行沒換行的字串。
反過來,把收到的 JSON 資料還原成字典:
NSError *error;
NSDictionary *resultJSON = [NSJSONSerialization JSONObjectWithData:resultData
options:kNilOptions
error:&error];
接著就能用 key 取值,例如取出 status 欄位:
NSString *status = [resultJSON objectForKey:@"status"];
以上算是 NSJSONSerialization 的入門整理。實務上還可搭配 NSJSONReadingMutableContainers 等選項讓解析結果可變,或處理巢狀結構與型別轉換;若日後要處理更複雜的模型對應,也可考慮 Codable(Swift)或第三方模型庫。但對純 Objective-C 專案而言,NSJSONSerialization 已經能滿足絕大多數需求。