在 iOS 開發中,從網路取得 JSON 資料是家常便飯。早期我們常借助 SBJSON 這類第三方開源庫,但自 iOS 5 起,蘋果提供了原生的 NSJSONSerialization,讓我們不必再依賴外部套件就能完成解析。本文以 Google 地理資訊 API 為例,帶你走一遍完整的解析流程。
解析 JSON 的核心類方法是:
+ (id)JSONObjectWithData:(NSData *)data options:(NSJSONReadingOptions)opt error:(NSError **)error
依資料結構的不同,可設定三種 option:
NSMutableString 實例。NSArray 或 NSDictionary(iOS 5.0 起可用)。Google 地理資訊 API 會依地點回傳經緯度等資訊,其 JSON 結果大致如下(節錄):
{
"results" : [
{
"address_components" : [ ... ],
"formatted_address" : "中國江蘇省南京市",
"geometry" : {
"location" : {
"lat" : 32.0602550,
"lng" : 118.7968770
},
...
},
"types" : [ "locality", "political" ]
}
],
"status" : "OK"
}
這是一個相當複雜的巢狀結構:JSON 裡含陣列,陣列裡又包含多層 JSON 資料。
整體思路是:先把 URL 轉碼為 UTF-8,建立 NSMutableURLRequest,再用 NSURLConnection 的 sendAsynchronousRequest 把回應資料放進 block 中分析。解析步驟如下:
第一步:依 JSON 結構先取得字典。
NSDictionary *resultsDic = [NSJSONSerialization JSONObjectWithData:data options:NSJSONReadingMutableContainers error:&error];
第二步:取出 key 為 results 的陣列。
NSArray *resultsArr = [resultsDic objectForKey:@"results"];
第三步:遍歷陣列,取出每筆的經緯度。
for (NSDictionary *resultDetailDic in resultsArr) {
NSDictionary *locationDic = [[resultDetailDic objectForKey:@"geometry"] objectForKey:@"location"];
NSString *lat = [locationDic objectForKey:@"lat"];
NSString *lng = [locationDic objectForKey:@"lng"];
dispatch_async(dispatch_get_main_queue(), ^{
NSLog(@"locationDic.lat 是--->%@", lat);
NSLog(@"locationDic.lng 是--->%@", lng);
});
}
第四步:遍歷結果中,每個元素都是一個字典,再從中取出 geometry 裡的 location。
第五步:從字典取出對應 key 的字串值,這就是我們最終要的資料。
如果你覺得這種寫法與資料結構綁得太緊、不夠「強壯」,可以加上 isKindOfClass 判斷來增加容錯性。
-(void)parseJson:(NSString *)addr {
// JSON 服務的 URL
NSString *_urlString = @"https://maps.googleapis.com/maps/api/geocode/json?address=nanjing&sensor=true";
NSString *_dataString = [[NSString alloc] initWithData:[_urlString dataUsingEncoding:NSASCIIStringEncoding allowLossyConversion:YES] encoding:NSASCIIStringEncoding];
NSURL *_url = [NSURL URLWithString:_dataString];
NSMutableURLRequest *_request = [NSMutableURLRequest requestWithURL:_url];
[_request setValue:@"application/json" forHTTPHeaderField:@"accept"];
[NSURLConnection sendAsynchronousRequest:_request
queue:[NSOperationQueue mainQueue]
completionHandler:^(NSURLResponse* response, NSData* data, NSError* error) {
NSHTTPURLResponse* httpResponse = (NSHTTPURLResponse*)response;
int responseStatusCode = [httpResponse statusCode];
NSLog(@"response status code is %d", responseStatusCode);
NSError *_errorJson = nil;
NSDictionary *resultsDic = [NSJSONSerialization JSONObjectWithData:data options:NSJSONReadingMutableContainers error:&error];
if (_errorJson != nil) {
NSLog(@"Error %@", [_errorJson localizedDescription]);
} else {
NSString *resultStatus = [resultsDic objectForKey:@"status"];
if ([resultStatus isEqualToString:@"OK"]) {
NSArray *resultsArr = [resultsDic objectForKey:@"results"];
for (NSDictionary *resultDetailDic in resultsArr) {
NSDictionary *locationDic = [[resultDetailDic objectForKey:@"geometry"] objectForKey:@"location"];
NSString *lat = [locationDic objectForKey:@"lat"];
NSString *lng = [locationDic objectForKey:@"lng"];
dispatch_async(dispatch_get_main_queue(), ^{
NSLog(@"locationDic.lat 是--->%@", lat);
NSLog(@"locationDic.lng 是--->%@", lng);
});
}
}
}
}];
}
透過這段程式碼,我們能實現非同步讀取與 JSON 解析,全程不必呼叫任何第三方程式碼,僅用蘋果原生功能即可完成。這樣做最大的好處,就是便於維護與升級。