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 完成的
- defaultSessionConfiguration
- 下载一般会去自定义 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，修改请求头就好
