在 iOS 早期開發裡,直接動用官方 SDK 的網路請求 API 是一件相當折磨人的事:步驟繁瑣、細節瑣碎。ASIHTTPRequest 正是為了解決這個痛點而生——它把底層的 CFNetwork 封裝成一套 Objective-C 編寫的簡潔介面,同時兼顧 Mac OS X 與 iOS 兩個平台。無論是普通的 HTTP 請求,還是與 REST 風格服務的資料交換,它都能勝任。
NSDictionary *user = [[NSDictionary alloc] initWithObjectsAndKeys:@"0", @"Version", nil];
if ([NSJSONSerialization isValidJSONObject:user]) {
NSError *error;
NSData *jsonData = [NSJSONSerialization dataWithJSONObject:user options:NSJSONWritingPrettyPrinted error:&error];
NSMutableData *tempJsonData = [NSMutableData dataWithData:jsonData];
//NSLog(@"Register JSON:%@",[[NSString alloc] initWithData:tempJsonData encoding:NSUTF8StringEncoding]);
NSURL *url = [NSURL URLWithString:@"https://42.96.140.61/lev_version.php"];
ASIHTTPRequest *request = [ASIHTTPRequest requestWithURL:url];
[request addRequestHeader:@"Content-Type" value:@"application/json; encoding=utf-8"];
[request addRequestHeader:@"Accept" value:@"application/json"];
[request setRequestMethod:@"POST"];
[request setPostBody:tempJsonData];
[request startSynchronous];
NSError *error1 = [request error];
if (!error1) {
NSString *response = [request responseString];
NSLog(@"Test:%@",response);
}
}
1. 準備要上傳的資料
NSDictionary *user = [[NSDictionary alloc] initWithObjectsAndKeys:@"0", @"Version", nil];
這裡先組出一個最簡單的字典物件。從 iOS 5 起,系統就內建了 NSDictionary 轉 JSON 的能力,不必再依賴第三方庫。
2. 先驗證,再序列化
緊接著的 if 判斷用來確認這個字典是否符合 JSON 物件的基本規則,避免把不合法的結構丟給序列化方法。
NSData *jsonData = [NSJSONSerialization dataWithJSONObject:user options:NSJSONWritingPrettyPrinted error:&error];
這一行才是真正的轉換動作,結果以 NSData 的形式裝在 jsonData 裡,並以縮排格式輸出,方便閱讀與除錯。
3. 換成可變資料
NSMutableData *tempJsonData = [NSMutableData dataWithData:jsonData];
之所以要多這一步,是因為後續交給 ASIHTTPRequest 當作請求本文的資料,必須是 NSMutableData 型別。
4. 需要時打開這行日誌
//NSLog(@"Register JSON:%@",[[NSString alloc] initWithData:tempJsonData encoding:NSUTF8StringEncoding]);
把二進位資料還原成 UTF-8 字串印出來,就能核對序列化結果是否與預期一致。
NSURL *url = [NSURL URLWithString:@"https://xxxx"]; ASIHTTPRequest *request = [ASIHTTPRequest requestWithURL:url];
這兩句指定要溝通的伺服器位址,並據此建立請求物件。
[request addRequestHeader:@"Content-Type" value:@"application/json; encoding=utf-8"]; [request addRequestHeader:@"Accept" value:@"application/json"];
接著補上 HTTP 標頭:明確告知伺服器本文是 JSON、編碼為 UTF-8,同時表明用戶端也希望收到 JSON 回應。
[request setRequestMethod:@"POST"]; [request setPostBody:tempJsonData];
再指定請求方法(不特別設定的話預設是 GET)並掛上請求本文。
[request startSynchronous];
一切就緒,啟動同步請求。實務上建議改用非同步方式,以免阻塞主線程、拖住介面流暢度。
if (!error1) {
NSString *response = [request responseString];
NSLog(@"Rev:%@",response);
}
最後一段沒有錯誤時,就把伺服器回傳的內容取出來檢視。
整套流程走一遍,你會發現「組字典 → 轉 JSON → 設標頭 → 設方法與本文 → 發送 → 讀回應」就是絕大多數 JSON 上傳場景的固定套路。