iOS 网络访问 - NSURLSession

NSURLSession 概述

• NSURLSession iOS 7.0 发布
• 可以暂停、停止、重启网络任务
• 请求可以使用一样的 配置容器
• 除了 下载，block 和代理可以同时起作用
• 为了方便使用，苹果提供了一个全局的 session
• 所有的 task 都需要 session 发起
• 所有的 task 默认都是 挂起 的，需要 resume
• NSURLSession 支持后台操作，除非用户强制关闭

NSURLSession 的 Task

• NSURLSessionDataTask
  上传下载都可以，适合小数据
• NSURLSessionUploadTask
  上传用的 Task
• NSURLSessionDownloadTask
  下载用的 Task

NSURLSessionDataTask

• 适合小数据（JSON or Plist or HTML or XML or 小图像）
  P.S.(Postscript)
  其实对于小数据，NSURLConnection 也是同样适合的

GET 请求

    NSURL *url = [NSURL URLWithString:@"http://127.0.0.1/login.php?username=username&password=pwd"];
    // data 或者 request 都是可以的
    NSURLSessionDataTask *taskGET = [[NSURLSession sharedSession] dataTaskWithURL:url completionHandler:^(NSData * _Nullable data, NSURLResponse * _Nullable response, NSError * _Nullable error) {
        if (error == nil && data.length > 0) {
            NSLog(@"data -- %@", data);
        } else {
            NSLog(@"error -- %@", error);
            NSLog(@"response -- %@", response);
        }
    }];
    [taskGET resume];

POST 请求

    NSURL *url = [NSURL URLWithString:@"http://127.0.0.1/login.php"];
    NSMutableURLRequest *request = [NSMutableURLRequest requestWithURL:url];
    request.HTTPMethod = @"POST";
    NSData *requestBody = [@"username=username&password=pwd" dataUsingEncoding:NSUTF8StringEncoding];
    request.HTTPBody = requestBody;
    NSURLSessionDataTask *taskPOST = [[NSURLSession sharedSession] dataTaskWithRequest:request completionHandler:^(NSData * _Nullable data, NSURLResponse * _Nullable response, NSError * _Nullable error) {
        if (error == nil && data.length > 0) {
            NSLog(@"data -- %@", data);
            id result = [NSJSONSerialization JSONObjectWithData:data options:0 error:NULL];
            NSLog(@"result -- %@", result);
        } else {
            NSLog(@"error -- %@", error);
            NSLog(@"response -- %@", response);
        }
    }];
    [taskPOST resume];

NSURLSessionUploadTask

POST 请求

#define kBoundary @"suxiaonao"
- (void)testSessionUploadTask {
    // create URL
    NSURL *url = [NSURL URLWithString:@"http://127.0.0.1/post/upload.php"];
    // create POST request
    // 上传一般不会用到 GET 请求
    // 首先，字面理解 POST 就更合适一些
    // 其次，GET 请求会把请求体拼接在 URL 后面，虽然 HTTP 没有限制 URL 的长度，但是，服务器和浏览器会有限制
    NSMutableURLRequest *request = [NSMutableURLRequest requestWithURL:url];
    // request method
    request.HTTPMethod = @"POST";
    // request head setValue: forHTTPHeaderField:
    // 这儿需要设置一下 HTTPHeaderField，感觉是和 kBoundary 有关，因为后面拼接请求体的时候也是需要用到 kBoundary 的，如果我们在这儿给某个 HTTPHeaderField 赋值了，就会替换掉默认值，并且需要注意大小写敏感
    [request setValue:[NSString stringWithFormat:@"multipart/form-data; boundary=%@", kBoundary] forHTTPHeaderField:@"Content-Type"];
    // request body
    // connection 是把上传数据放在请求体里面，session 会把上传数据放在 uploadTaskWithRequest: 这个方法的第二个参数里面
    // session send upload
    // dataWithFieldName: 就是在做请求体拼接
    NSURLSessionUploadTask *uploadTask = [[NSURLSession sharedSession] uploadTaskWithRequest:request fromData:[self dataWithFieldName:@"userfile" fileName:@"cba.txt" fileContent:[NSString stringWithContentsOfFile:[[NSBundle mainBundle] pathForResource:@"abc.txt" ofType:nil] encoding:NSUTF8StringEncoding error:NULL]] completionHandler:^(NSData * _Nullable data, NSURLResponse * _Nullable response, NSError * _Nullable error) {
        if (error == nil && data.length > 0) {
            id result = [NSJSONSerialization JSONObjectWithData:data options:0 error:NULL];
            NSLog(@"result -- %@", result);
        } else {
            NSLog(@"error -- %@", error);
        }
    }];
    
    [uploadTask resume];
}

