NSURLSession,与NSURLConnection是并列的,且可以支持后台相关的网络操作的新特性;与NSURLConnection不同的是,NSURLSession把NSURLConnection替换成NSURLSession, NSURLSessionConfiguration,NSURLSessionTask。
NSURLSession一般分别两部操作:第一,通过NSURLSession的实例创建task;第二,执行task;
而NSURLSessionTask,也就是task,可以把它当作所谓的任务。
NSURLSessionTask是一个抽象子类,它有三个具体的子类是可以直接使用的:NSURLSessionDataTask,NSURLSessionUploadTask和NSURLSessionDownloadTask。这三个类应用的三个基本网络任务:获取数据、上传文件、下载文件。与数据有关的NSURLSessionDataTask也可以胜任上传下载的任务,所以经常使用到。
————示例————–
一、GET方法
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
|
// 1.创建一个网络路径 NSURL *url = [NSURL URLWithString:[NSString stringWithFormat:@ "http://172.16.2.254/php/phonelogin?yourname=%@&yourpas=%@&btn=login" ,yourname,yourpass]]; // 2.创建一个网络请求 NSURLRequest *request =[NSURLRequest requestWithURL:url]; // 3.获得会话对象 NSURLSession *session = [NSURLSession sharedSession]; // 4.根据会话对象,创建一个Task任务: NSURLSessionDataTask *sessionDataTask = [session dataTaskWithRequest:request completionHandler:^(NSData * _Nullable data, NSURLResponse * _Nullable response, NSError * _Nullable error) { NSLog(@ "从服务器获取到数据" ); /* 对从服务器获取到的数据data进行相应的处理: */ NSDictionary *dict = [NSJSONSerialization JSONObjectWithData:data options:(NSJSONReadingMutableLeaves) error:nil]; }]; // 5.最后一步,执行任务(resume也是继续执行): [sessionDataTask resume]; |
二、POST方法
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
|
// 1.创建一个网络路径 NSURL *url = [NSURL URLWithString:[NSString stringWithFormat:@ "http://172.16.2.254/php/phonelogin" ]]; // 2.创建一个网络请求,分别设置请求方法、请求参数 NSMutableURLRequest *request =[NSMutableURLRequest requestWithURL:url]; request.HTTPMethod = @ "POST" ; NSString *args = [NSString stringWithFormat:@ "yourname=%@&yourpass=%@&btn=login" ,yourname,yourpass]; request.HTTPBody = [args dataUsingEncoding:NSUTF8StringEncoding]; // 3.获得会话对象 NSURLSession *session = [NSURLSession sharedSession]; // 4.根据会话对象,创建一个Task任务 NSURLSessionDataTask *sessionDataTask = [session dataTaskWithRequest:request completionHandler:^(NSData * _Nullable data, NSURLResponse * _Nullable response, NSError * _Nullable error) { NSLog(@ "从服务器获取到数据" ); /* 对从服务器获取到的数据data进行相应的处理. */ NSDictionary *dict = [NSJSONSerialization JSONObjectWithData:data options:(NSJSONReadingMutableLeaves) error:nil]; }]; //5.最后一步,执行任务,(resume也是继续执行)。 [sessionDataTask resume]; |
三、NSURLSessionDataDelegate代理方法
从前面两种方法中,我们都可以看出,相比NSURLConnection,NSURLSession提供了block方式处理返回数据的简便方式,但是,如果项目需要在网络请求数据的过程中,要做进一步的处理的话,需要调用NSURLSession的代理方法。
通常,使用代理方法需要先设置代理对象,但是通过查看NSURLSessionDataDelegate文档,我们可以看到如下,代理属性delegate为只读状态。
1
|
@property (nullable, readonly, retain) id delegate; |
那么我们需要怎样设置代理对象呢?下面我们通过代码演示关于代理方法的使用:
首先在文件开头添加代理协议,
1
2
3
|
#import @interface ViewController : UIViewController //遵循代理协议 @end |
主方法的编写如下:
1
2
3
4
5
6
7
8
9
|
// 1.delegateQueue参数表示协议方法将会在(NSOperationQueue)队列里面执行。(session的delegate属性是只读的,所以使用如下方法设置代理。) NSURLSession *session = [NSURLSession sessionWithConfiguration:[NSURLSessionConfiguration defaultSessionConfiguration] delegate:self delegateQueue:[[NSOperationQueue alloc] init]]; // 2.创建任务(因为要使用代理方法,就不需要block方式的初始化了) NSURL *url = [NSURL URLWithString:[NSString stringWithFormat:@ "http://172.16.2.254/php/phonelogin?yourname=%@&yourpass=%@&btn=login" ,yourname,yourpass]]; NSURLSessionDataTask *task = [session dataTaskWithRequest:[NSURLRequest requestWithURL:url]]; // 3.执行任务 [task resume]; |
关于代理行为:
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
|
#pragma mark -- NSURLSessionDataDelegate// 1.接收到服务器的响应 - (void)URLSession:(NSURLSession *)session dataTask:(NSURLSessionDataTask *)dataTask didReceiveResponse:(NSURLResponse *)response completionHandler:(void (^)(NSURLSessionResponseDisposition))completionHandler { //【注意:此处需要允许处理服务器的响应,才会继续加载服务器的数据。 若在接收响应时需要对返回的参数进行处理(如获取响应头信息等),那么这些处理应该放在这个允许操作的前面。】 completionHandler(NSURLSessionResponseAllow); } // 2.接收到服务器的数据(此方法在接收数据过程会多次调用) - (void)URLSession:(NSURLSession *)session dataTask:(NSURLSessionDataTask *)dataTask didReceiveData:(NSData *)data { // 处理每次接收的数据,例如每次拼接到自己创建的数据receiveData [self.receiveData appendData:data]; } // 3.3.任务完成时调用(如果成功,error == nil) - (void)URLSession:(NSURLSession *)session task:(NSURLSessionTask *)task didCompleteWithError:(NSError *)error { if (error == nil){ /* 请求完成,成功或者失败的处理 */ } else { NSLog(@ "请求失败:%@" ,error); } } |
四、NSURLSessionDownloadTask
1.NSURLSessionDownloadTask:文件下载任务
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
|
// 1.创建网路路径 // 2.获取会话 NSURLSession *session = [NSURLSession sharedSession]; // 3.根据会话,创建任务 NSURLSessionDownloadTask *task = [session downloadTaskWithURL:url completionHandler:^(NSURL *location, NSURLResponse *response, NSError *error) { /* a.location是沙盒中tmp文件夹下的一个临时url,文件下载后会存到这个位置,由于tmp中的文件随时可能被删除,所以我们需要自己需要把下载的文件移动到其他地方:pathUrl. b.response.suggestedFilename是从相应中取出文件在服务器上存储路径的最后部分,例如根据本路径为,最后部分应该为:“image.png” */ NSString *path = [[NSSearchPathForDirectoriesInDomains(NSCachesDirectory, NSUserDomainMask, YES) lastObject] stringByAppendingPathComponent:response.suggestedFilename]; NSURL *pathUrl = [NSURL fileURLWithPath:path]; // 剪切文件 [[NSFileManager defaultManager] moveItemAtURL:location toURL:pathUrl error:nil]; }]; // 4.启动任务 [task resume]; |
2.NSURLSessionDownloadDelegate代理方法:
首先添加协议
1
2
3
|
#import @interface ViewController : UIViewController //遵循代理协议 @end |
代理方法如下:
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
|
// 1.每次写入调用(会调用多次) - (void)URLSession:(NSURLSession *)session downloadTask:(NSURLSessionDownloadTask *)downloadTask didWriteData:(int64_t)bytesWritten totalBytesWritten:(int64_t)totalBytesWritten totalBytesExpectedToWrite:(int64_t)totalBytesExpectedToWrite { // 可在这里通过已写入的长度和总长度算出下载进度 CGFloat progress = 1.0 * totalBytesWritten / totalBytesExpectedToWrite; NSLog(@ "%f" ,progress); } // 2.下载完成时调用 - (void)URLSession:(NSURLSession *)session downloadTask:(NSURLSessionDownloadTask *)downloadTask didFinishDownloadingToURL:(NSURL *)location { // 这里的location也是一个临时路径,需要自己移动到需要的路径(caches下面) NSString *filePath = [[NSSearchPathForDirectoriesInDomains(NSCachesDirectory, NSUserDomainMask, YES) lastObject] stringByAppendingPathComponent:downloadTask.response.suggestedFilename]; [[NSFileManager defaultManager] moveItemAtURL:location toURL:[NSURL fileURLWithPath:filePath] error:nil]; } // 3.请求成功/失败(如果成功,error为nil) - (void)URLSession:(NSURLSession *)session task:(NSURLSessionTask *)task didCompleteWithError:(NSError *)error { if (error == nil){ /* 请求完成,成功或者失败的处理 */ } else { NSLog(@ "请求失败:%@" ,error); } } |
五、NSURLSessionUploadTask
1. NSURLSessionUploadTask上传文件的方式有2种:
-
GET方法:
1
2
|
NSURLSessionUploadTask *task =[[NSURLSession sharedSession] uploadTaskWithRequest:request fromFile:fileName completionHandler:^(NSData *data, NSURLResponse *response, NSError *error) {}]; |
POST方法:
1
2
3
4
|
[[NSURLSession sharedSession] uploadTaskWithRequest:request fromData:body completionHandler:^(NSData data, NSURLResponse response, NSError *error) { NSLog(@ "-------%@" , [NSJSONSerialization JSONObjectWithData:data options:kNilOptions error:nil]); }]; |
不同的点,在于,用post方法需要添加网络路径的请求体body,而在实际开发中,上传文件一般使用post方式,更加安全可靠。
其他:
当然,对于使用NSURLSession开发的项目来说,还有更多的方式可以执行,需要我们在日常开发过程多多发现,以便更好地使用这个较新的网络接口,例如AFNetWorking2.0版本之后,就有了基于NSURLSession的封装运用,具体的有兴趣的童鞋可以去github了解下。