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


    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)

      示例代码:

    发送GET请求的第一种方法

    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请求的第二种方法

    -(void)get2
    {
        //1.确定请求路径
        NSURL *url = [NSURL URLWithString:@"http://120.25.226.186:32812/login?username=520it&pwd=520it&type=JSON"];
        
        //2.获得会话对象
        NSURLSession *session = [NSURLSession sharedSession];
        
        //3.根据会话对象创建一个Task(发送请求)
        /*
         第一个参数:请求路径
         第二个参数:completionHandler回调(请求完成【成功|失败】的回调)
                   data:响应体信息(期望的数据)
                   response:响应头信息,主要是对服务器端的描述
                   error:错误信息,如果请求失败,则error有值
         注意:
            1)该方法内部会自动将请求路径包装成一个请求对象,该请求对象默认包含了请求头信息和请求方法(GET)
            2)如果要发送的是POST请求,则不能使用该方法
         */
        NSURLSessionDataTask *dataTask = [session dataTaskWithURL:url completionHandler:^(NSData * _Nullable data, NSURLResponse * _Nullable response, NSError * _Nullable error) {
            
            //5.解析数据
            NSDictionary *dict = [NSJSONSerialization JSONObjectWithData:data options:kNilOptions error:nil];
            NSLog(@"%@",dict);
            
        }];
        
        //4.执行任务
        [dataTask resume];
    }
    
    发送GET请求的第二种方法

      执行结果:

     

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

     

    字典分类种重写系统方法:

    #import "NSDictionary+Log.h"
    
    @implementation NSDictionary (Log)
    
    -(NSString *)descriptionWithLocale:(id)locale indent:(NSUInteger)level
    {
        //初始化可变字符串
        NSMutableString *string = [NSMutableString string];
        //拼接开头[
        [string appendString:@"["];
        
        //拼接字典中所有的键值对
        [self enumerateKeysAndObjectsUsingBlock:^(id  _Nonnull key, id  _Nonnull obj, BOOL * _Nonnull stop) {
            [string appendFormat:@"%@:",key];
            [string appendFormat:@"%@",obj];
        }];
        
        //拼接结尾]
        [string appendString:@"]"];
        
        return string;
    }
    
    @end
    
    字典分类中重写系统方法

      执行结果:

     

    三、发送POST请求

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

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

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

        3)修改请求方法为POST

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

        5)创建会话对象(NSURLSession)

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

        7)执行Task

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

      示例代码:

    发送POST请求的方法

    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 }

    四、NSURLSession代理方法简单介绍

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

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

    #import "ViewController.h"
    
    @interface ViewController ()<NSURLSessionDataDelegate>
    @property (nonatomic, strong) NSMutableData *responseData;
    @end
    
    @implementation ViewController
    
    -(NSMutableData *)responseData
    {
        if (_responseData == nil) {
            _responseData = [NSMutableData data];
        }
        return _responseData;
    }
    
    //当点击控制器View的时候会调用该方法
    -(void)touchesBegan:(NSSet<UITouch *> *)touches withEvent:(UIEvent *)event
    {
        [self delegateTest];
    }
    
    //发送请求,代理方法
    -(void)delegateTest
    {
        //1.确定请求路径
        NSURL *url = [NSURL URLWithString:@"http://120.25.226.186:32812/login?username=520it&pwd=520it&type=JSON"];
        
        //2.创建请求对象
        //请求对象内部默认已经包含了请求头和请求方法(GET)
        NSURLRequest *request = [NSURLRequest requestWithURL:url];
        
        //3.获得会话对象,并设置代理
        /*
         第一个参数:会话对象的配置信息defaultSessionConfiguration 表示默认配置
         第二个参数:谁成为代理,此处为控制器本身即self
         第三个参数:队列,该队列决定代理方法在哪个线程中调用,可以传主队列|非主队列
         [NSOperationQueue mainQueue]   主队列:   代理方法在主线程中调用
         [[NSOperationQueue alloc]init] 非主队列: 代理方法在子线程中调用
         */
        NSURLSession *session = [NSURLSession sessionWithConfiguration:[NSURLSessionConfiguration defaultSessionConfiguration] delegate:self delegateQueue:[NSOperationQueue mainQueue]];
        
        //4.根据会话对象创建一个Task(发送请求)
        NSURLSessionDataTask *dataTask = [session dataTaskWithRequest:request];
        
        //5.执行任务
        [dataTask resume];
    }
    
    //1.接收到服务器响应的时候调用该方法
    -(void)URLSession:(NSURLSession *)session dataTask:(NSURLSessionDataTask *)dataTask didReceiveResponse:(NSURLResponse *)response completionHandler:(void (^)(NSURLSessionResponseDisposition))completionHandler
    {
        //在该方法中可以得到响应头信息,即response
        NSLog(@"didReceiveResponse--%@",[NSThread currentThread]);
        
        //注意:需要使用completionHandler回调告诉系统应该如何处理服务器返回的数据
        //默认是取消的
        /*
            NSURLSessionResponseCancel = 0,        默认的处理方式,取消
            NSURLSessionResponseAllow = 1,         接收服务器返回的数据
            NSURLSessionResponseBecomeDownload = 2,变成一个下载请求
            NSURLSessionResponseBecomeStream        变成一个流
         */
        
        completionHandler(NSURLSessionResponseAllow);
    }
    
    //2.接收到服务器返回数据的时候会调用该方法,如果数据较大那么该方法可能会调用多次
    -(void)URLSession:(NSURLSession *)session dataTask:(NSURLSessionDataTask *)dataTask didReceiveData:(NSData *)data
    {
        NSLog(@"didReceiveData--%@",[NSThread currentThread]);
        
        //拼接服务器返回的数据
        [self.responseData appendData:data];
    }
    
    //3.当请求完成(成功|失败)的时候会调用该方法,如果请求失败,则error有值
    -(void)URLSession:(NSURLSession *)session task:(NSURLSessionTask *)task didCompleteWithError:(NSError *)error
    {
        NSLog(@"didCompleteWithError--%@",[NSThread currentThread]);
        
        if(error == nil)
        {
            //解析数据,JSON解析请参考http://www.cnblogs.com/wendingding/p/3815303.html
            NSDictionary *dict = [NSJSONSerialization JSONObjectWithData:self.responseData options:kNilOptions error:nil];
            NSLog(@"%@",dict);
        }
    }
    @end

      代码执行结果:

  • 相关阅读:
    SQL一条语句统计记录总数及各状态数
    火狐登录国际账户
    HTML基础笔记
    增强for、lambda for、stream 遍历List 结束方法 or 跳过循环本次循环
    nginx
    前端问题总结
    Node.js
    Actuator
    ssh免密登录实现及Python实现
    【Mac渗透测试】之SQL注入Demo
  • 原文地址:https://www.cnblogs.com/yipingios/p/5562805.html
Copyright © 2020-2023  润新知