網絡第三節——NSURLSession

有的程序員老了,還沒聽過NSURLSession
有的程序員還嫩,沒用過NSURLConnection
有的程序員很單純,他只知道AFN.

NSURLConnection在iOS9被宣佈棄用,NSURLSession從13年發展到如今,終於迎來了它獨步江湖的時代.NSURLSession是蘋果在iOS7後爲HTTP數據傳輸提供的一系列接口,比NSURLConnection強大,坑少,好用.今天從使用的角度介紹下.

除了NSURLSession,文中還會頻繁地出現NSURLSessionConfiguration和NSURLSessionTask兩個類.先認識一下,混個臉熟吧.

使用NSURLSession,攏共分兩步:

• 第一步 經過NSURLSession的實例建立task
• 第二部 執行task

既然兩步裏面都出現了task,就先說說它吧.
NSURLSessionTask能夠簡單理解爲任務:如數據請求任務,下載任務,上傳任務and so on.咱們使用的是他的子類們:

• NSURLSessionTask(抽象類)
  • NSURLSessionDataTask
    • NSURLSessionUploadTask
  • NSURLSessionDownloadTask

從這幾個子類的名字就能夠大概猜出他們的做用了.接下來咱們就從不一樣類型的任務出發,來使用session.

NSURLSessionDataTask

字面上看是和數據相關的任務,但其實dataTask徹底能夠勝任downloadTask和uploadTask的工做.這可能也是咱們使用最多的task種類.

簡單GET請求

若是請求的數據比較簡單,也不須要對返回的數據作一些複雜的操做.那麼咱們可使用帶block

// 快捷方式得到session對象 NSURLSession *session = [NSURLSession sharedSession]; NSURL *url = [NSURL URLWithString:@"http://www.daka.com/login?username=daka&pwd=123"]; // 經過URL初始化task,在block內部能夠直接對返回的數據進行處理 NSURLSessionTask *task = [session dataTaskWithURL:url completionHandler:^(NSData *data, NSURLResponse *response, NSError error) { NSLog(@"%@", [NSJSONSerialization JSONObjectWithData:data options:kNilOptions error:nil]); }]; // 啓動任務 [task resume];

Tips:

• 全部類型的task都要調用resume方法纔會開始進行請求.

簡單POST請求

POST和GET的區別就在於request,因此使用session的POST請求和GET過程是同樣的,區別就在於對request的處理.

NSURL *url = [NSURL URLWithString:@"http://www.daka.com/login"]; NSMutableURLRequest *request = [NSMutableURLRequest requestWithURL:url]; request.HTTPMethod = @"POST"; request.HTTPBody = [@"username=daka&pwd=123" dataUsingEncoding:NSUTF8StringEncoding]; NSURLSession *session = [NSURLSession sharedSession]; // 因爲要先對request先行處理,咱們經過request初始化task NSURLSessionTask *task = [session dataTaskWithRequest:request completionHandler:^(NSData *data, NSURLResponse *response, NSError *error) { NSLog(@"%@", [NSJSONSerialization JSONObjectWithData:data options:kNilOptions error:nil]); }]; [task resume];

NSURLSessionDataDelegate代理方法

NSURLSession提供了block方式處理返回數據的簡便方式,但若是想要在接收數據過程當中作進一步的處理,仍然能夠調用相關的協議方法.NSURLSession的代理方法和NSURLConnection有些相似,都是分爲接收響應、接收數據、請求完成幾個階段.

// 使用代理方法須要設置代理,可是session的delegate屬性是隻讀的,要想設置代理只能經過這種方式建立session NSURLSession *session = [NSURLSession sessionWithConfiguration:[NSURLSessionConfiguration defaultSessionConfiguration] delegate:self delegateQueue:[[NSOperationQueue alloc] init]]; // 建立任務(由於要使用代理方法,就不須要block方式的初始化了) NSURLSessionDataTask *task = [session dataTaskWithRequest:[NSURLRequest requestWithURL:[NSURL URLWithString:@"http://www.daka.com/login?userName=daka&pwd=123"]]]; // 啓動任務 [task resume]; //對應的代理方法以下: // 1.接收到服務器的響應 - (void)URLSession:(NSURLSession *)session dataTask:(NSURLSessionDataTask *)dataTask didReceiveResponse:(NSURLResponse *)response completionHandler:(void (^)(NSURLSessionResponseDisposition))completionHandler { // 容許處理服務器的響應，纔會繼續接收服務器返回的數據 completionHandler(NSURLSessionResponseAllow); } // 2.接收到服務器的數據（可能調用屢次） - (void)URLSession:(NSURLSession *)session dataTask:(NSURLSessionDataTask *)dataTask didReceiveData:(NSData *)data { // 處理每次接收的數據 } // 3.請求成功或者失敗（若是失敗，error有值） - (void)URLSession:(NSURLSession *)session task:(NSURLSessionTask *)task didCompleteWithError:(NSError *)error { // 請求完成,成功或者失敗的處理 }

