把使用者選好的圖片送到伺服器,是幾乎每個 App 都會遇到的需求。早期常見的解法是 ASIHTTPRequest 系列的 ASIFormDataRequest,它用起來直覺、也方便設定成功與失敗的 callback。
首先把圖片從路徑讀成 UIImage,再轉成 NSData。iOS 提供兩種轉換方式:UnicodeJPEGRepresentation 與 UIImagePNGRepresentation,兩者取捨在於 PNG 保留透明通道但檔案較大,JPEG 體積小得多但不支援透明。頭像、照片類通常選 JPEG 並搭配壓縮品質參數。
NSString *path = ...; // 圖片檔案路徑
UIImage *im = [UIImage imageWithContentsOfFile:path];
NSData *data = UIImagePNGRepresentation(im);
// ASIFormDataRequest 的 setPostBody: 需要 NSMutableData
NSMutableData *imageData = [NSMutableData dataWithData:data];
NSURL *url = [NSURL URLWithString:@"伺服器位址"];
ASIFormDataRequest *aRequest = [[ASIFormDataRequest alloc] initWithURL:url];
[aRequest setDelegate:self];
[aRequest setRequestMethod:@"POST"];
[aRequest setPostBody:imageData];
[aRequest addRequestHeader:@"Content-Type" value:@"binary/octet-stream"];
// 設定成功與失敗要呼叫的方法
[aRequest setDidFinishSelector:@selector(headPortraitSuccess)];
[aRequest setDidFailSelector:@selector(headPortraitFail)];
[aRequest startAsynchronous];
Content-Type 要與後端一致。 這裡填 binary/octet-stream,代表以純二進位串流上傳;若後端採用 multipart/form-data,就必須改用 ASIFormDataRequest 的 setPostValue:forKey: 與 setFile:forKey:,並讓 Content-Type 由函式庫自行產生,否則邊界字串會對不上。
callback 的時機。 setDidFinishSelector: 與 setDidFailSelector: 指定的方法會在請求結束時自動觸發,記得在成功回呼裡才去更新 UI。
記憶體管理。 圖片資料往往不小,若使用 MRC,request 物件用完要 release;使用 ARC 則不需理會,但要注意不要把大型 NSData 長期留在屬性上。
最後提醒:ASIHTTPRequest 早已停止維護,新專案建議改用 NSURLSession 或 AFNetworking,並在 App Transport Security 規範下確保伺服器走 HTTPS。