NSURLSession简单指南

NSURLSession 类别

• default session：允许通过代理对象，逐步获取数据，基于硬盘的持久化 Cache，保存用户的证书到钥匙串,使用共享 cookie 存储
• Ephemeral session：不向硬盘写入缓存、cookie、证书等信息
• Background session：允许在 app 不运行时，上传或下载内容

URLSesion Task 类别

• Data Task：使用 NSData 上传和接收数据，适用于短时、频繁交互的请求
• Upload tasks：类似于 Data Task，但是支持后台上传，数据格式通常为文件
• Download task：按照文件格式接收数据，支持后台下载

NSURLSessionTask 生命周期

• 暂停
• 执行
• 取消
• 完成

NSURLRequest 缓存策略

• NSURLRequestUseProtocolCachePolicy = 0 默认的缓存策略， 如果缓存不存在，直接从服务端获取。如果缓存存在，会根据 response 中的 Cache-Control 字段判断下一步操作，如: Cache-Control 字段为 must-revalidata, 则询问服务端该数据是否有更新，无更新的话直接返回给用户缓存数据，若已更新，则请求服务端
• NSURLRequestReloadIgnoringLocalCacheData = 1 忽略本地缓存数据，直接请求服务端
• NSURLRequestReloadIgnoringLocalAndRemoteCacheData = 4 未实现，忽略本地缓存，代理服务器以及其他中介，直接请求源服务端
• NSURLRequestReloadIgnoringCacheData = NSURLRequestReloadIgnoringLocalCacheData 忽略本地缓存数据，直接请求服务端
• NSURLRequestReturnCacheDataElseLoad = 2 有缓存就使用，不管其有效性(即忽略 Cache-Control 字段), 无则请求服务端
• NSURLRequestReturnCacheDataDontLoad = 3 只加载本地缓存. 没有就失败(确定当前无网络时使用)
• NSURLRequestReloadRevalidatingCacheData = 5 未实现，缓存数据必须得得到服务端确认有效才使用

NSURLSession 代理对象：

• NSURLSessionDelegate : session-level 的代理方法
• NSURLSessionTaskDelegate : task-level 面向 all 的代理方法
• NSURLSessionDataDelegate : task-level 面向 data 和 upload 的代理方法
• NSURLSessionDownloadDelegate : task-level 面向 download 的代理方法
• NSURLSessionStreamDelegate : task-level 面向 stream 的代理方法

NSURLSessionTaskMetrics 统计时间点

• fetchStartDate 请求发起时间
• domainLookupStartDate DNS 查询开启时间
• domainLookupEndDate DNS 查询结束时间
• connectStartDate 连接开始建立时间
• secureConnectionStartDate 加密连接开始握手通信时间
• secureConnectionEndDate 加密连接完成时间
• connectEndDate 连接完成建立时间
• requestStartDate 请求开始发送时间
• requestEndDate 请求完成发送时间
• responseStartDate 响应开始接收时间
• responseEndDate 响应完成接收时间

NSURLSession 简易使用

最简易的使用 URLSession 方法

/**
 简单使用默认的 Session 创建一个 task
 */
- (void)p_simpleUseSession
{
    NSURL *testUrl = [NSURL URLWithString:@"http://www.baidu.com"];
    NSURLSessionTask *task = [[NSURLSession sharedSession] dataTaskWithURL:testUrl completionHandler:^(NSData * _Nullable data, NSURLResponse * _Nullable response, NSError * _Nullable error) {
        // 非主线程回调
        if (error) {
            NSLog(@"%@", error.userInfo);
            return;
        }
        if (![response isKindOfClass:[NSHTTPURLResponse class]]) {
            NSLog(@"不是 HTTP response");
            return;
        }
        NSHTTPURLResponse *httpResponse = (NSHTTPURLResponse *)response;
        NSLog(@"StatusCode------%ld", httpResponse.statusCode);
        NSLog(@"%@", [[NSString alloc] initWithData:data encoding:NSUTF8StringEncoding]);
    }];
    [task resume];
}

自定义 URLSession

- (void)p_useCustomSession
{
    NSURL *testUrl = [NSURL URLWithString:@"http://www.baidu.com"];
    NSURLSessionConfiguration *configuration = [NSURLSessionConfiguration defaultSessionConfiguration];
    configuration.waitsForConnectivity = YES;
    // delegateQueue 用于指定回调方法的线程，必须是一个串行队列以确保回调顺序，传nil时默认创建一个串行队列
    // NSURLSession 强持有 delegate，除非调用 invalidateAndCancel 或 finishTasksAndInvalidate 停止
    NSURLSession *customSession = [NSURLSession sessionWithConfiguration:configuration delegate:self delegateQueue:nil];
    NSURLSessionTask *task = [customSession dataTaskWithURL:testUrl];
    [task resume];
}

- (void)URLSession:(NSURLSession *)session dataTask:(NSURLSessionDataTask *)dataTask didReceiveResponse:(NSURLResponse *)response completionHandler:(void (^)(NSURLSessionResponseDisposition))completionHandler
{
    NSLog(@"%@", NSStringFromSelector(_cmd));
    completionHandler(NSURLSessionResponseAllow);
}

- (void)URLSession:(NSURLSession *)session dataTask:(NSURLSessionDataTask *)dataTask didReceiveData:(NSData *)data
{
    NSLog(@"%@", NSStringFromSelector(_cmd));
}

- (void)URLSession:(NSURLSession *)session task:(NSURLSessionTask *)task didCompleteWithError:(NSError *)error
{
    NSLog(@"%@", NSStringFromSelector(_cmd));
}