iOS网络请求的使用

前言：苹果官方提供的网络请求API有两种: NSURLConnection、NSURLSession。
还有，目前的用的最多是主流框架：AFNetworking
iOS 7之前，只有 NSURLConncetion
iOS 9之后，苹果官方放弃NSURLConnection，推荐使用NSURLSession
本文将介绍iOS原生API和AFN的使用。

---

苹果官方API：

以下将分别讲述这两种请求的简单使用：

• NSURLConnection：

-(void)demo1{
    //访问百度首页
    
    //1. 创建一个网络请求
    NSURL *url = [NSURL URLWithString:@"http://m.baidu.com"];
    
    NSURLRequest *request = [NSURLRequest requestWithURL:url];
    
    //2. 发送网络请求  网络请求是个耗时操作，在子线程发送
    
    //第一种发送网络请求的方式
    
    /*
     * 利用 NSUrlConnection 发送一个异步的网络请求
     *
     * @param NSURLRequest 网络请求
     *
     * @return
     */
    //queue：操作队列，决定网络请求完成后的Block(completionHandler) 回调在那条线程执行
    //[NSOperationQueue mainQueue] 主线程
    //completionHandler ：block 回调：网络请求完成之后，就会自动调用这个 Block
    [NSURLConnection sendAsynchronousRequest:request queue:[NSOperationQueue mainQueue] completionHandler:^(NSURLResponse * _Nullable response, NSData * _Nullable data, NSError * _Nullable connectionError) {
        //response ： 响应：服务器的响应
        //data：二进制数据：服务器返回的数据。（就是我们想要的内容）
        //coonectionError：链接错误的信息
        NSLog(@"网络响应：response：%@",response);
        
        //根据返回的二进制数据，生成字符串！NSUTF8StringEncoding：编码方式
        NSString *html = [[NSString alloc]initWithData:data encoding:NSUTF8StringEncoding];
        
        //在客户端直接打开一个网页！
        //客户端服务器：UIWebView
        
        //实例化一个客户端浏览器
        UIWebView *web = [[UIWebView alloc]initWithFrame:self.view.bounds];
        
        //加载html字符串：baseURL：基准的地址：相对路径/绝对路径
        [web loadHTMLString:html baseURL:nil];
        
        //将浏览器加载到view上
        [self.view addSubview:web];
        
//        //在本地保存百度首页
//        [data writeToFile:@"/Users/Liu/Desktop/baidu.html" atomically:YES];
        
        NSLog(@"网路链接错误 connectionError响应：response：%@",connectionError);
    }];
}

• NSURLSession:

//NSURLSession
-(void)demo2{
    //访问百度首页
    
    //1. 创建一个网络请求
    NSURL *url = [NSURL URLWithString:@"http://m.baidu.com"];
    
    //2.创建请求对象
    NSURLRequest *request = [NSURLRequest requestWithURL:url];
    
    //3.获得会话对象
    NSURLSession *session=[NSURLSession sharedSession];
    
    //4.根据会话对象创建一个Task(发送请求）
    /*
     第一个参数：请求对象
     第二个参数：completionHandler回调（请求完成【成功|失败】的回调）
     data：响应体信息（期望的数据）
     response：响应头信息，主要是对服务器端的描述
     error：错误信息，如果请求失败，则error有值
     */
    NSURLSessionDataTask *dataTask=[session dataTaskWithRequest:request completionHandler:^(NSData * _Nullable data, NSURLResponse * _Nullable response, NSError * _Nullable error) {
            //response ： 响应：服务器的响应
            //data：二进制数据：服务器返回的数据。（就是我们想要的内容）
            //error：链接错误的信息
            NSLog(@"网络响应：response：%@",response);
        
            //根据返回的二进制数据，生成字符串！NSUTF8StringEncoding：编码方式
            NSString *html = [[NSString alloc]initWithData:data encoding:NSUTF8StringEncoding];
            
            //在客户端直接打开一个网页！
            //客户端服务器：UIWebView

            //将浏览器加载到view上
            dispatch_async(dispatch_get_main_queue(), ^{
            
            //实例化一个客户端浏览器
            UIWebView *web = [[UIWebView alloc]initWithFrame:self.view.bounds];
            
            //加载html字符串：baseURL：基准的地址：相对路径/绝对路径
            [web loadHTMLString:html baseURL:nil];
            [self.view addSubview:web];
            
            });
        
            //        //在本地保存百度首页
            //        [data writeToFile:@"/Users/Liu/Desktop/baidu.html" atomically:YES];
        
        }
    ];
    
    //5.执行任务
    [dataTask resume];
}

