NSURLSession上传文件
(一)上传单个文件的过程及原理总结
1.上传文件需要注意两点
第一点 : 请求头里面的Content-Type
请求头里面
Content-Type的作用 : 告诉服务器我的客户端的请求是干什么的,是做普通请求还是做文件上传普通请求的
Content-Type:Content-Type: application/x-www-form-urlencoded文件上传的
Content-Type:Content-Type:multipart/form-data; boundary=----WebKitFormBoundaryf3vccsnJe8EBoxHYboundary: 表示文件上传时的文件分隔符;可以自定义;自定义分隔符时,前面四个中划线可以省略,分隔符不能有中文;自定义
boundary:boundary=zxc自定义
boundary之后的Content-Type:Content-Type:multipart/form-data; boundary=zxc
第二点 : 请求体
------WebKitFormBoundaryf3vccsnJe8EBoxHY
Content-Disposition: form-data; name="userfile"; filename="car.jpg"
Content-Type: image/jpeg
------WebKitFormBoundaryf3vccsnJe8EBoxHY--
请求体解释 :
- 第一行 : 文件的起始分割符,分割文件用的.以"--"开头+分隔符(
----WebKitFormBoundaryf3vccsnJe8EBoxHY),分隔符前面的"----"可以省略,比如--zxc - 第二行 :
Content-Disposition,文件上传时需要处理的表单数据.-
name="userfile": 服务器接收文件的字段名,由服务器提供,并告知前端开发者. -
filename="car.jpg": 文件保存到服务器上的文件名.可以自定义也可以直接使用文件的原始文件名
-
- 第三行 :
Content-Type: image/jpeg,告诉服务器上传的文件类型.如果不想告诉服务器文件的类型,可以使用Content-Type: application/octet-stream - 第四行 : 单纯的回车换行
\r\n - 第五行 : 上传的文件的二进制数据data
- 第六行 : 整个文件结束的分隔符,以"--"开头,以"--"结尾,两个"--"都不能少.比如
--zxc--
代码实现文件上传需要做的事情 :
1.设置请求头
Content-Type: multipart/form-data; boundary=zxc-
2.设置请求体,需要拼接请求体中的字符串和二进制数据
- 请求体数据结构
--zxc\r\n Content-Disposition: form-data; name="userfile"; filename="car.jpg"\r\n Content-Type: image/jpeg\r\n \r\n data \r\n--zxc--
2.说明
- boundary : 表示文件的分隔符,分界线.非中文的字符组成.
- userfile：服务器字段名,开发的时候,可以咨询后服务器端程序员.
- filename：将文件保存在服务器上的文件名称.
- Content-Type：客户端告诉服务器上传文件的文件类型.
- text/plain
- image/jpg
- image/png
- image/gif
- text/html
- application/json
- application/octet-stream(8进制流)，如果不想告诉服务器具体的文件类型，可以使用这个 Content-Type.
- 注意：每一行末尾一定需要有
\r\n.
(二)单个文件上传实现
1.准备要上传的数据,调用文件上传主方法
- (void)touchesBegan:(NSSet *)touches withEvent:(UIEvent *)event
{
// 参数1
NSString *URLString = @"http://localhost/php/upload/upload.php";
// 参数2
NSString *serverFileName = @"userfile";
// 参数3
NSString *filePath = [[NSBundle mainBundle] pathForResource:@"mm01.jpg" ofType:nil];
// 调用文件上传主方法
[self uploadFileWithURLString:URLString serverFileName:serverFileName filePath:filePath];
}
2.文件上传主方法
/**
* 文件上传主方法
*
* @param URLString 文件上传地址
* @param serverFileName 服务器接收文件的字段名,开发中由服务器那边提供
* @param filePath 文件路径,有了路径就可以获取到文件二进制数据和文件名
*/
- (void)uploadFileWithURLString:(NSString *)URLString serverFileName:(NSString *)serverFileName filePath:(NSString *)filePath
{
// URL
NSURL *URL= [NSURL URLWithString:URLString];
// 可变请求
NSMutableURLRequest *requestM = [NSMutableURLRequest requestWithURL:URL];
// 设置请求头信息
[requestM setValue:@"multipart/form-data; boundary=itcast" forHTTPHeaderField:@"Content-Type"];
// 设置请求方法
requestM.HTTPMethod = @"POST";
// 设置请求
requestM.HTTPBody = [self getHTTPBodyWithServerFileName:serverFileName filePath:filePath];
// 发送请求实现图片上传
[[[NSURLSession sharedSession] dataTaskWithRequest:requestM completionHandler:^(NSData * _Nullable data, NSURLResponse * _Nullable response, NSError * _Nullable error) {
// 处理响应
if (error == nil && data != nil) {
// 反序列化
NSDictionary *result = [NSJSONSerialization JSONObjectWithData:data options:0 error:NULL];
NSLog(@"%@",result);
} else {
NSLog(@"%@",error);
}
}] resume];
}
3.获取请求体信息
/**
* 获取请求体信息
*
* @param serverFileName 服务器接收文件的字段名
* @param filePath 文件路径
*
* @return 返回请求体二进制信息
*/
- (NSData *)getHTTPBodyWithServerFileName:(NSString *)serverFileName filePath:(NSString *)filePath
{
// 定义dataM,拼接请求体的二进制信息
NSMutableData *dataM = [NSMutableData data];
// 拼接文件二进制前面的字符串
NSMutableString *stringM = [NSMutableString string];
// 拼接文件开始的分隔符
[stringM appendString:@"--itcast\r\n"];
// 拼接表单数据
[stringM appendFormat:@"Content-Disposition: form-data; name=%@; filename=%@\r\n",serverFileName,[filePath lastPathComponent]];
// 拼接文件类型
[stringM appendString:@"Content-Type: image/jpeg\r\n"];
// 拼接单纯的换行
[stringM appendString:@"\r\n"];
// 把这部分的字符串转成二进制,拼接到dataM里面
[dataM appendData:[stringM dataUsingEncoding:NSUTF8StringEncoding]];
// 拼接文件的二进制数据
[dataM appendData:[NSData dataWithContentsOfFile:filePath]];
// 拼接文件结束的分隔符
NSString *end = @"\r\n--itcast--";
[dataM appendData:[end dataUsingEncoding:NSUTF8StringEncoding]];
return dataM.copy;
}
(三)多个文件上传原理分析
- 原理 : 循环的将多个文件拼接起来,并用上传文件的分隔符分割开.
1.上传文件需要注意两点
第一点 : Content-Type
- 第一点 :
Content-Type,告诉服务器是发送文件.Content-Type: multipart/form-data; boundary=----WebKitFormBoundary0YVF2TB5DWTxe
第二点 : 请求体
- 请求体数据结构
--itcast\r\n
Content-Disposition: form-data; name="userfile[]"; filename="mm01.jpg"\r\n
Content-Type: image/jpeg\r\n
\r\n
data\r\n
--itcast\r\n
Content-Disposition: form-data; name="userfile[]"; filename="mm02.jpg"\r\n
Content-Type: image/jpeg\r\n
\r\n
data\r\n
--itcast\r\n
Content-Disposition: form-data; name="status"\r\n
\r\n
今天和女神的男神在一起!好开心!\r\n
--itcast--
2.说明
- 第一个文件开始分隔符前有无
\r\n是没有影响的. - 上传多个文件时的请求体需要把多个文件循环的拼接起来.
- 有些服务器可以在上传文件的同时,提交一些文本内容给服务器.典型应用 : 新浪微博,上传图片的同时,发送一个微博.
-
name="status"中的"status"是脚本文件接收上传时文字信息的参数的名称
(四)多个文件上传实现
1.准备上传数据,调用多文件上传的主方法
- (void)touchesBegan:(NSSet *)touches withEvent:(UIEvent *)event
{
// 参数1
NSString *URLString = @"http://localhost/php/upload/upload-m.php";
// 参数2
NSString *serverFileName = @"userfile[]";
// 参数3
NSString *filePath1 = [[NSBundle mainBundle] pathForResource:@"mm01.jpg" ofType:nil];
NSString *filePath2 = [[NSBundle mainBundle] pathForResource:@"mm02.jpg" ofType:nil];
NSArray *filePaths = @[filePath1,filePath2];
// 参数4
NSDictionary *textDict = @{@"status":@"今天和女神的男神在一起!好开心!"};
// 调用文件上传的主方法
[self uploadFilesWithURLString:URLString serverFileName:serverFileName filePaths:filePaths textDict:textDict];
}
2.多文件上传的主方法
/**
* 多文件上传的主方法
*
* @param URLString 文件上传的地址
* @param serverFileName 服务器接收文件的字段名
* @param filePaths 文件路径的数组
* @param textDict 文件上传的附带信息
*/
- (void)uploadFilesWithURLString:(NSString *)URLString serverFileName:(NSString *)serverFileName filePaths:(NSArray *)filePaths textDict:(NSDictionary *)textDict
{
// URL
NSURL *URL = [NSURL URLWithString:URLString];
// 可变请求
NSMutableURLRequest *requestM = [NSMutableURLRequest requestWithURL:URL];
// 设置请求头
[requestM setValue:@"multipart/form-data; boundary=itcast" forHTTPHeaderField:@"Content-Type"];
// 设置请求方法
requestM.HTTPMethod = @"POST";
// 设置请求体
requestM.HTTPBody = [self getHTTPBodyWithServerFileName:serverFileName filePaths:filePaths textDict:textDict];
// 发送请求实现文件上传
[[[NSURLSession sharedSession] dataTaskWithRequest:requestM completionHandler:^(NSData * _Nullable data, NSURLResponse * _Nullable response, NSError * _Nullable error) {
// 处理响应
if (error == nil && data != nil) {
// 反序列化
id result = [NSJSONSerialization JSONObjectWithData:data options:0 error:NULL];
NSLog(@"%@",result);
} else {
NSLog(@"%@",error);
}
}] resume];
}
3.获取请求体信息
/**
* 获取请求体信息
*
* @param serverFileName 服务器接收文件的字段名
* @param filePaths 文件的路径数组
* @param textDict 文件上传时的文本信息
*
* @return 文件的二进制数据
*/
- (NSData *)getHTTPBodyWithServerFileName:(NSString *)serverFileName filePaths:(NSArray *)filePaths textDict:(NSDictionary *)textDict
{
// 定义dataM拼接请求体二进制数据
NSMutableData *dataM = [NSMutableData data];
// 循环拼接文件二进制信息
[filePaths enumerateObjectsUsingBlock:^(id _Nonnull obj, NSUInteger idx, BOOL * _Nonnull stop) {
// 用于字符串信息
NSMutableString *stringM = [NSMutableString string];
// 拼接文件开始的分隔符
[stringM appendString:@"--itcast\r\n"];
// 拼接表单数据
[stringM appendFormat:@"Content-Disposition: form-data; name=%@; filename=%@\r\n",serverFileName,[obj lastPathComponent]];
// 拼接文件类型
[stringM appendString:@"Content-Type: image/jpeg\r\n"];
// 拼接单纯的换行
[stringM appendString:@"\r\n"];
// 把前面的字符串信息拼接到请求体里面
[dataM appendData:[stringM dataUsingEncoding:NSUTF8StringEncoding]];
// 拼接文件的二进制数据到dataM
[dataM appendData:[NSData dataWithContentsOfFile:obj]];
// 拼接二进制数据后面的换行
[dataM appendData:[@"\r\n" dataUsingEncoding:NSUTF8StringEncoding]];
}];
// 拼接文件的文本信息
[textDict enumerateKeysAndObjectsUsingBlock:^(id _Nonnull key, id _Nonnull obj, BOOL * _Nonnull stop) {
// 用于拼接文本信息
NSMutableString *stringM = [NSMutableString string];
// 拼接文本信息的开始分割符
[stringM appendString:@"--itcast\r\n"];
// 拼接表单数据
[stringM appendFormat:@"Content-Disposition: form-data; name=%@\r\n",key];
// 拼接单纯的换行
[stringM appendString:@"\r\n"];
// 拼接文本信息
[stringM appendFormat:@"%@\r\n",obj];
// 把文本信息拼接到请求体
[dataM appendData:[stringM dataUsingEncoding:NSUTF8StringEncoding]];
}];
// 拼接文件上传的结束分隔符
[dataM appendData:[@"--itcast--" dataUsingEncoding:NSUTF8StringEncoding]];
return dataM.copy;
}