multipart/from-data是一種進(jìn)行表單提交時(shí)的消息格式乒省。表單提交數(shù)據(jù)的時(shí)候邻悬,默認(rèn)類型是application/x-www-form-urlencoded损合,也就是key=value的鍵值對格式亚再,提交文件的時(shí)候使用multipart/from-data。因?yàn)槭潜韱翁峤霍镏簦詇ttp請求方式是POST。然后在請求頭里設(shè)置Content-Type為multipart/from-data指定請求的格式黔姜。
NSURL *URL = [[NSURL alloc]initWithString:urlString];
request = [[NSMutableURLRequest alloc]initWithURL:URL cachePolicy:(NSURLRequestUseProtocolCachePolicy) timeoutInterval:30];
request.HTTPMethod = @"POST";
NSString *boundary = @"wfWiEWrgEFA9A78512weF7106A";
request.allHTTPHeaderFields = @{
@"Content-Type":[NSString stringWithFormat:@"multipart/form-data; boundary=%@",boundary]
};
注意到在Content-Type里還有個(gè)boundary,顧名思義拢切,這個(gè)東西是用來做分隔的字符串。boundary本身沒有特殊要求秆吵,只要不會(huì)和其他內(nèi)容混淆就好淮椰,所以盡量復(fù)雜些。
3.POST請求纳寂,參數(shù)都放在請求體里面主穗,而請求體是這里的關(guān)鍵,multipart/form-data就是一種格式毙芜,約定請求體的數(shù)據(jù)如何存放忽媒。放個(gè)例子先:
--wfWiEWrgEFA9A78512weF7106A //部分1
Content-Disposition: form-data; name="status" //部分2
哈哈哈 //部分3
--wfWiEWrgEFA9A78512weF7106A
Content-Disposition: form-data; name="source"
2582981980
--wfWiEWrgEFA9A78512weF7106A
Content-Disposition: form-data; name="access_token"
2.00nVEJoBgbvnoCc54e19c4c4NksmWC
--wfWiEWrgEFA9A78512weF7106A
Content-Disposition: form-data; name="pic"; filename="卡車.png"
Content-Type=image/png
...這里是文件的二進(jìn)制數(shù)據(jù)... //部分4
--wfWiEWrgEFA9A78512weF7106A-- //部分5
上面的“//部分X”是注釋哈。
(1)部分1是“--”+boundary腋粥,即雙減號加分隔符晦雨,然后換行,注意換行是使用“\r\n”隘冲,因?yàn)檫@些標(biāo)準(zhǔn)開始都是在html中使用的闹瞧。測試了微博接口,換行也不能出錯(cuò)展辞。
(2)部分2的格式是:Content-Disposition: form-data; name="xxx"奥邮,這里的xxx是接口的參數(shù),比如微博測試接口有一個(gè)參數(shù)是“status”罗珍,那status寫在這里洽腺。然后是兩個(gè)換行,即“\r\n\r\n”靡砌。
(3)有key就有value,上面說了key的位置已脓,這里就是value的位置⊥ㄑ辏“status”字段代表的是微博的正文內(nèi)容度液,所以就把微博正文內(nèi)容放在部分3位置,即“哈哈哈”画舌。然后換行堕担。
(4)然后就是部分1、2曲聂、3這個(gè)結(jié)構(gòu)重復(fù)霹购,每一個(gè)重復(fù)結(jié)構(gòu)對應(yīng)著接口里的一個(gè)字段的數(shù)據(jù)。直到你要上傳的文件朋腋,部分4齐疙。部分4這一節(jié)多出了“ilename="卡車.png"\r\nContent-Type=image/png”這些內(nèi)容膜楷,其實(shí)這里可以還有其他的內(nèi)容可以設(shè)置,charset和content-transfer-encoding贞奋,都是用于描述這一部分?jǐn)?shù)據(jù)赌厅。具體參考rfc標(biāo)準(zhǔn)。需要注意的是轿塔,name\filename是帶引號的特愿,而Content-Type是沒有的,就這一個(gè)細(xì)節(jié)勾缭,廢掉了我一下午白嵴稀!
這里的Content-Type值是這里要上傳文件的格式俩由,也不能錯(cuò)毒嫡。
(5)部分4這里是需要上傳的文件的二進(jìn)制數(shù)據(jù),當(dāng)然其他部分也是同樣是要轉(zhuǎn)成NSData的采驻。
(6)最后部分5是結(jié)束標(biāo)識(shí)审胚,--wfWiEWrgEFA9A78512weF7106A這部分是和前面的分割符一樣,但接下來不是換行礼旅,而是繼續(xù)“--”,整個(gè)請求體結(jié)束洽洁。這也是個(gè)坑啊痘系,之前以為沒有“--”!
具體代碼如下:
- (void)POST:(NSString *)URL parameters:(NSDictionary *)dic fileName:(NSString *)fileName success:(httpRequestSuccess)success failure:(httpRequestFailed)failure{
NSMutableURLRequest *request = [[NSMutableURLRequest alloc]initWithURL:[NSURL URLWithString:URL] cachePolicy:(NSURLRequestUseProtocolCachePolicy) timeoutInterval:30];
request.HTTPMethod = @"POST";
request.allHTTPHeaderFields = @{@"Content-Type":[NSString stringWithFormat:@"multipart/form-data; boundary=%@",boundary]};
NSMutableData *postData = [[NSMutableData alloc]init];//請求體數(shù)據(jù)
for (NSString *key in dic) {
//循環(huán)參數(shù)按照部分1饿自、2汰翠、3那樣循環(huán)構(gòu)建每部分?jǐn)?shù)據(jù)
NSString *pair = [NSString stringWithFormat:@"--%@\r\nContent-Disposition: form-data; name=\"%@\"\r\n\r\n",boundary,key];
[postData appendData:[pair dataUsingEncoding:NSUTF8StringEncoding]];
id value = [dic objectForKey:key];
if ([value isKindOfClass:[NSString class]]) {
[postData appendData:[value dataUsingEncoding:NSUTF8StringEncoding]];
} else if ([value isKindOfClass:[NSData class]]){
[postData appendData:value];
}
[postData appendData:[@"\r\n" dataUsingEncoding:NSUTF8StringEncoding]];
}
//文件部分
NSString *content = [NSString stringWithFormat:@"%@.pcm",fileName];
// NSString *filename = [[NSBundle mainBundle] pathForResource:@"useridroleid20211012183706" ofType:@"pcm"];
// NSData *fileData = [[NSData alloc] initWithContentsOfFile:filename];
//filename = useridroleid20211012183706 從document目錄下,拿到音頻文件
NSData *fileData = [[NSData alloc] initWithContentsOfFile:[self filePath:fileName]];
NSString *filePair = [NSString stringWithFormat:@"--%@\r\nContent-Disposition: form-data; name=\"%@\"; filename=\"%@\"\r\nContent-Type: \"%@\" \r\n\r\n",boundary,@"file",content,@"application/octet-stream"];
[postData appendData:[filePair dataUsingEncoding:NSUTF8StringEncoding]];
[postData appendData:fileData]; //加入文件的數(shù)據(jù)
[postData appendData:[@"\r\n" dataUsingEncoding:NSUTF8StringEncoding]];
//設(shè)置結(jié)尾
[postData appendData:[[NSString stringWithFormat:@"--%@--\r\n",boundary] dataUsingEncoding:NSUTF8StringEncoding]];
request.HTTPBody = postData;
//設(shè)置請求頭總數(shù)據(jù)長度
[request setValue:[NSString stringWithFormat:@"%lu",(unsigned long)postData.length] forHTTPHeaderField:@"Content-Length"];
NSURLSessionConfiguration *config = [NSURLSessionConfiguration defaultSessionConfiguration];
NSURLSession *session = [NSURLSession sessionWithConfiguration:config];
NSURLSessionDataTask *dataTask = [session dataTaskWithRequest:request
completionHandler:^(NSData * _Nullable data, NSURLResponse * _Nullable response, NSError * _Nullable error) {
if(error || ((NSHTTPURLResponse *)response).statusCode != 200) {
NSLog(@"upload error %@", error);
failure(error);
} else {
NSDictionary *dictionary = [NSJSONSerialization JSONObjectWithData:data options:NSJSONReadingMutableContainers error:&error];
success(dictionary);
}
}];
[dataTask resume];
}
需要注意的:
1昭雌、每個(gè)該換行的地方都不能少复唤,也不能多,且換行為“\r\n”
2烛卧、Content-Type的值沒有引號
3佛纫、整個(gè)請求體是以“--”結(jié)束的。
然后因?yàn)閜ostData里面混進(jìn)了圖片的二進(jìn)制數(shù)據(jù)总放,沒法從NSData轉(zhuǎn)成字符串呈宇,在調(diào)試的時(shí)候沒法直觀的查看哪里出了問題。我的做法是把添加文件數(shù)據(jù)局雄,改成一個(gè)字符串的數(shù)據(jù)甥啄,比如:
[postData appendData:[@"測試文件數(shù)據(jù)" dataUsingEncoding:NSUTF8StringEncoding]];
//[postData appendData:fileData]; //加入文件的數(shù)據(jù)