iOS开发 GET、POST请求方法：NSURLSession篇

转载自： http://www.cocoachina.com/ios/20160601/16544.html
NSURLConnection，在iOS 9被宣布弃用，本文不使用NSURLConnection进行网络编程，有兴趣的童鞋可以参考：

iOS开发 GET、POST请求方法（NSURLConnection篇）

介绍：NSURLSession，为iOS7中的新网络接口，是在2013年的WWDC上，由Apple提出的NSURLConnection继任者的：NSURLSession。

NSURLSession，与NSURLConnection是并列的，且可以支持后台相关的网络操作的新特性；与NSURLConnection不同的是，NSURLSession把NSURLConnection替换成NSURLSession, NSURLSessionConfiguration，NSURLSessionTask。

NSURLSession一般分别两部操作：第一，通过NSURLSession的实例创建task；第二，执行task；

而NSURLSessionTask，也就是task，可以把它当作所谓的任务。

NSURLSessionTask是一个抽象子类，它有三个具体的子类是可以直接使用的：NSURLSessionDataTask，NSURLSessionUploadTask和NSURLSessionDownloadTask。这三个类应用的三个基本网络任务：获取数据、上传文件、下载文件。与数据有关的NSURLSessionDataTask也可以胜任上传下载的任务，所以经常使用到。

————示例————–

一、GET方法

// 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.创建一个网络路径
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为只读状态。

@property (nullable, readonly, retain) id  delegate;

那么我们需要怎样设置代理对象呢？下面我们通过代码演示关于代理方法的使用：

首先在文件开头添加代理协议，

#import
@interface ViewController : UIViewController   //遵循代理协议
@end

主方法的编写如下：

// 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];

关于代理行为：

#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.创建网路路径
NSURL *url = [NSURL URLWithString:@"http://172.16.2.254/php/phonelogin/image.png"] ;
// 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代理方法：

首先添加协议

#import
@interface ViewController : UIViewController   //遵循代理协议
@end

代理方法如下：

// 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方法：

NSURLSessionUploadTask *task =[[NSURLSession sharedSession] uploadTaskWithRequest:request fromFile:fileName
completionHandler:^(NSData *data, NSURLResponse *response, NSError *error) {}];

POST方法：

[[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了解下。