dataWithFieldName: fileName: fileContent: 方法实现

//-----------------------------1499715155697045246716155137
//Content-Disposition: form-data; name="userfile"; filename="abc.txt"
//Content-Type: text/plain
//
//Hello!!
//-----------------------------1499715155697045246716155137--
- (NSData *)dataWithFieldName:(NSString *)fieldName fileName:(NSString *)fileName fileContent:(NSString *)fileContent {
    NSMutableString *stringM = [NSMutableString string];
    [stringM appendFormat:@"--%@\r\n", kBoundary];
    [stringM appendFormat:@"Content-Disposition: form-data; name=%@; filename=%@\r\n", fieldName, fileName];
    // Content-Type 有很多，如果不确定，写 application/octet-strea 就好
//    [stringM appendString:@"Content-Type: text/plain\r\n\r\n"];
//    [stringM appendString:@"Content-Type: image/png\r\n\r\n"];
    [stringM appendString:@"Content-Type: application/octet-strea\r\n\r\n"];
    [stringM appendFormat:@"%@\r\n", fileContent];
    [stringM appendFormat:@"--%@--\r\n\r\n", kBoundary];
    NSData *data = [stringM.copy dataUsingEncoding:NSUTF8StringEncoding];
    
    return data;
}

NSURLSessionDownloadTask

• 说到下载，需要引入一个概念 —— NSURLSessionConfiguration（工作模式）
  • DataTask 和 UploadTask 都在用系统提供的 session，所以没有设置过 configuration
• NSURLSessionConfiguration 有三种模式
  • defaultSessionConfiguration
    默认模式，和 NSURLConnection 类似，使用全局单例，通过 Cache 和 Cookie 存储对象
  • ephemeralSessionConfiguration
    及时模式，不能持续使用 Cache 和 Cookie 存储对象
  • backgroundSessionConfiguration
    后台模式，可以在后台完成上传下载，创建 configuration 的时候，需要有一个 identifier，用于 session 在后台工作的时候，确定是哪一个 session 完成的
• 下载一般会去自定义 session，同时设置代理，并且如果设置了代理，block 就不会再起作用
• NSURLSessionDownloadTask 会把下载的文件放到 tmp 文件夹里面，记得自己去做存储

    NSURL *url = [NSURL URLWithString:@"http://127.0.0.1/files.zip"];
    // 这儿用的是 defaultSessionConfiguration
    NSURLSession *downloadSession = [NSURLSession sessionWithConfiguration:[NSURLSessionConfiguration defaultSessionConfiguration] delegate:self delegateQueue:[[NSOperationQueue alloc] init]];
    NSURLSessionDownloadTask *downloadTask = [downloadSession downloadTaskWithURL:url];
    [downloadTask resume];
    // 然后根据需要实现代理方法就好

NSURLSession 和 NSURLConnection 下载比较

• NSURLSession 下载的时候可以暂停、继续，但是，NSURLConnection 不可以
• NSURLSession 和 NSURLConnection 都可以取消，一旦取消，下次就要重新发布或者连接
• NSURLSession 和 NSURLConnection 下载都可以指定 range，修改请求头就好