您现在的位置: IOS教程網 >> IOS系統 >  >> iOS 程式開發 >> iOS 開發綜合

iOS 透過 HTTP POST 上傳圖片:multipart/form-data 格式與實作

編輯:iOS 開發綜合

由於 iOS 沒有 HTML 表單機制,想上傳圖片就必須自己組裝 HTTP 請求,不能像網頁那樣靠 form 的 post 搞定。

請求格式規格

上傳圖片的 POST 請求本體長這樣:

Content-type: multipart/form-data, boundary=AaB03x
--AaB03x
content-disposition: form-data; name="field1"

Hello Boris!
--AaB03x
content-disposition: form-data; name="pic"; filename="boris.png"
Content-Type: image/png

... contents of boris.png ...
--AaB03x--

逐行拆解:

第一行指定請求的編碼方式為 multipart/form-data(上傳檔案必須使用這個),並以 boundary=AaB03x 宣告分隔線字串。之後每一段 --AaB03x 就是一個分隔線。

content-disposition: form-data; name="field1" 之後空一行,再寫上值 Hello Boris!。這裡的空行是規格要求,不可省略,相當於表單中的 <input name="field1" type="text" value="Hello Boris!" />。

不同欄位之間用分隔線隔開,分隔線必須獨立一行。

檔案欄位需要多兩行資訊:一是 filename="boris.png" 指定檔名,二是 Content-Type: image/png 指定檔案格式,之後才是檔案的位元內容,例如 <89504e47 0d0a1a0a ...>。

結尾的分隔線前後都要有 --,寫成 --AaB03x--,代表資料到此結束。

以上是 HTTP 的硬性規範,每一個空行、每一個空格都必須精確無誤。

iOS 實作

// 分隔線標識符
NSString *TWITTERFON_FORM_BOUNDARY = @"AaB03x";

// 依 url 初始化 request
NSMutableURLRequest *request = [NSMutableURLRequest requestWithURL:[NSURL URLWithString:url]
    cachePolicy:NSURLRequestReloadIgnoringLocalCacheData
    timeoutInterval:10];

// 分隔線 --AaB03x
NSString *MPboundary = [[NSString alloc] initWithFormat:@"--%@", TWITTERFON_FORM_BOUNDARY];
// 結束符 AaB03x--
NSString *endMPboundary = [[NSString alloc] initWithFormat:@"%@--", MPboundary];

// 取得要上傳的圖片並轉為資料
UIImage *image = [params objectForKey:@"pic"];
NSData *data = UIImagePNGRepresentation(image);

// 組裝 body 文字部分
NSMutableString *body = [[NSMutableString alloc] init];
NSArray *keys = [params allKeys];

for (int i = 0; i < [keys count]; i++) {
    NSString *key = [keys objectAtIndex:i];
    // 非 pic 欄位,value 為文字型別
    if (![key isEqualToString:@"pic"]) {
        [body appendFormat:@"%@\r\n", MPboundary];
        [body appendFormat:@"Content-Disposition: form-data; name=\"%@\"\r\n\r\n", key];
        [body appendFormat:@"%@\r\n", [params objectForKey:key]];
    }
}

// 檔案欄位的分隔線與標頭
[body appendFormat:@"%@\r\n", MPboundary];
[body appendFormat:@"Content-Disposition: form-data; name=\"pic\"; filename=\"boris.png\"\r\n"];
[body appendFormat:@"Content-Type: image/png\r\n\r\n"];

// 結束符
NSString *end = [[NSString alloc] initWithFormat:@"\r\n%@", endMPboundary];

// 組裝實際要送出的 body
NSMutableData *myRequestData = [NSMutableData data];
[myRequestData appendData:[body dataUsingEncoding:NSUTF8StringEncoding]];
[myRequestData appendData:data];
[myRequestData appendData:[end dataUsingEncoding:NSUTF8StringEncoding]];

// 設定 Content-Type
NSString *content = [[NSString alloc] initWithFormat:@"multipart/form-data; boundary=%@", TWITTERFON_FORM_BOUNDARY];
[request setValue:content forHTTPHeaderField:@"Content-Type"];

// 設定 Content-Length
[request setValue:[NSString stringWithFormat:@"%d", [myRequestData length]]
    forHTTPHeaderField:@"Content-Length"];

// 設定 body 與方法
[request setHTTPBody:myRequestData];
[request setHTTPMethod:@"POST"];

// 建立連線
NSURLConnection *conn = [[NSURLConnection alloc] initWithRequest:request delegate:self];
if (conn) {
    mResponseData = [[NSMutableData data] retain];
}

幾個實務提醒

1、換行符必須是 \r\n。只用 \n 在部分伺服器端會解析失敗。

2、boundary 字串要夠隨機。若剛好與圖片位元內容中的某段位元組相同,會導致資料被錯誤切分。實務上常用 UUID 產生。

3、不要把二進位圖片放進 NSString。範例中刻意先組字串、再 appendData 圖片資料,就是為了避免編碼問題;更好的做法是完全改用 NSMutableData 組裝全部內容。

4、正式專案建議改用 NSURLSession 或 AFNetworking 的 multipart 上傳介面,它們已處理好 boundary、進度回報與錯誤重試,不必自己拼字串。

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