GET 只能把參數掛在網址後面,當要送出較長或較敏感的资料時,就必須改用 POST,把內容放進 request body。以下示範如何用 NSMutableURLRequest 組出一個 application/x-www-form-urlencoded 格式的 POST 請求。
整個流程可以拆成:把字串編碼成 NSData、組出目標 URL、建立 request 並設定方法與標頭、送出並接收回應。
// 1. 把 body 字串做 URL 編碼後轉成 NSData
NSData *bodyData = [[bodyString stringByAddingPercentEscapesUsingEncoding:NSUTF8StringEncoding]
dataUsingEncoding:NSUTF8StringEncoding];
// 2. 組出完整的服務器位址
NSURL *serverUrl = [[NSURL URLWithString:RequestUrl] URLByAppendingPathComponent:urlStr];
// 3. 建立 request,timeoutInterval 為 10 秒
NSMutableURLRequest *request = [NSMutableURLRequest requestWithURL:serverUrl
cachePolicy:NSURLRequestReloadIgnoringLocalCacheData
timeoutInterval:10];
// 4. 指定方法與內容
[request setHTTPMethod:@"POST"];
[request setHTTPBody:bodyData];
[request setValue:@"application/x-www-form-urlencoded" forHTTPHeaderField:@"content-type"];
// 5. 送出並取得回應
NSData *returnData = [NSURLConnection sendSynchronousRequest:request
returningResponse:nil
error:nil];
timeoutInterval:10 代表連線逾時設為 10 秒,超過就視為連線失敗。行動網路環境不穩,這個值可依實際情況調高。
cachePolicy 設為 NSURLRequestReloadIgnoringLocalCacheData,表示忽略本地快取、強制向伺服器要新資料,避免拿到過期內容。
伺服器回傳的編碼不一定相同。同一支 API 架在 Windows 環境可能回傳 GBK,架在 Ubuntu 上則多半是 UTF-8。若不先確認編碼就硬轉字串,中文很容易變成亂碼。實務上會先檢查回應標頭的 Content-Type,或直接與後端約定固定使用 UTF-8。
上面示範的 sendSynchronousRequest: 是同步呼叫,會阻塞目前執行緒,因此絕對不能放在主執行緒,否則 UI 會卡住甚至被系統判定為無回應而終止。若只是要簡單地避免卡住,可改用 sendAsynchronousRequest:queue:completionHandler:,把請求丟到背景佇列,回①應再切回主執行緒更新畫面。