iOS网络开发使用NSURLSession

Posted 2020-06-17

• NSURLSession介绍

NSURLSession在ios7.0开始引入，在框架中的地位与NSURLConnection并列

    NSURLSession能够完成所有NSURLConnection的功能，并且进行了非常大的功能扩充

从iOS9.0开始，苹果正式弃用NSURLConnection

下图为NSURLSession的使用过程涉及到的主要类即它们之间的关系

     

三种工作模式：

     默认会话模式：类似于NSURLConnection，使用磁盘缓存

     瞬时会话模式：不使用磁盘缓存

     后台会话模式：在程序进入后台时也能上传或下载

     NSURLSessionConfigration用于生成这三种工作模式的配置，方法如下

+ (NSURLSessionConfiguration *)defaultSessionConfiguration
+ (NSURLSessionConfiguration *)ephemeralSessionConfiguration
+ (NSURLSessionConfiguration *)backgroundSessionConfigurationWithIdentifier:(NSString *)identifier

NSURLSession会话对象的创建：

// 使用默认会话模式、默认的缓存、cookie及credential
+ (NSURLSession *)sharedSession
// 使用指定的工作模式
+ (NSURLSession *)sessionWithConfiguration:(NSURLSessionConfiguration*)configuration
// 使用指定的工作模式、任务运行时的队列、代理
+ (NSURLSession *)sessionWithConfiguration:(NSURLSessionConfiguration*)configuration delegate:(id<NSURLSessionDelegate>)delegate delegateQueue:(NSOperationQueue *)queue

NSURLSession发送网络请求的使用步骤：

    a. 创建任务对象

    b. 控制任务的执行

    c. 在block或代理方法中获得任务执行的结果

支持的三种任务：（任务的基类NSURLSessionTask）

     数据任务  使用NSURLSessionDataTask描述

     下载任务  使用NSURLSessionDownloadTask描述

     上传任务  使用NSURLSessionUploadTask描述

• 任务对象的

NSURLSession中的任务对象NSURLSessionTask，全部由NSURLSession对象创建

    强调：异步操作不会阻塞当前代码的执行，无法通过返回值或参数获得结果

NSURLSessionTask任务对象的状态：

@property(readonly) NSURLSessionTaskState state
typedef NS_ENUM (NSInteger, NSURLSessionTaskState ) {
    NSURLSessionTaskStateRunning = 0,     // 运行状态
    NSURLSessionTaskStateSuspended = 1,   // 挂起状态
    NSURLSessionTaskStateCanceling = 2, // 取消状态
    NSURLSessionTaskStateCompleted = 3, // 完成状态
};

当一个任务对象被创建后，任务的状态为挂起状态

控制任务执行（修改任务状态）的方法：

- (void)cancel     // 取消任务
- (void)resume     // 运行任务
- (void)suspend    // 挂起任务

• 数据任务 — block方式获得结果

数据任务创建：

- (NSURLSessionDataTask *)dataTaskWithURL:(NSURL *)url completionHandler:(void (^)(NSData *data, NSURLResponse *response, NSError *error))completionHandler
- (NSURLSessionDataTask *)dataTaskWithRequest:(NSURLRequest *)request completionHandler:(void (^)(NSData *data, NSURLResponse *response, NSError*error))completionHandler

    在block中处理请求后的结果（响应数据、响应对象、错误对象）

    如：发送一个GET请求，获取指定游戏任务信息的JSON数据

NSString *urlStr = @"http://localhost/lolShow.php?number=20&from=0";
NSURL * url = [NSURL URLWithString:urlStr];
NSURLRequest * request = [NSURLRequest requestWithURL:url];
//创建数据任务
NSURLSession * session = [NSURLSession sharedSession];
NSURLSessionDataTask * dataTask = [session dataTaskWithRequest:request completionHandler:^(NSData * __nullable data, NSURLResponse * __nullable response, NSError * __nullable error) {
    if ( error ) {
        NSLog(@"1 %@", [error localizedDescription]);
        return ;
    }
    //将JSON数据序列化为OC对象
    NSArray * arr = [NSJSONSerialization JSONObjectWithData:data options:0 error:&error];
    if ( error ) {
        NSLog(@"2 %@", [error localizedDescription]);
        return ;
    }
    //字典转模型
    for (NSDictionary * dict in arr ) {
        AMHeroModel * model = [AMHeroModel heroModelWithDict:dict];
        [self.heroInfoArray addObject:model];
    }
    [[NSOperationQueue mainQueue] addOperationWithBlock:^{
        [self stopLoading];//刷新UI
    }];
}];
//启动任务
[dataTask resume];

• 数据任务 — 代理方式获得结果

数据任务的创建：

- (NSURLSessionDataTask *)dataTaskWithURL:(NSURL *)url
- (NSURLSessionDataTask *)dataTaskWithRequest:(NSURLRequest *)request

NSURLSession的代理属性

@property(readonly, retain) id< NSURLSessionDelegate > delegate

    涉及的代理协议： <NSURLSessionDelegate><NSURLSessionTaskDelegate>

          <NSURLSessionDataDelegate><NSURLSessionDownloadDelegate>

数据任务常用的代理方法：

//接收到应答对象
- (void)URLSession:(NSURLSession *)session dataTask:(NSURLSessionDataTask*)dataTask didReceiveResponse:(NSURLResponse *)response completionHandler:(void (^)(NSURLSessionResponseDisposition disposition))completionHandler
//接收到数据（可能执行多次）
- (void)URLSession:(NSURLSession *)session dataTask:(NSURLSessionDataTask*)dataTask didReceiveData:(NSData *)data
//完成一个请求的应答过程
- (void)URLSession:(NSURLSession *)session task:(NSURLSessionTask *)task didCompleteWithError:(NSError *)error

     

本文出自 “安萌” 博客，请务必保留此出处http://annmeng.blog.51cto.com/3321237/1746703