您现在的位置: IOS教程網 >> IOS系統 >  >> iOS 程式開發 >> iOS 開發基礎

只會 AFN 不夠看:把 NSURLSession 一次搞懂

編輯:iOS 開發基礎

iOS 9 之後,Apple 已經放棄了 NSURLConnection。因此在目前的實際開發中,除了大家熟悉的 AFN 框架,主流選擇是 iOS 7 就登場的 NSURLSession。身為 iOS 開發者,如果你只會用 AFN 發網絡請求,那大概就是 too young too simple。

本文涵蓋內容

  1. NSURLSession 的優勢
  2. NSURLSessionTask 的子類
  3. 用 DataTask 發送 GET 與 POST 請求
  4. 設置代理發送請求,以及隨之而來的強引用問題
  5. DataTask 與 DownloadTask 的下載方式對比
  6. 上傳文件的注意事項

NSURLSession 的優勢

  • 支援 HTTP/2.0 協議
  • 下載任務可直接把資料寫入磁碟
  • 支援後台下載與上傳
  • 同一個 session 可發送多個請求,只需建立一次連接(複用 TCP)
  • 提供全域 session,並可統一配置,使用更方便
  • 下載採多執行緒非同步處理,效率更高

NSURLSessionTask 的家族關係

NSURLSessionTask 是抽象類,無法直接使用,必須透過子類。它主要分成兩支:

  • NSURLSessionDataTask:處理一般網絡請求,例如 GET、POST;其子類 NSURLSessionUploadTask 在上傳場景更有優勢。
  • NSURLSessionDownloadTask:專門處理下載請求,優勢明顯。

DataTask 發送 GET 請求

步驟只有兩個:用 NSURLSession 建立 Task,然後執行 Task。

// 確定請求路徑
NSURL *url = [NSURL URLWithString:@"https://120.25.226.186:32812/login?username=520&pwd=520&type=JSON"];
// 創建 NSURLSession 對象
NSURLSession *session = [NSURLSession sharedSession];
/**
 url              方法內部會自動把 URL 包裝成請求對象(預設 GET)
 completionHandler 完成後的回調(成功或失敗)
 data             返回的資料(響應體)
 response         響應頭
 error            錯誤資訊
 */
NSURLSessionDataTask *dataTask = [session dataTaskWithURL:url completionHandler:^(NSData * _Nullable data, NSURLResponse * _Nullable response, NSError * _Nullable error) {
    // 解析服務器返回的資料
    NSLog(@"%@", [[NSString alloc] initWithData:data encoding:NSUTF8StringEncoding]);
    // 預設在子線程中解析資料
    NSLog(@"%@", [NSThread currentThread]);
}];
// 發送請求(執行 Task)
[dataTask resume];

DataTask 發送 POST 請求

流程與 GET 相同,只是改用可變請求對象來設定方法與請求體。

// 確定請求路徑
NSURL *url = [NSURL URLWithString:@"https://120.25.226.186:32812/login"];
// 創建可變請求對象
NSMutableURLRequest *requestM = [NSMutableURLRequest requestWithURL:url];
// 修改請求方法
requestM.HTTPMethod = @"POST";
// 設置請求體
requestM.HTTPBody = [@"username=520&pwd=520&type=JSON" dataUsingEncoding:NSUTF8StringEncoding];
// 創建會話對象
NSURLSession *session = [NSURLSession sharedSession];
// 創建請求 Task
NSURLSessionDataTask *dataTask = [session dataTaskWithRequest:requestM completionHandler:^(NSData * _Nullable data, NSURLResponse * _Nullable response, NSError * _Nullable error) {
    NSLog(@"%@", [[NSString alloc] initWithData:data encoding:NSUTF8StringEncoding]);
}];
// 發送請求
[dataTask resume];

DataTask 設置代理發送請求

三步走:建立 session 並設置代理、建立 Task、執行 Task。

// 創建會話對象,設置代理
/**
 第一個參數:配置資訊
 第二個參數:設置代理
 第三個參數:隊列,傳 nil 則預設在子線程執行
 */
NSURLSession *session = [NSURLSession sessionWithConfiguration:[NSURLSessionConfiguration defaultSessionConfiguration]
                                                     delegate:self
                                                delegateQueue:nil];
NSURLSessionDataTask *dataTask = [session dataTaskWithRequest:requestM];
[dataTask resume];

接著遵守協議並實作代理方法,常用的有三個:

- (void)URLSession:(NSURLSession *)session dataTask:(NSURLSessionDataTask *)dataTask
didReceiveResponse:(NSURLResponse *)response
 completionHandler:(void (^)(NSURLSessionResponseDisposition))completionHandler {
    // 子線程中執行
    NSLog(@"接收到服務器響應的時候調用 -- %@", [NSThread currentThread]);
    self.dataM = [NSMutableData data];
    // 預設情況下不接收資料,必須告訴系統是否接收
    completionHandler(NSURLSessionResponseAllow);
}