Tips:

關鍵點在代碼註釋裏面都有說起,重要的地方再強調一下:

• 若是要使用代理方法,須要設置代理,但從NSURLSession的頭文件發現session的delegate屬性是隻讀的.所以設置代理要經過session的初始化方法賦值:sessionWithConfiguration:delegate:delegateQueue:其中:
  • configuration參數(文章開始提到的)須要傳遞一個配置,咱們暫且使用默認的配置[NSURLSessionConfiguration defaultSessionConfiguration]就好(後面會說下這個配置是幹嗎用的);
  • delegateQueue參數表示協議方法將會在哪一個隊列(NSOperationQueue)裏面執行.
• NSURLSession在接收到響應的時候要先對響應作容許處理:completionHandler(NSURLSessionResponseAllow);,纔會繼續接收服務器返回的數據,進入後面的代理方法.值得一提的是,若是在接收響應的時候須要對返回的參數進行處理(如獲取響應頭信息等),那麼這些處理應該放在前面容許操做的前面.

NSURLSessionDownloadTask

文件下載可使用NSURLSessionDownloadTask這個子類.

簡單下載

NSURLSessionDownloadTask一樣提供了經過NSURL和NSURLRequest兩種方式來初始化並經過block進行回調的方法.下面以NSURL初始化爲例:

