NSURLSession

一.为什么要使用NSURLSession来替换NSURLConnection

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

2.NSURLSession的优势:

  • NSURLSession支持http2.0协议
  • 处理下载任务的时候可以直接把数据下载到磁盘中
  • 支持后台下载和上传
  • 同一个session发送多次请求,只需要建立一次连接(复用了TCP)
  • 提供了全局的session并且可以统一配置,使用更加方便
  • 下载的时候是多线程异步处理,效率更高

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

4.NSURLSessionTask及其子类

NSURLSessionTask本身是一个抽象类,在使用的时候,通常是根据具体的需求使用它的几个子类
NSURLSessionDataTask可以用来发送常见的Get,Post请求,既可以用来上传也可以用来下载
NSURLSessionDownloadTask可以用来发送下载请求,专门用来下载数据
NSURLSessionUploadTask可以用来发送上传请求,专门用来上传数据

二.使用URLSession发送Get请求

2.1.过程:

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

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

3.创建会话对象(NSURLSession)

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

5.执行Task

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

2.2.代码示例:

1.确定请求路径

NSURL *url = [NSURL URLWithString:
           @"http://127.0.0.1/AF_Hello_Get.php?name=jack&password=123"];

对请求路径的说明:

http://127.0.0.1/AF_Hello_Get.php?name=jack&password=123

协议头(http://)+主机地址(127.0.0.1)+接口名称(AF_Hello_Get.php)+?+参数1(name=jack)+&+参数2(password=123)

Get请求,直接把请求参数跟在URL的后面以?隔开,多个参数之间以&符号拼接

2.创建请求对象

NSURLRequest *request = [NSURLRequest requestWithURL:url];

请求对象内部默认已经包含了请求头和请求方法(GET)

3.获得会话对象

NSURLSession *session = [NSURLSession sharedSession];

4.根据会话对象创建一个Task(发送请求),Get请求有两种方式

NSURLSessionDataTask *firsttask = [session dataTaskWithURL:url completionHandler:^(NSData * _Nullable data, NSURLResponse * _Nullable response, NSError * _Nullable error) {
     
 }];

第一个参数:请求路径
第二个参数:completionHandler回调(请求完成【成功|失败】的回调)
data:响应体信息(期望的数据)
response:响应头信息,主要是对服务器端的描述
error:错误信息,如果请求失败,则error有值

注意:
1)该方法内部会自动将请求路径包装成一个请求对象,该请求对象默认包含了请求头信息和请求方法(GET)
2)如果要发送的是POST请求,则不能使用该方法

NSURLSessionDataTask *secondtask = [session dataTaskWithRequest:request completionHandler:^(NSData * _Nullable data, NSURLResponse * _Nullable response, NSError * _Nullable error) {

}];

第一个参数:请求对象
第二个参数:completionHandler回调(请求完成【成功|失败】的回调)
data:响应体信息(期望的数据)
response:响应头信息,主要是对服务器端的描述
error:错误信息,如果请求失败,则error有值

5.解析服务器返回的数据

//说明(此处返回的数据是JSON格式的,因此使用NSJSONSerialization进行反序列化处理)

NSLog(@"Get请求返回的响应信息:%@",[NSJSONSerialization 
                JSONObjectWithData:data options:kNilOptions error:nil]);

6.执行任务

[firsttask resume];

[secondtask resume];

三.使用URLSession发送Post请求

2.1.过程:

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

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

3.修改请求方法为POST

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

5.创建会话对象(NSURLSession)

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

7.执行Task

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

2.2代码示例

1.确定请求路径

NSURL *url_post = [NSURL URLWithString:
                @"http://127.0.0.1/AF_Hello_Post.php"];

对请求路径的说明:

http://127.0.0.1/AF_Hello_Post.php

