一.为什么要使用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 ()<NSURLSessionDataDelegate>
/**存放接受的信息*/
@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
<?PHP
#获取用户输入的姓名和密码
$name = $_GET["name"];
$pwd = $_GET["password"];
$user = array(
"name"=>$name,
"password"=>$pwd,
);
$result = array(
"user"=>$user,
"total"=>"2",
"status"=>0,
);
header('Content-Type:application/json');
echo json_encode($result);
?>
//AF_Hello_Post.php
<?PHP
#获取用户输入的姓名和密码
$name = $_POST["name"];
$pwd = $_POST["password"];
$user = array(
"name"=>$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 ()<NSURLSessionDataDelegate>
/**存放接受的信息*/
@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