SURLSession *session = [NSURLSession sharedSession]; NSURL *url = [NSURL URLWithString:@"http://www.daka.com/resources/image/icon.png"] ; NSURLSessionDownloadTask *task = [session downloadTaskWithURL:url completionHandler:^(NSURL *location, NSURLResponse *response, NSError *error) { // location是沙盒中tmp文件夾下的一個臨時url,文件下載後會存到這個位置,因爲tmp中的文件隨時可能被刪除,因此咱們須要本身須要把下載的文件挪到須要的地方 NSString *path = [[NSSearchPathForDirectoriesInDomains(NSCachesDirectory, NSUserDomainMask, YES) lastObject] stringByAppendingPathComponent:response.suggestedFilename]; // 剪切文件 [[NSFileManager defaultManager] moveItemAtURL:location toURL:[NSURL fileURLWithPath:path] error:nil]; }]; // 啓動任務 [task resume];

Tips:

• 須要注意的就是須要將下載到tmp文件夾的文件轉移到須要的目錄.緣由在代碼中已經貼出.
• response.suggestedFilename是從相應中取出文件在服務器上存儲路徑的最後部分,如數據在服務器的url爲http://www.daka.com/resources/image/icon.png, 那麼其suggestedFilename就是icon.png.

NSURLSessionDownloadDelegate代理方法

一樣的,downloadTask也提供了配套的代理方法

// 每次寫入調用(會調用屢次) - (void)URLSession:(NSURLSession *)session downloadTask:(NSURLSessionDownloadTask *)downloadTask didWriteData:(int64_t)bytesWritten totalBytesWritten:(int64_t)totalBytesWritten totalBytesExpectedToWrite:(int64_t)totalBytesExpectedToWrite { // 可在這裏經過已寫入的長度和總長度算出下載進度 CGFloat progress = 1.0 * totalBytesWritten / totalBytesExpectedToWrite; NSLog(@"%f",progress); } // 下載完成調用 - (void)URLSession:(NSURLSession *)session downloadTask:(NSURLSessionDownloadTask *)downloadTask didFinishDownloadingToURL:(NSURL *)location { // location仍是一個臨時路徑,須要本身挪到須要的路徑(caches下面) NSString *filePath = [[NSSearchPathForDirectoriesInDomains(NSCachesDirectory, NSUserDomainMask, YES) lastObject] stringByAppendingPathComponent:downloadTask.response.suggestedFilename]; [[NSFileManager defaultManager] moveItemAtURL:location toURL:[NSURL fileURLWithPath:filePath] error:nil]; } // 任務完成調用 - (void)URLSession:(NSURLSession *)session task:(NSURLSessionTask *)task didCompleteWithError:(NSError *)error { }

NSURLSessionUploadTask

在NSURLSession中,文件上傳方式主要有如下兩種:

NSURLSessionUploadTask *task = [[NSURLSession sharedSession] uploadTaskWithRequest:request fromFile:fileName completionHandler:^(NSData *data, NSURLResponse *response, NSError *error) { }];

和

[self.session uploadTaskWithRequest:request fromData:body completionHandler:^(NSData *data, NSURLResponse *response, NSError *error) { NSLog(@"-------%@", [NSJSONSerialization JSONObjectWithData:data options:kNilOptions error:nil]); }];

處於安全性考慮,一般咱們會使用POST方式進行文件上傳,因此較多使用第二種方式.

可是,NSURLSession並無爲咱們提供比NSURLConnection更方便的文件上傳方式.方法中body處的參數須要填寫request的請求體(http協議規定格式的大長串).由於你有90%的可能性用了AFNetworking,即便是本身寫的應該也是copy,因此代碼就不貼了咱們只說方法呵呵噠.

斷點下載

NSURLSessionDownloadTask提供了與斷點下載相關的幾個方法:

// 使用這種方式取消下載能夠獲得未來用來恢復的數據,保存起來 [self.task cancelByProducingResumeData:^(NSData *resumeData) { self.resumeData = resumeData; }]; // 因爲下載失敗致使的下載中斷會進入此協議方法,也能夠獲得用來恢復的數據 - (void)URLSession:(NSURLSession *)session task:(NSURLSessionTask *)task didCompleteWithError:(NSError *)error { // 保存恢復數據 self.resumeData = error.userInfo[NSURLSessionDownloadTaskResumeData]; } // 恢復下載時接過保存的恢復數據 self.task = [self.session downloadTaskWithResumeData:self.resumeData]; // 啓動任務 [self.task resume];

以目前我對NSURLSession的理解這種斷點下載只支持應用內斷點,若是程序在下載過程當中途關閉,則不能恢復下載.(暫時對NSURLSession理解還不全面,不敢妄下斷論,若有不妥簡友們能夠溝通下)

其餘

此外,task們自身有都擁有下面幾個方法

- (void)suspend; - (void)resume; - (void)cancel;

suspend可讓當前的任務暫停
resume方法不只能夠啓動任務,還能夠喚醒suspend狀態的任務
cancel方法能夠取消當前的任務,你也能夠向處於suspend狀態的任務發送cancel消息,任務若是被取消便不能再恢復到以前的狀態.

NSURLSessionConfiguration

簡單地說,就是session的配置信息.如:

NSURLSessionConfiguration *config = [NSURLSessionConfiguration defaultSessionConfiguration]; // 超時時間 config.timeoutIntervalForRequest = 10; // 是否容許使用蜂窩網絡(後臺傳輸不適用) config.allowsCellularAccess = YES; // 還有不少能夠設置的屬性

有沒有發現咱們使用的Configuration都是默認配置:[NSURLSessionConfiguration defaultSessionConfiguration],其實它的配置有三種類型:

+ (NSURLSessionConfiguration *)defaultSessionConfiguration; + (NSURLSessionConfiguration *)ephemeralSessionConfiguration; + (NSURLSessionConfiguration *)backgroundSessionConfigurationWithIdentifier:(NSString *)identifier

表示了NSURLSession幾種不一樣的工做模式.
默認的配置會將緩存存儲在磁盤上,第二種瞬時會話模式不會建立持久性存儲的緩存,第三種後臺會話模式容許程序在後臺進行上傳下載工做.

除了支持任務的暫停和斷點續傳,我以爲NSURLSession之於NSURLConnection的最偉大的進步就是支持後臺上傳下載任務,這又是一個能夠深刻討論的話題.但在這方面我尚未進行深刻的研究,待後續瞭解以後另行開貼.

PS:AFNetWorking從2.0版本就有了基於NSURLSession的系列封裝,感興趣的童鞋自行前往瞭解.

 

若是對你有幫助，請關注我哦！