- (void)URLSession:(NSURLSession *)session dataTask:(NSURLSessionDataTask *)dataTask
    didReceiveData:(NSData *)data {
    NSLog(@"接受到服務器返回資料的時候調用,可能被調用多次");
    [self.dataM appendData:data];
}

- (void)URLSession:(NSURLSession *)session task:(NSURLSessionTask *)task
didCompleteWithError:(NSError *)error {
    NSLog(@"請求完成或者是失敗的時候調用");
    NSLog(@"%@", [[NSString alloc] initWithData:self.dataM encoding:NSUTF8StringEncoding]);
}

設置代理後的強引用問題

一旦設定了代理,session 就會對代理對象保持強引用,因此必須在合適的時機主動釋放,否則容易造成記憶體洩漏。

常見做法是在控制器的 viewDidDisappear 中處理,可任選一個方法:

  • invalidateAndCancel:直接取消請求,然後釋放代理對象。
  • finishTasksAndInvalidate:等請求完成後再釋放代理對象。
[self.session finishTasksAndInvalidate];

DataTask 簡單下載

前面的請求過程其實就是一次簡單的下載。把回傳的資料直接轉成圖片即可:

[[[NSURLSession sharedSession] dataTaskWithURL:[NSURL URLWithString:
    @"https://120.25.226.186:32812/resources/images/minion_01.png"]
                          completionHandler:^(NSData * _Nullable data, NSURLResponse * _Nullable response, NSError * _Nullable error) {
    UIImage *image = [UIImage imageWithData:data];
    // 回到主線程設置圖片
    dispatch_async(dispatch_get_main_queue(), ^{
        self.imageView.image = image;
    });
}] resume];

DownloadTask 簡單下載

步驟是:建立下載請求、在下載完成時把檔案移到指定位置、執行請求。

// 確定請求路徑
NSURL *url = [NSURL URLWithString:@"https://120.25.226.186:32812/resources/images/minion_02.png"];
NSURLRequest *request = [NSURLRequest requestWithURL:url];
NSURLSession *session = [NSURLSession sharedSession];
// 這個方法內部已完成「邊接收資料邊寫沙盒」,解決了記憶體飆升的問題
NSURLSessionDownloadTask *downTask = [session downloadTaskWithRequest:request
                                                    completionHandler:^(NSURL * _Nullable location, NSURLResponse * _Nullable response, NSError * _Nullable error) {
    // 預設存在 tmp 目錄,需要把檔案搬到 cache
    NSLog(@"%@", location);
    NSString *fullPath = [[NSSearchPathForDirectoriesInDomains(NSCachesDirectory, NSUserDomainMask, YES) lastObject]
                          stringByAppendingPathComponent:response.suggestedFilename];
    /**
     fileURLWithPath: 帶協議頭
     URLWithString:   不帶協議頭
     */
    [[NSFileManager defaultManager] moveItemAtURL:location
                                            toURL:[NSURL fileURLWithPath:fullPath]
                                            error:nil];
}];
[downTask resume];

要注意的是,這種 completionHandler 寫法無法監聽下載進度;若需要進度回調,就得改用代理方式實作。

DataTask 與 DownloadTask 下載對比

NSURLSessionDataTask

  • 可實現離線斷點下載,但程式碼相對複雜。

NSURLSessionDownloadTask

  • 可實現斷點下載,但不支援離線續傳。
  • 內部已完成邊接收邊寫入沙盒的處理。
  • 解決了下載大檔案時的記憶體飆升問題。

最後:上傳文件的注意事項

老實說,用 NSURLSession 做文件上傳相當繁瑣,有興趣且時間充裕的朋友可以研究一下;不想折騰的話,繼續用 AFN 就好。

主要步驟:

  1. 確定上傳路徑(NSURL)
  2. 創建可變請求對象(NSMutableURLRequest)
  3. 把請求方法改為 POST
  4. 設置請求頭,告知服務端這是文件上傳請求
  5. 按固定格式拼接要上傳的檔案與參數
  6. 根據請求對象創建 session
  7. 建立 uploadTask 上傳任務
  8. 呼叫 resume 執行任務
  9. 解析服務端回傳結果,判斷成功或失敗

容易踩到的坑:

  1. 必須用可變請求對象,因為要改方法與請求頭。
  2. 請求頭這一步最常被遺漏。
  3. 拼接上傳參數時,務必遵循固定格式。
  4. 需要取得檔案的 MIMEType,可透過網路請求的響應頭取得,或直接使用通用型別 application/octet-stream,也可以呼叫 C 語言 API 自行判斷。

文章轉自 Mortal_Master 的簡書

  1. 上一篇文章:
  2. 下一篇文章:
蘋果刷機越獄教程| IOS教程問題解答| IOS技巧綜合| IOS7技巧| IOS8教程
Copyright © IOS教程網 All Rights Reserved