NSURLSession基本使用
使用步骤
NSURLSession支持HTTP 2.0协议 , 可以通过sharedSession
获取单例对象,来创建task,然后执行task如何获取NSURLSession管理者对象
单例获取 : NSURLSession *session = [NSURLSession sharedSession];
自定义Session +(NSURLSession *)sessionWithConfiguration:(NSURLSessionConfiguration *)configuration delegate:(id<NSURLSessionDelegate>)delegatedelegateQueue:(NSOperationQueue *)queue;
-
关于task
1.NSURLSessionTask是一个抽象类,本身不能使用,只能使用它的子类
2.NSURLSessionDataTask\NSURLSessionUploadTask\NSURLSessionDownloadTask
NSURLSessionTask常见的方法
- (void)suspend; // 暂停
- (void)resume; // 恢复
- (void)cancel; // 取消NSURLSessionTask常见的属性
@property (readonly, copy) NSError *error; // 错误
@property (readonly, copy) NSURLResponse *response; // 响应NSURLSessionDownloadTask常见方法
-(void)cancelByProducingResumeData:(void (^)(NSData *resumeData ))completionHandler; // 取消任务
NSURLSession发送网络请求
**注意 : **通过NSURLSession发送的网络请求都是在子线程中异步执行的
- 通过GET方式发送请求
- 方法一 :
dataTaskWithRequest:request
- 方法一 :
//1.创建NSURLSession对象(可以获取单例对象)
NSURLSession *session = [NSURLSession sharedSession];
//2.根据NSURLSession对象创建一个Task
NSURL *url = [NSURL URLWithString:@"http://120.25.226.186:32812/login?username=ss&pwd=ss&type=JSON"];
NSURLRequest *request = [NSURLRequest requestWithURL:url];
//方法参数说明
/*
注意:该block是在子线程中调用的,如果拿到数据之后要做一些UI刷新操作,那么需要回到主线程刷新
第一个参数:需要发送的请求对象
block:当请求结束拿到服务器响应的数据时调用block
block-NSData:该请求的响应体
block-NSURLResponse:存放本次请求的响应信息,响应头,真实类型为NSHTTPURLResponse
block-NSErroe:请求错误信息
*/
//注意!!!completionHandler 是在子线程中执行的
NSURLSessionDataTask * dataTask = [session dataTaskWithRequest:request completionHandler:^(NSData * __nullable data, NSURLResponse * __nullable response, NSError * __nullable error) {
//拿到响应头信息
NSHTTPURLResponse *res = (NSHTTPURLResponse *)response;
//4.解析拿到的响应数据
NSLog(@"%@\n%@",[[NSString alloc]initWithData:data encoding:NSUTF8StringEncoding],res.allHeaderFields);
}];
//3.执行Task
//注意:刚创建出来的task默认是挂起状态的,需要调用该方法来启动任务(执行任务)
[dataTask resume];
- 方式二 : `dataTaskWithURL:completionHandler:`
**注意 : **
1.不能修改或者设置请求头信息
2.该方法内部默认会把URL对象包装成一个NSURLRequest对象(默认是GET请求)
//注意:该方法内部默认会把URL对象包装成一个NSURLRequest对象(默认是GET请求)
//方法参数说明
/*
//第一个参数:发送请求的URL地址
//block:当请求结束拿到服务器响应的数据时调用block
//block-NSData:该请求的响应体
//block-NSURLResponse:存放本次请求的响应信息,响应头,真实类型为NSHTTPURLResponse
//block-NSErroe:请求错误信息
*/
-(nullable NSURLSessionDataTask *)dataTaskWithURL:(NSURL *)url completionHandler:(void (^)(NSData * __nullable data, NSURLResponse * __nullable response, NSError * __nullable error))completionHandler;
-
通过POST方式发送请求
步骤 : **
1.确定请求路径
2.创建请求对象 NSMutableURLRequest(注意:** 一定是可变类型, 才能修改请求方法)
3.修改请求方法为POST 设置请求体(参数)
4.创建NSURLSession对象(获取单例对象) 根据NSURLSession对象创建一个Task, 并执行Task(注意:发送请求的方法是在子线程中异步执行 在 task 任务回调中解析数据)
//1.创建NSURLSession对象(可以获取单例对象)
NSURLSession *session = [NSURLSession sharedSession];
//2.根据NSURLSession对象创建一个Task
NSURL *url = [NSURL URLWithString:@"http://120.25.226.186:32812/login"];
//创建一个请求对象,并这是请求方法为POST,把参数放在请求体中传递
NSMutableURLRequest *request = [NSMutableURLRequest requestWithURL:url];
request.HTTPMethod = @"POST";
request.HTTPBody = [@"username=520it&pwd=520it&type=JSON" dataUsingEncoding:NSUTF8StringEncoding];
NSURLSessionDataTask *dataTask = [session dataTaskWithRequest:request completionHandler:^(NSData * __nullable data, NSURLResponse * __nullable response, NSError * __nullable error) {
//拿到响应头信息
NSHTTPURLResponse *res = (NSHTTPURLResponse *)response;
//解析拿到的响应数据
NSLog(@"%@\n%@",[[NSString alloc]initWithData:data encoding:NSUTF8StringEncoding],res.allHeaderFields);
}];
//3.执行Task
//注意:刚创建出来的task默认是挂起状态的,需要调用该方法来启动任务(执行任务)
[dataTask resume];
-
NSURLSession的代理及代理方法
**如何创建代理 : **sessionWithConfiguration:delegate:delegateQueue:
**参数解析 : **
第一参数: 配置信息 一般是选择默认配置 defaultSessionConfiguration
第二参数: 设置代理 一般是 self 成为代理
第三参数: 队列 控制的是代理方法在哪个线程中调用
注意:
1.代理方法默认是在子线程中执行
2.使用 session 对象创建 task 任务, 并执行 task,发送请求的方法是在子线程中异步执行
通过代理实现网络任务的请求
**步骤 : **
1.获取请求路径
2.创建请求对象(只有是可变的才可以设置请求的属性)
3.创建会话管理者,并设置代理
4.由会话管理者通过请求对象,创建task
5.执行task
//1.确定请求路径
NSURL *url = [NSURL URLWithString:@"http://120.25.226.186:32812/login?username=520it&pwd=520it&type=JSON"];
//2.创建请求对象
NSMutableURLRequest *request = [NSMutableURLRequest requestWithURL:url];
request.timeoutInterval = 0.00001;
//3.创建session,设置代理
/*
第一个参数:配置信息 defaultSessionConfiguration
第二个参数:self 成为代理
第三个参数:队列 控制的是代理方法在哪个线程中调用
*/
//delegateQueue nil 代理方法默认是在子线程执行的
NSURLSession *session = [NSURLSession sessionWithConfiguration:[NSURLSessionConfiguration defaultSessionConfiguration] delegate:self delegateQueue:nil];
//4.创建task
NSURLSessionDataTask *dataTask = [session dataTaskWithRequest:request];
//5.执行tak
[dataTask resume];
- **常用的代理方法**
1.当接收到服务器响应的时候调用
//1.当接收到服务器响应的时候调用
-(void)URLSession:(NSURLSession *)session dataTask:(NSURLSessionDataTask *)dataTask didReceiveResponse:(NSURLResponse *)response completionHandler:(void (^)(NSURLSessionResponseDisposition))completionHandler
{
//注意:这里的completionHandler Block参数,已经由系统实现了的,需要我们回调的.
// 注意: 当看到回调的方法 只有类型没有参数的时候, 则不是系统自动帮忙回调, 而是需要我们自己手动回调
NSLog(@"didReceiveResponse--%@",[NSThread currentThread]);
//需要我们告诉系统应该如何处理服务器返回的数据
/*
NSURLSessionResponseCancel = 0, 取消请求,默认做法
NSURLSessionResponseAllow = 1, 接收数据
NSURLSessionResponseBecomeDownload = 2, 编程下载请求
NSURLSessionResponseBecomeStream 变成流
*/
completionHandler(NSURLSessionResponseAllow);
}
2.当接收到服务器返回数据的时候调用 可能会被调用多次
//2.当接收到服务器返回数据的时候调用 可能会被调用多次
-(void)URLSession:(NSURLSession *)session dataTask:(NSURLSessionDataTask *)dataTask didReceiveData:(NSData *)data
{
NSLog(@"didReceiveData");
[self.resultData appendData:data];
}
3.当请求完成或者是失败的时候调用
//3.当请求完成或者是失败的时候调用
-(void)URLSession:(NSURLSession *)session task:(NSURLSessionTask *)task didCompleteWithError:(NSError *)error
{
NSLog(@"didCompleteWithError");
if(error)
{
NSLog(@"%@",error);
return;
}
//解析数据
// NSLog(@"%@",[[NSString alloc]initWithData:self.resultData encoding:NSUTF8StringEncoding]);
}