---

• 使用NSURLSession发送GET请求的方法和NSURLConnection类似，整个过程如下：
  　　　　1）确定请求路径（一般由公司的后台开发人员以接口文档的方式提供），GET请求参数直接跟在URL后面
  　　　　2）创建请求对象（默认包含了请求头和请求方法【GET】），此步骤可以省略
  　　　　3）创建会话对象（NSURLSession）
  　　　　4）根据会话对象创建请求任务（NSURLSessionDataTask）
  　　　　5）执行Task
  　　　　6）当得到服务器返回的响应后，解析数据（XML|JSON|HTTP）

• 使用NSURLSession发送POST请求的方法和NSURLConnection类似，整个过程如下：
  　　　　1）确定请求路径（一般由公司的后台开发人员以接口文档的方式提供）
  　　　　2）创建可变的请求对象（因为需要修改），此步骤不可以省略
  　　　　3）修改请求方法为POST
  　　　　4）设置请求体，把参数转换为二进制数据并设置请求体
  　　　　5）创建会话对象（NSURLSession）
  　　　　6）根据会话对象创建请求任务（NSURLSessionDataTask）
  　　　　7）执行Task
  　　　　8）当得到服务器返回的响应后，解析数据（XML|JSON|HTTP）

//post方法   
//1.创建会话对象
    NSURLSession *session=[NSURLSession sharedSession];

    //2.根据会话对象创建task
    NSURL *url=[NSURL URLWithString:@"http://123.207.175.144/Test1.php"];

    //3.创建可变的请求对象
    NSMutableURLRequest *request=[NSMutableURLRequest requestWithURL:url];

    //4.修改请求方法为POST
    request.HTTPMethod=@"POST";

    //5.设置请求体
    request.HTTPBody=[@"Login=1" dataUsingEncoding:NSUTF8StringEncoding];

    //6.根据会话对象创建一个Task(发送请求）
         /*
                  第一个参数：请求对象
                  第二个参数：completionHandler回调（请求完成【成功|失败】的回调）
                             data：响应体信息（期望的数据）
                             response：响应头信息，主要是对服务器端的描述
                             error：错误信息，如果请求失败，则error有值
          */
     NSURLSessionDataTask *dataTask = [session dataTaskWithRequest:request completionHandler:^(NSData * _Nullable data, NSURLResponse * _Nullable response, NSError * _Nullable error){

        //8.解析数据
        NSDictionary *dict=[NSJSONSerialization JSONObjectWithData:data options:kNilOptions error:nil];
        NSLog(@"%@",dict);
    }];

     //7.执行任务
    [dataTask resume];

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

//代理方法
#import "ViewController.h"

@interface ViewController ()<NSURLSessionDataDelegate>
@property (nonatomic, strong) NSMutableData *responseData;
@end

@implementation ViewController

-(NSMutableData *)responseData
 {
         if (_responseData == nil) {
                 _responseData = [NSMutableData data];
             }
         return _responseData;
}

- (void)viewDidLoad {
    [super viewDidLoad];
    // Do any additional setup after loading the view, typically from a nib.
     //[self performSelector:@selector(getAndSynchronousMethod)];
    [self delegateTest];
}

-(void)delegateTest
{
         //1.确定请求路径
         NSURL *url = [NSURL URLWithString:@"http://123.207.175.144/Test1.php?Login=1"];

         //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)
             {
                     //解析数据
                     NSDictionary *dict = [NSJSONSerialization JSONObjectWithData:self.responseData options:kNilOptions error:nil];
                     NSLog(@"%@",dict);
                 }
}

@end

如果返回的字符有汉字，可以为NSDictionary提供一个分类，重写系统中的方法。

//重写Dictionary
#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

---

AFNetworking：

AFNetworking开源库封装了原生的方法，
iOS9.0之后，
由于NSURLConnection的弃用，
AFNetworking的使用也有一些改变。

注：使用前需要导入AFN框架：AFN框架地址

• GET请求：

//GET请求
-(void)demo1{
    NSString *urlString = @"http://www.liubaiqi.cn";
    
    AFHTTPSessionManager *manger =[AFHTTPSessionManager manager];
    
    [manger GET:urlString parameters:nil progress:^(NSProgress * _Nonnull downloadProgress) {
        
    } success:^(NSURLSessionDataTask * _Nonnull task, id  _Nullable responseObject) {
        NSLog(@"成功");
    } failure:^(NSURLSessionDataTask * _Nullable task, NSError * _Nonnull error) {
        NSLog(@"%@",error);
    }];
}

• POST请求：