协议头(http://)+主机地址(127.0.0.1)+接口名称(AF_Hello_Get.php))

POST请求需要修改请求方法为POST,并把参数转换为二进制数据设置为请求体

2.创建可变的请求对象

NSMutableURLRequest *request_post = [NSMutableURLRequest 
                                            requestWithURL:url_post];

3.修改请求方法为POST

request_post.HTTPMethod = @"POST";

4.设置请求体

request_post.HTTPBody = [@"name=jack&password=123" 
                               dataUsingEncoding:NSUTF8StringEncoding];

5.创建会话对象

NSURLSession *session_post = [NSURLSession sharedSession];

6.根据会话对象创建一个Task(发送请求)

NSURLSessionDataTask *task_post = [session_post dataTaskWithRequest:request_post completionHandler:^(NSData * _Nullable data, NSURLResponse * _Nullable response, NSError * _Nullable error) {

}];

第一个参数:请求对象
第二个参数:completionHandler回调(请求完成【成功|失败】的回调)
data:响应体信息(期望的数据)
response:响应头信息,主要是对服务器端的描述
error:错误信息,如果请求失败,则error有值

7.解析服务器返回的数据

//说明:(此处返回的数据是JSON格式的,因此使用NSJSONSerialization进行反序列化处理)

NSLog(@"Post请求返回的响应信息:%@",[NSJSONSerialization JSONObjectWithData:_mData options:kNilOptions error:nil]);

8.执行任务

[task_post resume];

四.使用代理方法请求

有的时候,我们可能需要监听网络请求的过程,那么就需要用到代理方法。

1.确定请求路径

NSURL *url = [NSURL URLWithString:
           @"http://127.0.0.1/AF_Hello_Get.php?name=jack&password=123"];

2.创建请求对象

NSURLRequest *request = [NSURLRequest requestWithURL:url];

3.获得会话对象,并设置代理

NSURLSessionConfiguration *config = [NSURLSessionConfiguration 
                                           defaultSessionConfiguration];

NSURLSession *session = [NSURLSession 
                 sessionWithConfiguration:config 
                         delegate:self 
                            delegateQueue:[NSOperationQueue mainQueue]];

第一个参数:会话对象的配置信息defaultSessionConfiguration 表示默认配置
第二个参数:谁成为代理,此处为控制器本身即self
第三个参数:队列,该队列决定代理方法在哪个线程中调用,可以传主队列|非主队列
[NSOperationQueue mainQueue] 主队列: 代理方法在主线程中调用
[[NSOperationQueue alloc]init] 非主队列: 代理方法在子线程中调用

4.遵从协议,并定义一个变量用于接受信息

@interface ViewController ()

/**存放接受的信息*/
@property (nonatomic,strong) NSMutableData *mData;

@end

5.根据会话对象创建一个Task(发送请求)

NSURLSessionDataTask *task = [session 
                                    dataTaskWithRequest:request];

6.执行任务

[task resume];

7.代理方法,和NSURLConnection的类似

//1.接收到服务器响应的时候调用该方法
-(void)URLSession:(NSURLSession *)session dataTask:(NSURLSessionDataTask *)dataTask didReceiveResponse:(NSURLResponse *)response completionHandler:(void (^)(NSURLSessionResponseDisposition))completionHandler{
    
    //如果需要知道这个HTTP的所有信息,就需要获得NSURLResponse的子类
    NSHTTPURLResponse *htttpResponse = (NSHTTPURLResponse *)response;
    
    //打印信息
    NSLog(@"响应头信息:%@",htttpResponse.allHeaderFields);
    
    
    //定义一个容器用于接受服务器返回的数据
    self.mData = [NSMutableData data];

    //注意:和NSURLConnection不同点在于接收到响应信息之后,需要使用completionHandler回调告诉系统应该如何处理服务器返回的数据
    //默认是取消的(NSURLSessionResponseCancel),继续传递数据(NSURLSessionResponseAllow)
    completionHandler(NSURLSessionResponseAllow);
}

//2.接收到服务器返回数据的时候会调用该方法,如果数据较大那么该方法可能会调用多次
- (void)URLSession:(NSURLSession *)session dataTask:(NSURLSessionDataTask *)dataTask didReceiveData:(NSData *)data{
    
    //拼接服务器返回的数据
    [_mData appendData:data];
}

//3.当请求完成(成功|失败)的时候会调用该方法,如果请求失败,则error有值
- (void)URLSession:(NSURLSession *)session task:(NSURLSessionTask *)task didCompleteWithError:(NSError *)error{
    
    //解析服务器返回的数据
    //说明:(此处返回的数据是JSON格式的,因此使用NSJSONSerialization进行反序列化处理)
    NSLog(@"代理方法返回的响应信息:%@",[NSJSONSerialization JSONObjectWithData:_mData options:kNilOptions error:nil]);
}

五.完整代码以及运行结果

本地服务器的php代码

//AF_Hello_Get.php
$name,
             "password"=>$pwd,
    );


   $result = array(
              "user"=>$user,
              "total"=>"2",
              "status"=>0,
   );

    header('Content-Type:application/json');
    echo json_encode($result);
?>

//AF_Hello_Post.php
$name,
             "password"=>$pwd,
    );


   $result = array(
              "user"=>$user,
              "total"=>"2",
              "status"=>0,
   );

    header('Content-Type:application/json');
    echo json_encode($result);
?>

iOS的info.plist文件配置

iOS代码

