iOS 通过 REST API 接口上传文件(图片)
官方文档中提到了通过通过 REST API 接口上传文件的问题。这里我简单介绍一下通过REST API 接口上传图片的问题。
我们知道由于iOS无法通过html表单来上传图片,因此想要上传图片,必须实现http请求,而不能像其他语言那样通过html表单的post就能上传。这个文档中貌似没有说清楚
上传图片的http post请求的格式是这样的:
第一行是指定了http post请求的编码方式为multipart/form-data(上传文件必须用这个)。
boundary=AaB03x说明了AaB03x为分界线。比如 --AaB03x 就是一个分界线的意思
content-disposition: form-data; name="field1"
Hello Boris!
这句话声明了请求中的一个字段的名称,如field1 以及字段的值,如Hello Boris!
这里类似form表单中的
中间的空行是必须的。一般是文件的一些属性
不同的字段之间用分界线分开,分界线需要单独一行,如 --AaB03x--
分界线的下一行,是下一个字段
content-disposition: form-data; name="pic"; filename="boris.png"
Content-Type: image/png
... contents of boris.png ...
--AaB03x--
这里声明了变量pic,也就是我们要传的文件,上传文件的时候需要在后边指定filename:filename="boris.png"
并且需要在下一行指定文件的格式:Content-Type: image/png
... contents of boris.png ... 这里是boris.png的二进制内容(也就是data类型),如 <89504e47 0d0a1a0a 0000000d 49484452 000000b4 000000b4 08020000 00b2af91 65000020 00494441 5478012c dd79b724 6b7616f6 8c888c88 8c9c8733 55ddb1d5 6a0db486 06218401 ......
在http post请求的结尾,需要有一个分界线,但是是前后都有--的:--AaB03x--
以上的这些格式,是http的规范,每个空行,空格都是必须的。
下边是iOS的实现代码
/*---------------------------------上传图片-------------------------------------------*/
//分界线的标识符
NSString *TWITTERFON_FORM_BOUNDARY = @"AaB03x";
//上传的接口
NSURL *url = [NSURL URLWithString:@"https://a1.easemob.com/环信ID/APP名字/chatfiles"];
//要上传的图片,得到data
NSData *data = UIImagePNGRepresentation([UIImage imageNamed:@"defain"]);//这是我的本地图片
//声明file字段,文件名为defain.png, 声明上传文件的格式
NSString* strBodyBegin = [NSString stringWithFormat:@"--%@\nContent-Disposition: form-data; name=\"%@\"; filename=\"%@\"\nContent-Type: %@\n\n", TWITTERFON_FORM_BOUNDARY, @"file", @"defain.png", @"image/png"];
//声明结束符:--AaB03x--
NSString* strBodyEnd = [NSString stringWithFormat:@"\n--%@--",TWITTERFON_FORM_BOUNDARY];
NSMutableData *httpBody = [NSMutableData data];
//表单开始
[httpBody appendData:[strBodyBegin dataUsingEncoding:NSUTF8StringEncoding]];
//填入数据
[httpBody appendData:data];
//表单结束
[httpBody appendData:[strBodyEnd dataUsingEncoding:NSUTF8StringEncoding]];
/*
注意:这里我没有用下面的字段(它主要用来描述text格式的文本信息)
content-disposition: form-data; name="field1"
Hello Boris!
*/
NSMutableURLRequest* httpPutRequest = [[NSMutableURLRequest alloc] init];
[httpPutRequest setURL:url];
//设置请求方法
[httpPutRequest setHTTPMethod:@"POST"];
[httpPutRequest setTimeoutInterval: 60000];
//设置HTTPHeader中token的值
[httpPutRequest setValue:@"Bearer **************************************************" forHTTPHeaderField:@"Authorization"];
//设置访问权限
[httpPutRequest setValue:@"true" forHTTPHeaderField:@"restrict-access"];
//设置Content-Length
[httpPutRequest setValue:[NSString stringWithFormat:@"%@", @(httpBody.length)] forHTTPHeaderField:@"Content-Length"];
//设置HTTPHeader中Content-Type的值
[httpPutRequest setValue:[NSString stringWithFormat:@"multipart/form-data; boundary=%@",TWITTERFON_FORM_BOUNDARY] forHTTPHeaderField:@"Content-Type"];
//将表单添加到请求体
httpPutRequest.HTTPBody = httpBody;
//异步请求
[NSURLConnection sendAsynchronousRequest:httpPutRequest queue:[[NSOperationQueue alloc] init] completionHandler:^(NSURLResponse *response, NSData *data, NSError *connectionError) {
if (connectionError == nil) {
id obj = [NSJSONSerialization JSONObjectWithData:data options:NSJSONReadingMutableContainers error:nil];
NSLog(@"服务器返回信息%@",obj);
}
}];
//服务器返回信息
2016-01-03 14:30:20.272 Fuhome-App[1356:154571] 服务器返回信息{
action = post;
application = "************";
applicationName = **********;
duration = 81;
entities = (
{
"share-secret" = "*********";
type = chatfile;
uuid = "***********";
}
);
organization = ******;
path = "/chatfiles";
timestamp = 1451802620175;
uri = "https://a1.easemob.com/******/*******/chatfiles";
}