由於 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 的硬性規範,每一個空行、每一個空格都必須精確無誤。
// 分隔線標識符
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、進度回報與錯誤重試,不必自己拼字串。