//
//  ViewController.m
//  NSURLSession
//
//  Created by 许磊 on 2019/5/17.
//  Copyright © 2019年 许磊. All rights reserved.
//

#import "ViewController.h"

@interface ViewController ()

/**存放接受的信息*/
@property (nonatomic,strong) NSMutableData *mData;

@end

@implementation ViewController

- (void)viewDidLoad {
    [super viewDidLoad];

#pragma mark -------Get请求 ---------
    //1.确定请求路径
    NSURL *url = [NSURL URLWithString:@"http://127.0.0.1/AF_Hello_Get.php?name=jack&password=123"];
    
    //2.创建请求对象
    //请求对象内部默认已经包含了请求头和请求方法(GET)
    NSURLRequest *request = [NSURLRequest requestWithURL:url];
    
    //3.获得会话对象
    NSURLSession *session = [NSURLSession sharedSession];
    
    //4.根据会话对象创建一个Task(发送请求)
    /*
     第一个参数:请求路径
     第二个参数:completionHandler回调(请求完成【成功|失败】的回调)
     data:响应体信息(期望的数据)
     response:响应头信息,主要是对服务器端的描述
     error:错误信息,如果请求失败,则error有值
     
     注意:
     1)该方法内部会自动将请求路径包装成一个请求对象,该请求对象默认包含了请求头信息和请求方法(GET)
     2)如果要发送的是POST请求,则不能使用该方法
     */
    NSURLSessionDataTask *firsttask = [session dataTaskWithURL:url completionHandler:^(NSData * _Nullable data, NSURLResponse * _Nullable response, NSError * _Nullable error) {
        
        //5.解析服务器返回的数据
        //说明:(此处返回的数据是JSON格式的,因此使用NSJSONSerialization进行反序列化处理)
        NSLog(@"Get请求返回的响应信息1:%@",[NSJSONSerialization JSONObjectWithData:data options:kNilOptions error:nil]);
    }];
    
    //4.根据会话对象创建一个Task(发送请求)
    /*
     第一个参数:请求对象
     第二个参数:completionHandler回调(请求完成【成功|失败】的回调)
     data:响应体信息(期望的数据)
     response:响应头信息,主要是对服务器端的描述
     error:错误信息,如果请求失败,则error有值
     */
    NSURLSessionDataTask *secondtask = [session dataTaskWithRequest:request completionHandler:^(NSData * _Nullable data, NSURLResponse * _Nullable response, NSError * _Nullable error) {

        //5.解析服务器返回的数据
        //说明:(此处返回的数据是JSON格式的,因此使用NSJSONSerialization进行反序列化处理)
        NSLog(@"Get请求返回的响应信息2:%@",[NSJSONSerialization JSONObjectWithData:data options:kNilOptions error:nil]);
    }];

    //开始下载
    [firsttask resume];
    [secondtask resume];
    
#pragma mark -------Post请求 ---------
    //1.确定请求路径
    NSURL *url_post = [NSURL URLWithString:@"http://127.0.0.1/AF_Hello_Post.php"];
    
    //2.创建可变的请求对象
    NSMutableURLRequest *request_post = [NSMutableURLRequest requestWithURL:url_post];
    
    //3.修改请求方法为POST
    request_post.HTTPMethod = @"POST";
    
    //4.设置请求体
    request_post.HTTPBody = [@"name=jack&password=123" dataUsingEncoding:NSUTF8StringEncoding];
    
    //5.创建会话对象
    NSURLSession *session_post = [NSURLSession sharedSession];
    
    //6.根据会话对象创建一个Task(发送请求)
    /*
      第一个参数:请求对象
      第二个参数:completionHandler回调(请求完成【成功|失败】的回调)
                data:响应体信息(期望的数据)
                response:响应头信息,主要是对服务器端的描述
                error:错误信息,如果请求失败,则error有值
    */
    NSURLSessionDataTask *task_post = [session_post dataTaskWithRequest:request_post completionHandler:^(NSData * _Nullable data, NSURLResponse * _Nullable response, NSError * _Nullable error) {
        
        //7.解析服务器返回的数据
        //说明:(此处返回的数据是JSON格式的,因此使用NSJSONSerialization进行反序列化处理)
        NSLog(@"Post请求返回的响应信息:%@",[NSJSONSerialization JSONObjectWithData:_mData options:kNilOptions error:nil]);
    }];
    
    //8.执行任务
    [task_post resume];
}

