NSURLSession 是 iOS 上取代 NSURLConnection 的現代網路方案。它的架構是「Session 產生 Task」,三種 Task 各有用途。以下用三個實際範例說明。
// 1. 確定 URL(含中文時記得做百分比編碼)
NSString *urlStr = @"https://localhost/試試看";
urlStr = [urlStr stringByAddingPercentEscapesUsingEncoding:NSUTF8StringEncoding];
NSURL *url = [NSURL URLWithString:urlStr];
// 2. 建立 request
NSMutableURLRequest *request = [NSMutableURLRequest requestWithURL:url cachePolicy:0 timeoutInterval:2.0f];
// 3. 取得 session
NSURLSession *session = [NSURLSession sharedSession];
// 4. 由 session 產生 task
NSURLSessionDataTask *dataTask =
[session dataTaskWithRequest:request completionHandler:^(NSData *data, NSURLResponse *response, NSError *error) {
NSLog(@"response-- %@", response);
NSLog(@"data-- %@", data);
// 更新 UI 一定要回主線程
dispatch_async(dispatch_get_main_queue(), ^{
[self.imageView setImage:[UIImage imageWithData:data]];
});
}];
// 5. 記得 resume,否則 task 不會開始執行
[dataTask resume];
最容易忽略的一步就是最後的 resume:dataTaskWithRequest 只是「建立」任務,呼叫 resume 才會真正送出請求。
NSURLSession *session = [NSURLSession sharedSession];
NSURLSessionDownloadTask *downloadTask =
[session downloadTaskWithRequest:request completionHandler:^(NSURL *location, NSURLResponse *response, NSError *error) {
// location 位於 tmp 目錄,系統隨時可能清掉,必須自行搬走
NSString *cachePath = [NSSearchPathForDirectoriesInDomains(NSCachesDirectory, NSUserDomainMask, YES) lastObject];
NSURL *cachePathURL = [NSURL fileURLWithPath:cachePath];
NSString *fileNameByMD5 = [[[response URL] absoluteString] MD5];
NSURL *fileURL = [cachePathURL URLByAppendingPathComponent:fileNameByMD5];
NSFileManager *mgr = [NSFileManager defaultManager];
[mgr moveItemAtURL:location toURL:fileURL error:NULL];
}];
[downloadTask resume];
用 URL 的 MD5 當檔名是個實用的小技巧:不必處理中文、特殊字元或檔名重複,同一個 URL 天然只會有一份快取。
MD5 的實作可以直接用 CommonCrypto:
- (NSString *)MD5 {
const char *cStr = [self UTF8String];
unsigned char digest[CC_MD5_DIGEST_LENGTH];
CC_MD5(cStr, strlen(cStr), digest);
NSMutableString *result = [NSMutableString stringWithCapacity:CC_MD5_DIGEST_LENGTH * 2];
for (int i = 0; i < CC_MD5_DIGEST_LENGTH; i++) {
[result appendFormat:@"%02x", digest[i]];
}
return result;
}
若需要「續傳」或「App 切到背景仍持續下載」,則要改用 delegate 版本的 downloadTask,並搭配 backgroundSessionConfiguration: 建立背景 session。這部分的實作細節可參考:https://blog.csdn.net/majiakun1/article/details/38133789