//POST请求
-(void)demo2{
    NSString *urlString = @"http://192.168.1.101:8080";
    
    AFHTTPSessionManager *manger =[AFHTTPSessionManager manager];
    
    NSMutableDictionary *parameter= @{@"":@"",@"":@""};
    
    [manger POST:urlString parameters:parameter progress:^(NSProgress * _NonnulluploadProgress){
        
    }success:^(NSURLSessionDataTask * _Nonnull task, id  _Nullable responseObject) {
        NSLog(@"成功");
    } failure:^(NSURLSessionDataTask * _Nullable task, NSError * _Nonnull error) {
        NSLog(@"%@",error);
    }];
}

• Download请求：

//DownLoad请求
-(void)demo3{
    //1. 创建NSURLSessionConfiguration
    NSURLSessionConfiguration *configuration = [NSURLSessionConfiguration defaultSessionConfiguration];
    
    //2. 创建管理者对象
    AFURLSessionManager *manager = [[AFURLSessionManager alloc]initWithSessionConfiguration:configuration];
    
    //3. 设置url
    NSURL *url = [NSURL URLWithString:@"http://127.0.0.1/1.mp4"];
    
    //4. 创建请求对象
    NSURLRequest *request = [NSURLRequest requestWithURL:url];
    
    //5. 下载任务
    NSURLSessionDownloadTask *downloadTask = [manager downloadTaskWithRequest:request progress:^(NSProgress * _Nonnull downloadProgress) {
        //打印下载进度
        NSLog(@"%lf",1.0*downloadProgress.completedUnitCount/downloadProgress.totalUnitCount);
        
    } destination:^NSURL * _Nonnull(NSURL * _Nonnull targetPath, NSURLResponse * _Nonnull response) {
        //设置下载路径
        NSURL *documentsDirectoryURL = [[NSFileManager defaultManager]URLForDirectory:NSDocumentDirectory inDomain:NSUserDomainMask appropriateForURL:nil create:NO error:nil];
        
        return [documentsDirectoryURL URLByAppendingPathComponent:[response suggestedFilename]];
        
    } completionHandler:^(NSURLResponse * _Nonnull response, NSURL * _Nullable filePath, NSError * _Nullable error) {
        //下载完成
        NSLog(@"File downloaded to : %@",filePath);
    }];
    //启动任务
    [downloadTask resume];
}

• Upload请求：

//UpLoad请求
-(void)demo4{
    //创建NSURLSessionConfiguration
    NSURLSessionConfiguration *configuration = [NSURLSessionConfiguration defaultSessionConfiguration];
    
    //创建管理者对象
    AFURLSessionManager *manager = [[AFURLSessionManager alloc]initWithSessionConfiguration:configuration];
    
    //设置url
    NSURL *url = [NSURL URLWithString:@"http://127.0.0.1"];
    //创建请求对象
    NSURLRequest *request = [NSURLRequest requestWithURL:url];
    //文件路径
    NSURL *filePath = [NSURL fileURLWithPath:@"file://Users/Liu/Desktop/Note"];
    
    //上传任务
    NSURLSessionUploadTask *uploadTask = [manager uploadTaskWithRequest:request fromFile:filePath progress:nil completionHandler:^(NSURLResponse * _Nonnull response, id  _Nullable responseObject, NSError * _Nullable error) {
        if(error){
            //错误
            NSLog(@"Error:%@",error);
        }else{
            //成功
            NSLog(@"Success %@ %@",response,responseObject);
        }
    }];
    //启动任务
    [uploadTask resume];
}

• 网络状态：

//网络状态
-(void)demo5{
    //1. 创建网络监测者
    AFNetworkReachabilityManager *manager = [AFNetworkReachabilityManager sharedManager];
    
    [manager setReachabilityStatusChangeBlock:^(AFNetworkReachabilityStatus status) {
        //监测网络改变
        switch (status) {
            case AFNetworkReachabilityStatusUnknown:
                NSLog(@"未知网络状态");
                break;
            case AFNetworkReachabilityStatusNotReachable:
                NSLog(@"无网络");
                break;
            case AFNetworkReachabilityStatusReachableViaWWAN:
                NSLog(@"蜂窝数据网络");
                break;
            case AFNetworkReachabilityStatusReachableViaWiFi:
                NSLog(@"WiFi网络");
                break;
                
            default:
                break;
        }
    }];
}

本文参考了组长的blog，以及自己学习时整理的一些小demo。
如果有错误，希望各位大神指出，我修改。

作者：MrLiuQ
链接：https://www.jianshu.com/p/c34f0740f178
來源：简书