- (void)viewDidAppear:(BOOL)animated {
    [super viewDidAppear:animated];
    
    //1.确定请求路径
    NSURL *url = [NSURL URLWithString:@"http://127.0.0.1/AF_Hello_Get.php?name=jack&password=123"];
    
    //2.创建请求对象
    //请求对象内部默认已经包含了请求头和请求方法(GET)
    NSURLRequest *request = [NSURLRequest requestWithURL:url];

    //3.获得会话对象,并设置代理
    /*
     第一个参数:会话对象的配置信息defaultSessionConfiguration 表示默认配置
     第二个参数:谁成为代理,此处为控制器本身即self
     第三个参数:队列,该队列决定代理方法在哪个线程中调用,可以传主队列|非主队列
     [NSOperationQueue mainQueue]   主队列:   代理方法在主线程中调用
     [[NSOperationQueue alloc]init] 非主队列: 代理方法在子线程中调用
     */
    NSURLSessionConfiguration *config = [NSURLSessionConfiguration defaultSessionConfiguration];
    NSURLSession *session = [NSURLSession sessionWithConfiguration:config delegate:self delegateQueue:[NSOperationQueue mainQueue]];

    //4.根据会话对象创建一个Task(发送请求)
    NSURLSessionDataTask *task = [session dataTaskWithRequest:request];

    //5.执行任务
    [task resume];
}

//1.接收到服务器响应的时候调用该方法
-(void)URLSession:(NSURLSession *)session dataTask:(NSURLSessionDataTask *)dataTask didReceiveResponse:(NSURLResponse *)response completionHandler:(void (^)(NSURLSessionResponseDisposition))completionHandler{
    
    //如果需要知道这个HTTP的所有信息,就需要获得NSURLResponse的子类
    NSHTTPURLResponse *htttpResponse = (NSHTTPURLResponse *)response;
    
    //打印信息
    NSLog(@"响应头信息:%@",htttpResponse.allHeaderFields);
    
    
    //定义一个容器用于接受服务器返回的数据
    self.mData = [NSMutableData data];

    //注意:和NSURLConnection不同点在于接收到响应信息之后,需要使用completionHandler回调告诉系统应该如何处理服务器返回的数据
    //默认是取消的(NSURLSessionResponseCancel),继续传递数据(NSURLSessionResponseAllow)
    completionHandler(NSURLSessionResponseAllow);
}

//2.接收到服务器返回数据的时候会调用该方法,如果数据较大那么该方法可能会调用多次
- (void)URLSession:(NSURLSession *)session dataTask:(NSURLSessionDataTask *)dataTask didReceiveData:(NSData *)data{
    
    //拼接服务器返回的数据
    [_mData appendData:data];
}

//3.当请求完成(成功|失败)的时候会调用该方法,如果请求失败,则error有值
- (void)URLSession:(NSURLSession *)session task:(NSURLSessionTask *)task didCompleteWithError:(NSError *)error{
    
    //解析服务器返回的数据
    //说明:(此处返回的数据是JSON格式的,因此使用NSJSONSerialization进行反序列化处理)
    NSLog(@"代理方法返回的响应信息:%@",[NSJSONSerialization JSONObjectWithData:_mData options:kNilOptions error:nil]);
}

@end

运行结果

2019-05-20 19:24:19.606069+0800 NSURLSession[7076:151492] 响应头信息:{
    Connection = "Keep-Alive";
    "Content-Length" = 64;
    "Content-Type" = "application/json";
    Date = "Mon, 20 May 2019 11:24:19 GMT";
    "Keep-Alive" = "timeout=5, max=100";
    Server = "Apache/2.4.25 (Unix) PHP/5.6.30";
    "X-Powered-By" = "PHP/5.6.30";
}
2019-05-20 19:24:19.606679+0800 NSURLSession[7076:151492] 代理方法返回的响应信息:{
    status = 0;
    total = 2;
    user =     {
        name = jack;
        password = 123;
    };
}
2019-05-20 19:24:19.607593+0800 NSURLSession[7076:151550] Post请求返回的响应信息:{
    status = 0;
    total = 2;
    user =     {
        name = jack;
        password = 123;
    };
}
2019-05-20 19:24:19.611332+0800 NSURLSession[7076:151552] Get请求返回的响应信息1:{
    status = 0;
    total = 2;
    user =     {
        name = jack;
        password = 123;
    };
}
2019-05-20 19:24:19.613122+0800 NSURLSession[7076:151552] Get请求返回的响应信息2:{
    status = 0;
    total = 2;
    user =     {
        name = jack;
        password = 123;
    };
}

demo链接
https://pan.baidu.com/s/1mZt_8GmV8ERKof7U6IMi5w
密码:o4gz

参考文章
https://www.cnblogs.com/zhao-jie-li/p/5848144.html

你可能感兴趣的:(NSURLSession)