iOS开发网络篇—发送GET和POST请求(使用NSURLSession)

Tanya3099 4年前

来自: http://www.cnblogs.com/wendingding/p/5168772.html

iOS开发网络篇—发送GET和POST请求(使用NSURLSession)

说明:

1)该文主要介绍如何使用NSURLSession来发送GET请求和POST请求

2)本文将不再讲解NSURLConnection的使用,如有需要了解NSURLConnection如何发送请求。

详细信息,请参考:http://www.cnblogs.com/wendingding/p/3813706.html

3)本文示例代码发送的请求均为http请求,已经对info.plist文件进行配置。

如何配置,请参考:https://github.com/HanGangAndHanMeimei/iOS9AdaptationTips

4)本文示例代码,可以在下面的地址获取:

https://github.com/HanGangAndHanMeimei/Code

一、简单说明

在iOS9.0之后,以前使用的NSURLConnection过期,苹果推荐使用NSURLSession来替换NSURLConnection完成网路请求相关操作。

NSURLSession的使用非常简单,先根据会话对象创建一个请求Task,然后执行该Task即可。

NSURLSessionTask本身是一个抽象类,在使用的时候,通常是根据具体的需求使用它的几个子类。关系如下:

二、发送GET请求

使用NSURLSession发送GET请求的方法和NSURLConnection类似,整个过程如下:

1)确定请求路径(一般由公司的后台开发人员以接口文档的方式提供),GET请求参数直接跟在URL后面

2)创建请求对象(默认包含了请求头和请求方法【GET】),此步骤可以省略

3)创建会话对象(NSURLSession)

4)根据会话对象创建请求任务(NSURLSessionDataTask)

5)执行Task

6)当得到服务器返回的响应后,解析数据(XML|JSON|HTTP)

示例代码:

  1 -(void)get1   2 {   3     //对请求路径的说明   4     //http://120.25.226.186:32812/login?username=520it&pwd=520&type=JSON   5     //协议头+主机地址+接口名称+?+参数1&参数2&参数3   6     //协议头(http://)+主机地址(120.25.226.186:32812)+接口名称(login)+?+参数1(username=520it)&参数2(pwd=520)&参数3(type=JSON)   7     //GET请求,直接把请求参数跟在URL的后面以?隔开,多个参数之间以&符号拼接   8        9     //1.确定请求路径  10     NSURL *url = [NSURL URLWithString:@"http://120.25.226.186:32812/login?username=520it&pwd=520it&type=JSON"];  11       12     //2.创建请求对象  13     //请求对象内部默认已经包含了请求头和请求方法(GET)  14     NSURLRequest *request = [NSURLRequest requestWithURL:url];  15       16     //3.获得会话对象  17     NSURLSession *session = [NSURLSession sharedSession];  18         19     //4.根据会话对象创建一个Task(发送请求)  20     /*  21      第一个参数:请求对象  22      第二个参数:completionHandler回调(请求完成【成功|失败】的回调)  23                data:响应体信息(期望的数据)  24                response:响应头信息,主要是对服务器端的描述  25                error:错误信息,如果请求失败,则error有值  26      */  27     NSURLSessionDataTask *dataTask = [session dataTaskWithRequest:request completionHandler:^(NSData * _Nullable data, NSURLResponse * _Nullable response, NSError * _Nullable error) {  28           29         if (error == nil) {  30             //6.解析服务器返回的数据  31             //说明:(此处返回的数据是JSON格式的,因此使用NSJSONSerialization进行反序列化处理)  32             NSDictionary *dict = [NSJSONSerialization JSONObjectWithData:data options:kNilOptions error:nil];  33               34             NSLog(@"%@",dict);  35         }  36     }];  37       38     //5.执行任务  39     [dataTask resume];  40 }    发送GET请求的第一种方法
  1 -(void)get2   2 {   3     //1.确定请求路径   4     NSURL *url = [NSURL URLWithString:@"http://120.25.226.186:32812/login?username=520it&pwd=520it&type=JSON"];   5        6     //2.获得会话对象   7     NSURLSession *session = [NSURLSession sharedSession];   8        9     //3.根据会话对象创建一个Task(发送请求)  10     /*  11      第一个参数:请求路径  12      第二个参数:completionHandler回调(请求完成【成功|失败】的回调)  13                data:响应体信息(期望的数据)  14                response:响应头信息,主要是对服务器端的描述  15                error:错误信息,如果请求失败,则error有值  16      注意:  17         1)该方法内部会自动将请求路径包装成一个请求对象,该请求对象默认包含了请求头信息和请求方法(GET)  18         2)如果要发送的是POST请求,则不能使用该方法  19      */  20     NSURLSessionDataTask *dataTask = [session dataTaskWithURL:url completionHandler:^(NSData * _Nullable data, NSURLResponse * _Nullable response, NSError * _Nullable error) {  21           22         //5.解析数据  23         NSDictionary *dict = [NSJSONSerialization JSONObjectWithData:data options:kNilOptions error:nil];  24         NSLog(@"%@",dict);  25           26     }];  27       28     //4.执行任务  29     [dataTask resume];  30 }    发送GET请求的第二种方法

执行结果:

此处打印的值是一个字典,字典中success这个key对应的value打印出来为Unicode编码的,如果想输出中文,可以为NSDictionary提供一个分类,重写系统中的方法。

  1 #import "NSDictionary+Log.h"   2    3 @implementation NSDictionary (Log)   4    5 -(NSString *)descriptionWithLocale:(id)locale indent:(NSUInteger)level   6 {   7     //初始化可变字符串   8     NSMutableString *string = [NSMutableString string];   9     //拼接开头[  10     [string appendString:@"["];  11       12     //拼接字典中所有的键值对  13     [self enumerateKeysAndObjectsUsingBlock:^(id  _Nonnull key, id  _Nonnull obj, BOOL * _Nonnull stop) {  14         [string appendFormat:@"%@:",key];  15         [string appendFormat:@"%@",obj];  16     }];  17       18     //拼接结尾]  19     [string appendString:@"]"];  20       21     return string;  22 }  23   24 @end    字典分类中重写系统方法

执行结果:

三、发送POST请求

使用NSURLSession发送POST请求的方法和NSURLConnection类似,整个过程如下:

1)确定请求路径(一般由公司的后台开发人员以接口文档的方式提供)

2)创建 可变的 请求对象(因为需要修改),此步骤不可以省略

