iOS开发之NSURLSessionUploadTask上传数据
苹果在 iOS9 之后已经废弃了NSURLConnection，NSURLSession成为其替代者，其基本知识网上很多，主要可以从NSURLSessionDataTask 、NSURLSessionDownloadTask 和NSURLSessionUploadTask入手学习。最近在写案例时发现其中的NSURLSessionUploadTask还是有着不少的坑，在开发时有时候很难一次性成功。所以将研究的过程记录与分享一下。我会以一个完整的案例来讲解如何使用。
服务器开发
环境：IDEA 14 +Tomcat 8.x+JDK 8
1、编写服务器端代码
由于上传数据与下载数据不同，下载的时候只要把数据丢进服务器就可以了。但是上传需要服务器自己来处理。所以以Java Servlet来写服务器端，由于Servlet 3.0 以后可以直接处理文件上传，所以相对比较简单，代码如下，注释很详细。
import javax.servlet.ServletException;
import javax.servlet.annotation.MultipartConfig;
import javax.servlet.http.HttpServlet;
import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;
import javax.servlet.http.Part;
import java.io.File;
import java.io.IOException;
import java.io.PrintWriter;
@MultipartConfig //标识Servlet支持文件上传
public class UploadServlet extends HttpServlet {
@Override
protected void doPost(HttpServletRequest req, HttpServletResponse resp) throws ServletException, IOException {
//存储路径为我们的根目录
String storePath = req.getServletContext().getRealPath("/");
//获取part对象，参数为客户端表单中的name属性的值
Part part = req.getPart("myfile");
//Servlet3没有提供直接获取文件名的方法,需要从请求头中解析出来
//获取请求头
String header = part.getHeader("Content-Disposition");
//获取文件名
String fileName = header.substring(header.lastIndexOf("=") + 2, header.length() - 1);
//把文件写到指定路径
part.write(storePath + File.separator + fileName);
//回写数据给客户端
resp.setCharacterEncoding("UTF-8");
PrintWriter pw = resp.getWriter();
pw.print("上传成功");
}
}
2、部署代码
找到Tomcat根目录下的conf文件夹，打开server.xml，在最后加上一行代码，path就是访问的项目路径，docBase就是项目编译后的位置。
<Context path="/AppTestAPI" docBase="E:\AppTestAPI\out\artifacts\AppTestAPI" auth="Container" />
3、启动服务器
通过浏览器访问http://localhost能出现如下的界面，至此完成服务器端工作。( 由于我修改了默认端口，所以没有加8080 )
Paste_Image.png
客户端开发
环境：Xcode 7.3.1
1、创建项目
创建一个项目，布置界面，设置支持http网络访问。主界面如下：
界面.png
2、编写代码
NSURLSession使用都是一个套路：创建请求，创建任务，执行任务，成功回调。但是在使用NSURLSessionUploadTask进行上传时最麻烦的是上传数据的构造，其遵循严格的规范，如下图，不能随意书写，不能随意书写，不能随意书写~，重要的事情说三遍，否则坑得你生活不能自理。
上传必填字段.png
下面是ViewController的代码，其中最核心的是getData方法。
#import "ViewController.h"
//分隔符
#define YFBoundary @"AnHuiWuHuYungFan"
//换行
#define YFEnter [@"\r\n" dataUsingEncoding:NSUTF8StringEncoding]
//NSString转NSData
#define YFEncode(string) [string dataUsingEncoding:NSUTF8StringEncoding]
@interface ViewController ()<NSURLSessionTaskDelegate>
@property (weak, nonatomic) IBOutlet UIProgressView *uploadProgress;
@property (weak, nonatomic) IBOutlet UILabel *uploadInfo;
@end
@implementation ViewController
- (void)viewDidLoad {
[super viewDidLoad];
//1、确定URL
NSURL *url = [NSURL URLWithString:@"http://192.168.0.5/AppTestAPI/UploadServlet"];
//2、确定请求
NSMutableURLRequest *request = [NSMutableURLRequest requestWithURL:url];
//3、设置请求头
NSString *head = [NSString stringWithFormat:@"multipart/form-data;boundary=%--@", YFBoundary];
[request setValue:head forHTTPHeaderField:@"Content-Type"];
//4、设置请求方式，上传时必须是Post请求
request.HTTPMethod = @"POST";
//5、创建NSURLSession
NSURLSession *session = [NSURLSession sessionWithConfiguration:[NSURLSessionConfiguration defaultSessionConfiguration] delegate:self delegateQueue:[NSOperationQueue mainQueue]];
//6、获取上传的数据
NSData *uploadData = [self getData];
//7、创建上传任务 上传的数据来自getData方法
NSURLSessionUploadTask *task = [session uploadTaskWithRequest:request fromData:uploadData completionHandler:^(NSData *data, NSURLResponse *response, NSError *error) {
//上传成功以后改变UILabel文本为服务器返回的数据
self.uploadInfo.text =[[NSString alloc]initWithData:data encoding:NSUTF8StringEncoding];
}];
//8、执行上传任务
[task resume];
}
/**
* 设置请求体
*
* @return 请求体内容
*/
-(NSData *)getData
{
NSMutableData *data = [NSMutableData data];
//1、开始标记
//--
[data appendData:YFEncode(@"--")];
//boundary
[data appendData:YFEncode(YFBoundary)];
//换行符
[data appendData:YFEnter];
//文件参数名 Content-Disposition: form-data; name="myfile"; filename="wall.jpg"
[data appendData:YFEncode(@"Content-Disposition:form-data; name=\"myfile\"; filename=\"wall.jpg\"")];
//换行符
[data appendData:YFEnter];
//Content-Type 上传文件的类型 MIME
[data appendData:YFEncode(@"Content-Type:image/jpeg")];
//换行符
[data appendData:YFEnter];
//换行符
[data appendData:YFEnter];
//2、上传的文件数据
//图片数据 并且转换为Data
UIImage *image = [UIImage imageNamed:@"wall.jpg"];
NSData *imagedata = UIImageJPEGRepresentation(image, 1.0);
[data appendData:imagedata];
//换行符
[data appendData:YFEnter];
//3、结束标记
//--
[data appendData:YFEncode(@"--")];
//boundary
[data appendData:YFEncode(YFBoundary)];
//--
[data appendData:YFEncode(@"--")];
//换行符
[data appendData:YFEnter];
return data;
}
#pragma mark - 代理方法 只要给服务器上传数据就会调用 可以计算出上传进度
- (void)URLSession:(NSURLSession *)session task:(NSURLSessionTask *)task didSendBodyData:(int64_t)bytesSent totalBytesSent:(int64_t)totalBytesSent totalBytesExpectedToSend:(int64_t)totalBytesExpectedToSend
{
//设置进度条
self.uploadProgress.progress = 1.0 * totalBytesSent / totalBytesExpectedToSend;
}
@end
最终效果
先看客户端的表象
客户端演示.gif
再看服务器端最终上传的数据，不重要以为是图片，静静观察一会儿~~~有变化
服务器端.gif
