您现在的位置: IOS教程網 >> IOS系統 >  >> iOS 使用技巧 >> iOS 7 技巧

iOS 圖片上傳功能實作:從基礎到封裝

編輯:iOS 7 技巧

幾乎每一款 App 都離不開圖片上傳,無論是更換頭像、上傳證件照,還是發布動態配圖。本文整理了兩種實作思路:一個是快速上手的最小範例,另一個則是可直接複用於專案的完整封裝類。

方法一:基于 AFNetworking 的簡潔上傳

這個範例展示了最直觀的上傳流程。首先在專案中打開手機相簿或相機,並遵循 <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 讓使用者選擇「拍照上傳」或「從相簿上傳」,選圖後先縮圖存檔,再呼叫工具類完成提交,就構成了一套完整的圖片上傳方案。相較於方法一,這種封裝方式更利於維護與跨頁面複用,是中型專案中值得採用的做法。

  1. 上一篇文章:
  2. 下一篇文章:
蘋果刷機越獄教程| IOS教程問題解答| IOS技巧綜合| IOS7技巧| IOS8教程
Copyright © IOS教程網 All Rights Reserved