1.使用微博開發(fā)的一個(gè)“發(fā)送帶圖片微博”的接口來測(cè)試,這是接口地址驾凶,這里面明確說明需要使用multipart/form-data格式提交圖片牙甫。關(guān)于使用微博開放平臺(tái)api、授權(quán)之類的就不說了调违。
2.multipart/from-data是一種進(jìn)行表單提交時(shí)的消息格式窟哺。表單提交數(shù)據(jù)的時(shí)候,默認(rèn)類型是application/x-www-form-urlencoded技肩,也就是key=value的鍵值對(duì)格式且轨,提交文件的時(shí)候使用multipart/from-data。因?yàn)槭潜韱翁峤恍樾觯詇ttp請(qǐng)求方式是POST旋奢。然后在請(qǐng)求頭里設(shè)置Content-Type為multipart/from-data指定請(qǐng)求的格式。
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請(qǐng)求,參數(shù)都放在請(qǐng)求體里面辛蚊,而請(qǐng)求體是這里的關(guān)鍵粤蝎,multipart/form-data就是一種格式,約定請(qǐng)求體的數(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,即雙減號(hào)加分隔符虑凛,然后換行碑宴,注意換行是使用“\r\n”,因?yàn)檫@些標(biāo)準(zhǔn)開始都是在html中使用的桑谍。測(cè)試了微博接口延柠,換行也不能出錯(cuò)。
(2)部分2的格式是:Content-Disposition: form-data; name="xxx"锣披,這里的xxx是接口的參數(shù)臊诊,比如微博測(cè)試接口有一個(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)對(duì)應(yīng)著接口里的一個(gè)字段的數(shù)據(jù)影锈。直到你要上傳的文件,部分4蝉绷。部分4這一節(jié)多出了“ilename="卡車.png";Content-Type=image/png”這些內(nèi)容鸭廷,其實(shí)這里可以還有其他的內(nèi)容可以設(shè)置,charset和content-transfer-encoding熔吗,都是用于描述這一部分?jǐn)?shù)據(jù)辆床。具體參考rfc標(biāo)準(zhǔn)。需要注意的是桅狠,name\filename是帶引號(hào)的讼载,而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è)請(qǐng)求體結(jié)束。這也是個(gè)坑啊狐赡,之前以為沒有“--”撞鹉!
具體代碼如下:
NSMutableData *postData = [[NSMutableData alloc]init];//請(qǐng)求體數(shù)據(jù)
for (NSString *key in params) {
//循環(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 = [params 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 *filename = [filePath lastPathComponent];
NSString *contentType = AFContentTypeForPathExtension([filePath pathExtension]);
NSString *filePair = [NSString stringWithFormat:@"--%@\r\nContent-Disposition: form-data; name=\"%@\"; filename=\"%@\"
Content-Type=%@\r\n\r\n",boundary,fileKey,filename,contentType];
[postData appendData:[filePair dataUsingEncoding:NSUTF8StringEncoding]];
[postData appendData:fileData]; //加入文件的數(shù)據(jù)
[postData appendData:[@"\r\n" dataUsingEncoding:NSUTF8StringEncoding]];
如果有多個(gè)文件鸟雏,就重復(fù)設(shè)置文件部分享郊,使用不同的`name`標(biāo)識(shí)。
//設(shè)置結(jié)尾
[postData appendData:[[NSString stringWithFormat:@"--%@--\r\n",boundary] dataUsingEncoding:NSUTF8StringEncoding]];
request.HTTPBody = postData;
//設(shè)置請(qǐng)求頭總數(shù)據(jù)長(zhǎng)度
[request setValue:[NSString stringWithFormat:@"%lu",(unsigned long)postData.length] forHTTPHeaderField:@"Content-Length"];
然后根據(jù)文件后綴名可以獲取對(duì)應(yīng)的Content-Type孝鹊,來源AFNetWorking:
static inline NSString * AFContentTypeForPathExtension(NSString *extension) {
#ifdef __UTTYPE__
NSString *UTI = (__bridge_transfer NSString *)UTTypeCreatePreferredIdentifierForTag(kUTTagClassFilenameExtension, (__bridge CFStringRef)extension, NULL);
NSString *contentType = (__bridge_transfer NSString *)UTTypeCopyPreferredTagWithClass((__bridge CFStringRef)UTI, kUTTagClassMIMEType);
if (!contentType) {
return @"application/octet-stream";
} else {
return contentType;
}
#else
#pragma unused (extension)
return @"application/octet-stream";
#endif
}
需要注意的:
1炊琉、每個(gè)該換行的地方都不能少,也不能多又活,且換行為“\r\n”
2苔咪、Content-Type的值沒有引號(hào)
3、整個(gè)請(qǐng)求體是以“--”結(jié)束的柳骄。
然后因?yàn)閜ostData里面混進(jìn)了圖片的二進(jìn)制數(shù)據(jù)团赏,沒法從NSData轉(zhuǎn)成字符串,在調(diào)試的時(shí)候沒法直觀的查看哪里出了問題耐薯。我的做法是把添加文件數(shù)據(jù)舔清,改成一個(gè)字符串的數(shù)據(jù),比如:
[postData appendData:[@"測(cè)試文件數(shù)據(jù)" dataUsingEncoding:NSUTF8StringEncoding]];
//[postData appendData:fileData]; //加入文件的數(shù)據(jù)
最后是項(xiàng)目代碼:github地址曲初。微博授權(quán)功能已經(jīng)在里面了体谒,先授權(quán),在測(cè)試提交圖片臼婆。上傳后看控制臺(tái)輸入抒痒,成功后可以在授權(quán)的微博賬號(hào)里看見剛發(fā)的這條微博。
這個(gè)很久沒更新了颁褂,相關(guān)知識(shí)可以直接參考AFNetWorking的封裝故响,上傳文件部分就是這個(gè)原理。