幾乎每一款 App 都離不開圖片上傳,無論是更換頭像、上傳證件照,還是發布動態配圖。本文整理了兩種實作思路:一個是快速上手的最小範例,另一個則是可直接複用於專案的完整封裝類。
這個範例展示了最直觀的上傳流程。首先在專案中打開手機相簿或相機,並遵循 <UIImagePickerControllerDelegate, UINavigationControllerDelegate> 代理,在選圖完成的回呼方法裡進行上傳。
- (void)imagePickerController:(UIImagePickerController *)picker didFinishPickingMediaWithInfo:(NSDictionary<NSString *,id> *)info
{
UIImage *image = [info objectForKey:UIImagePickerControllerOriginalImage];
UIImageWriteToSavedPhotosAlbum(image, nil, nil, nil);
[self dismissViewControllerAnimated:YES completion:nil];
self.backBlackView.hidden = YES;
self.carmaChooeView.hidden = YES;
AFHTTPRequestOperationManager *manager = [[AFHTTPRequestOperationManager alloc] init];
manager.requestSerializer = [AFHTTPRequestSerializer serializer];
[manager.requestSerializer setValue:@"image/png/jpeg/jpg" forHTTPHeaderField:@"Content-Type"];
manager.requestSerializer = [AFJSONRequestSerializer serializer];
manager.responseSerializer.acceptableContentTypes = [NSSet setWithObjects:@"application/json", @"text/json", @"text/html", @"text/javascript", nil];
NSData *imageData = UIImageJPEGRepresentation(image, 0.5);
NSDictionary *parameter = nil; // 這裡可放入需要一起上傳的附加資訊,例如備註
AFHTTPRequestOperation *op = [manager POST:kBandCardURL parameters:parameter constructingBodyWithBlock:^(id<AFMultipartFormData> _Nonnull formData) {
[formData appendPartWithFileData:imageData name:@"bank_card_front" fileName:@"photo.jpg" mimeType:@"image/png/jpeg/jpg"];
} success:^(AFHTTPRequestOperation * _Nonnull operation, id _Nonnull responseObject) {
NSLog(@"Success : %@", [responseObject objectForKey:@"message"]);
} failure:^(AFHTTPRequestOperation * _Nullable operation, NSError * _Nonnull error) {
NSLog(@"Error : %@ *******%@", operation.responseString, error);
}];
[op start];
}
短短幾十行,就完成了一次 multipart 表單上傳。若你的需求比較單純,這個寫法綽綽有餘。
如果希望在多個頁面、多種場景中靈活呼叫,更好的做法是把上傳邏輯抽離出來,封裝成一個獨立類。下面這個 RequestPostUploadHelper 就是一個可傳入 URL、參數與圖片路徑的通用工具,同時附上縮圖、存檔與生成 GUID 等實用方法。
// RequestPostUploadHelper.h
#import <Foundation/Foundation.h>
@interface RequestPostUploadHelper : NSObject
/**
* POST 提交並可上傳圖片(目前僅支援單張)
*/
+ (NSString *)postRequestWithURL:(NSString *)url
postParems:(NSMutableDictionary *)postParems
picFilePath:(NSString *)picFilePath
picFileName:(NSString *)picFileName;
/** 縮放圖片尺寸 */
+ (UIImage *)imageWithImageSimple:(UIImage *)image scaledToSize:(CGSize)newSize;
/** 儲存圖片 */
+ (NSString *)saveImage:(UIImage *)tempImage WithName:(NSString *)imageName;
/** 生成 GUID */
+ (NSString *)generateUuidString;
@end
其 .m 實作核心在於手動拼接 multipart/form-data 的請求本體:先定義分隔符(boundary),遍歷參數字典把每個鍵值組寫入 body,再把圖片的二進位資料與結尾標記拼接起來,最後設定 Content-Type、Content-Length 並以 POST 送出。
NSString *TWITTERFON_FORM_BOUNDARY = @"0xKhTmLbOuNdArY";
NSMutableURLRequest *request = [NSMutableURLRequest requestWithURL:[NSURL URLWithString:url]
cachePolicy:NSURLRequestReloadIgnoringLocalCacheData
timeoutInterval:10];
// 分界線與結束符
NSString *MPboundary = [[NSString alloc] initWithFormat:@"--%@", TWITTERFON_FORM_BOUNDARY];
NSString *endMPboundary = [[NSString alloc] initWithFormat:@"%@--", MPboundary];
// 取得圖片資料,自動判斷 png 或 jpeg
NSData *data;
if (picFilePath) {
UIImage *image = [UIImage imageWithContentsOfFile:picFilePath];
if (UIImagePNGRepresentation(image)) {
data = UIImagePNGRepresentation(image);
} else {
data = UIImageJPEGRepresentation(image, 1.0);
}
}
// 遍歷參數字典,逐個拼接欄位
NSMutableString *body = [[NSMutableString alloc] init];
NSArray *keys = [postParems allKeys];
for (int i = 0; i < [keys count]; i++) {
NSString *key = [keys objectAtIndex:i];
[body appendFormat:@"%@\r\n", MPboundary];
[body appendFormat:@"Content-Disposition: form-data; name=\"%@\"\r\n\r\n", key];
[body appendFormat:@"%@\r\n", [postParems objectForKey:key]];
}
// 拼接圖片欄位
if (picFilePath) {
[body appendFormat:@"%@\r\n", MPboundary];
[body appendFormat:@"Content-Disposition: form-data; name=\"file\"; filename=\"%@\"\r\n", picFileName];
[body appendFormat:@"Content-Type: image/jpeg\r\n\r\n"];
}
NSString *end = [[NSString alloc] initWithFormat:@"\r\n%@", endMPboundary];
NSMutableData *myRequestData = [NSMutableData data];
[myRequestData appendData:[body dataUsingEncoding:NSUTF8StringEncoding]];
if (picFilePath) {
[myRequestData appendData:data];
}
[myRequestData appendData:[end dataUsingEncoding:NSUTF8StringEncoding]];
// 設定請求標頭與本體
NSString *content = [[NSString alloc] initWithFormat:@"multipart/form-data; boundary=%@", TWITTERFON_FORM_BOUNDARY];
[request setValue:content forHTTPHeaderField:@"Content-Type"];
[request setValue:[NSString stringWithFormat:@"%d", [myRequestData length]] forHTTPHeaderField:@"Content-Length"];
[request setHTTPBody:myRequestData];
[request setHTTPMethod:@"POST"];
// 同步送出請求
NSHTTPURLResponse *urlResponse = nil;
NSError *error = [[NSError alloc] init];
NSData *resultData = [NSURLConnection sendSynchronousRequest:request returningResponse:&urlResponse error:&error];
NSString *result = [[NSString alloc] initWithData:resultData encoding:NSUTF8StringEncoding];
if ([urlResponse statusCode] >= 200 && [urlResponse statusCode] < 300) {
NSLog(@"返回結果=====%@", result);
return result;
}
return nil;
類中另外提供了兩個實用方法:imageWithImageSimple:scaledToSize: 透過 UIGraphicsBeginImageContext 按比例縮放圖片,適合在上傳前先降低解析度以節省流量;saveImage:WithName: 則把圖片寫入 Documents 目錄並回傳完整路徑;generateUuidString 借助 CFUUIDCreate 產生唯一識別碼,常用於避免檔名衝突。
搭配一個 UploadViewController,透過 UIActionSheet 讓使用者選擇「拍照上傳」或「從相簿上傳」,選圖後先縮圖存檔,再呼叫工具類完成提交,就構成了一套完整的圖片上傳方案。相較於方法一,這種封裝方式更利於維護與跨頁面複用,是中型專案中值得採用的做法。