行動裝置上傳圖片是很常見的需求,例如更換頭像。下面以 ASIHTTPRequest 系列中的 ASIFormDataRequest 為例,說明從取得圖片到送出請求的完整環節。
iOS 中把 UIImage 轉為二進位資料有兩種常用方式:UIImagePNGRepresentation 與 UIImageJPEGRepresentation。前者保留透明通道、無失真,但檔案體積明顯較大;後者為有損壓縮,可以透過壓縮品質參數控制大小。頭像這類照片型內容,通常選 JPEG 更合適;若需要透明背景,才用 PNG。
UIImage *image = [UIImage imageWithContentsOfFile:path]; NSData *data = UIImagePNGRepresentation(image); NSMutableData *body = [NSMutableData dataWithData:data];
這裡多包一層 NSMutableData,是因為 setPostBody: 只接受 NSMutableData 型別。
NSURL *url = [NSURL URLWithString:@"伺服器位址"]; ASIFormDataRequest *request = [[ASIFormDataRequest alloc] initWithURL:url]; [request setDelegate:self]; [request setRequestMethod:@"POST"]; [request setPostBody:body]; [request addRequestHeader:@"Content-Type" value:@"binary/octet-stream"]; [request setDidFinishSelector:@selector(uploadSucceeded)]; [request setDidFailSelector:@selector(uploadFailed)]; [request startAsynchronous];
幾個容易忽略的細節:
Content-Type 必須與後端約定一致。 如果伺服器端按照 raw binary 串流接收,這裡就寫 binary/octet-stream;若後端其實期待的是 multipart/form-data 表單上傳,那麼應該改用 setFile:fileName:contentType:dataName: 之類的 API,由函式庫自動產生 boundary,而不是自己塞 post body。兩者混用是新手最常踩的坑。
非同步與回呼。 startAsynchronous 會立刻返回,結果透過 delegate 或 selector 回來。記得在成功與失敗的兩個方法裡都處理 UI 狀態,例如隱藏 loading 指示器。
ASIHTTPRequest 早已停止維護,新專案建議改用 NSURLSession 搭配 NSURLSessionUploadTask,或用 Alamofire 這類成熟套件。若使用 NSURLSession,可以用 multipartFormDataAppendPartWithFileURL: 一類的 API 直接組多段表單,省下手工拼 body 的麻煩,也更容易處理大檔與進度回報。
NSData *data = UIImageJPEGRepresentation(image, 0.8);
NSURLSession *session = [NSURLSession sharedSession];
NSMutableURLRequest *req = [NSMutableURLRequest requestWithURL:url];
[req setHTTPMethod:@"POST"];
[req setValue:@"binary/octet-stream" forHTTPHeaderField:@"Content-Type"];
NSURLSessionUploadTask *task =
[session uploadTaskWithRequest:req fromData:data
completionHandler:^(NSData *resp, NSURLResponse *r, NSError *e) {
NSLog(@"完成,回應長度 %lu", (unsigned long)resp.length);
}];
[task resume];
掌握「取得圖片 → 轉為資料 → 依後端契約設定 Content-Type → 非同步送出 → 處理回呼」這五個步驟,換成任何一套網路函式庫都能快速遷移。