3)修改请求方法为POST

4)设置请求体,把参数转换为二进制数据并设置请求体

5)创建会话对象(NSURLSession)

6)根据会话对象创建请求任务(NSURLSessionDataTask)

7)执行Task

8)当得到服务器返回的响应后,解析数据(XML|JSON|HTTP)

示例代码:

  1 -(void)post   2 {   3     //对请求路径的说明   4     //http://120.25.226.186:32812/login   5     //协议头+主机地址+接口名称   6     //协议头(http://)+主机地址(120.25.226.186:32812)+接口名称(login)   7     //POST请求需要修改请求方法为POST,并把参数转换为二进制数据设置为请求体   8        9     //1.创建会话对象  10     NSURLSession *session = [NSURLSession sharedSession];  11       12     //2.根据会话对象创建task  13     NSURL *url = [NSURL URLWithString:@"http://120.25.226.186:32812/login"];  14       15     //3.创建可变的请求对象  16     NSMutableURLRequest *request = [NSMutableURLRequest requestWithURL:url];  17       18     //4.修改请求方法为POST  19     request.HTTPMethod = @"POST";  20       21     //5.设置请求体  22     request.HTTPBody = [@"username=520it&pwd=520it&type=JSON" dataUsingEncoding:NSUTF8StringEncoding];  23       24     //6.根据会话对象创建一个Task(发送请求)  25     /*  26      第一个参数:请求对象  27      第二个参数:completionHandler回调(请求完成【成功|失败】的回调)  28                 data:响应体信息(期望的数据)  29                 response:响应头信息,主要是对服务器端的描述  30                 error:错误信息,如果请求失败,则error有值  31      */  32     NSURLSessionDataTask *dataTask = [session dataTaskWithRequest:request completionHandler:^(NSData * _Nullable data, NSURLResponse * _Nullable response, NSError * _Nullable error) {  33           34         //8.解析数据  35         NSDictionary *dict = [NSJSONSerialization JSONObjectWithData:data options:kNilOptions error:nil];  36         NSLog(@"%@",dict);  37           38     }];  39       40     //7.执行任务  41     [dataTask resume];  42 }    发送POST请求的方法

四、NSURLSession代理方法简单介绍

有的时候,我们可能需要监听网络请求的过程(如下载文件需监听文件下载进度),那么就需要用到代理方法。

接下来通过代码简单说明NSURLSession中普通网络请求会涉及代理方法的使用

 1 #import "ViewController.h"   2    3 @interface ViewController ()<NSURLSessionDataDelegate>   4 @property (nonatomic, strong) NSMutableData *responseData;   5 @end   6    7 @implementation ViewController   8    9 -(NSMutableData *)responseData  10 {  11     if (_responseData == nil) {  12         _responseData = [NSMutableData data];  13     }  14     return _responseData;  15 }  16   17 //当点击控制器View的时候会调用该方法  18 -(void)touchesBegan:(NSSet<UITouch *> *)touches withEvent:(UIEvent *)event  19 {  20     [self delegateTest];  21 }  22   23 //发送请求,代理方法  24 -(void)delegateTest  25 {  26     //1.确定请求路径  27     NSURL *url = [NSURL URLWithString:@"http://120.25.226.186:32812/login?username=520it&pwd=520it&type=JSON"];  28       29     //2.创建请求对象  30     //请求对象内部默认已经包含了请求头和请求方法(GET)  31     NSURLRequest *request = [NSURLRequest requestWithURL:url];  32       33     //3.获得会话对象,并设置代理  34     /*  35      第一个参数:会话对象的配置信息defaultSessionConfiguration 表示默认配置  36      第二个参数:谁成为代理,此处为控制器本身即self  37      第三个参数:队列,该队列决定代理方法在哪个线程中调用,可以传主队列|非主队列  38      [NSOperationQueue mainQueue]   主队列:   代理方法在主线程中调用  39      [[NSOperationQueue alloc]init] 非主队列: 代理方法在子线程中调用  40      */  41     NSURLSession *session = [NSURLSession sessionWithConfiguration:[NSURLSessionConfiguration defaultSessionConfiguration] delegate:self delegateQueue:[NSOperationQueue mainQueue]];  42       43     //4.根据会话对象创建一个Task(发送请求)  44     NSURLSessionDataTask *dataTask = [session dataTaskWithRequest:request];  45       46     //5.执行任务  47     [dataTask resume];  48 }  49   50 //1.接收到服务器响应的时候调用该方法  51 -(void)URLSession:(NSURLSession *)session dataTask:(NSURLSessionDataTask *)dataTask didReceiveResponse:(NSURLResponse *)response completionHandler:(void (^)(NSURLSessionResponseDisposition))completionHandler  52 {  53     //在该方法中可以得到响应头信息,即response  54     NSLog(@"didReceiveResponse--%@",[NSThread currentThread]);  55       56     //注意:需要使用completionHandler回调告诉系统应该如何处理服务器返回的数据  57     //默认是取消的  58     /*  59         NSURLSessionResponseCancel = 0,        默认的处理方式,取消  60         NSURLSessionResponseAllow = 1,         接收服务器返回的数据  61         NSURLSessionResponseBecomeDownload = 2,变成一个下载请求  62         NSURLSessionResponseBecomeStream        变成一个流  63      */  64       65     completionHandler(NSURLSessionResponseAllow);  66 }  67   68 //2.接收到服务器返回数据的时候会调用该方法,如果数据较大那么该方法可能会调用多次  69 -(void)URLSession:(NSURLSession *)session dataTask:(NSURLSessionDataTask *)dataTask didReceiveData:(NSData *)data  70 {  71     NSLog(@"didReceiveData--%@",[NSThread currentThread]);  72       73     //拼接服务器返回的数据  74     [self.responseData appendData:data];  75 }  76   77 //3.当请求完成(成功|失败)的时候会调用该方法,如果请求失败,则error有值  78 -(void)URLSession:(NSURLSession *)session task:(NSURLSessionTask *)task didCompleteWithError:(NSError *)error  79 {  80     NSLog(@"didCompleteWithError--%@",[NSThread currentThread]);  81       82     if(error == nil)  83     {  84         //解析数据,JSON解析请参考http://www.cnblogs.com/wendingding/p/3815303.html  85         NSDictionary *dict = [NSJSONSerialization JSONObjectWithData:self.responseData options:kNilOptions error:nil];  86         NSLog(@"%@",dict);  87     }  88 }  89 @end

代码执行结果: