iOS-HTTP:NSURLSession類簇詳解

蘋果官方提供的用于加載網(wǎng)絡(luò)資源的類等限，可以分為以下幾大類


URL loading system類簇
NSURLSession是iOS7新引進的類望门，用于取代NSURLConnection,一個NSURLSession可以管理多個task形娇，提供了狀態(tài)和進度屬性筹误，支持取消，掛起勘畔，重新開始任務(wù)；可以恢復(fù)失敗炫七、取消、掛起的任務(wù)万哪。

使用方式為創(chuàng)建一個 NSURLConnection，然后使用這個NSURLConnection對象創(chuàng)建一個task奕巍，然后啟動task。

NSURLSessionConfiguration *sessionConfiguration= [NSURLSessionConfiguration defaultSessionConfiguration];

NSURLSession *session = [NSURLSession 
sessionWithConfiguration:sessionConfiguration delegate:self delegateQueue:self.operationQueue];
NSURLSessionDataTask *task = [session dataTaskWithURL:[NSURL URLWithString:@""]];
[task resume];

處理響應(yīng)檩坚，你可以簡單的提供一個回調(diào)block，或者實現(xiàn)代理來處理匾委。如果你提供了回調(diào)block氓润，那么久不會調(diào)用代理的處理請求結(jié)果的方法了。

NSURLSession有3種類型咖气，對應(yīng)3種不同的配置

Default sessions：普通模式，會使用磁盤緩存以及鑰匙串中的證書
Ephemeral session：無痕模式崩溪，不管是緩存還是證書都只會保存在內(nèi)存中，在釋放的時候就會被清空伶唯。
Background sessions：后臺模式

使用NSURLSessionConfiguration類提供的類方法創(chuàng)建

image.png

支持3種不同的task類型

Data task：使用NSData保存發(fā)送和接收數(shù)據(jù)抵怎，使用與數(shù)據(jù)量較小的情況（比如通常的業(yè)務(wù)接口請求）岭参，可以分很多次返回和結(jié)束一次性返回反惕。
Download tasks：顧名思義演侯，這種模式適用于下載大的文件，會直接保存到硬盤里面秒际。并且支持后臺下載。
Upload tasks： 上傳模式娄徊，類似于下載模式，使用磁盤文件兵多、支持后臺模式。
Stream Task： 基于stream的任務(wù)剩膘。

提供block

利用session創(chuàng)建task的時候可以提供completionHandler，如果你提供 handler 怠褐，那么代理的關(guān)于處理請求結(jié)果的方法就不會被調(diào)用。

NSURLSessionDataTask *task = [session dataTaskWithURL:[NSURL URLWithString:urlStr] completionHandler:^(NSData * _Nullable data, NSURLResponse * _Nullable response, NSError * _Nullable error) {
        NSLog(@"completionHandler");
    }];

代理一覽

image.png

- (void)URLSession:(NSURLSession *)session didBecomeInvalidWithError:(nullable NSError *)error;
這個方法在session失效后會調(diào)用奠涌。
通過調(diào)用session的finishTasksAndInvalidate會使其失效筐赔，并且等待session剩余的任務(wù)完成或者失敗的時候就會調(diào)用此方法

- (void)URLSession:(NSURLSession *)session didReceiveChallenge:(NSURLAuthenticationChallenge *)challenge completionHandler:(void (^)(NSURLSessionAuthChallengeDisposition disposition, NSURLCredential * _Nullable credential))completionHandler
這個代理用來處理身份驗證。在https通信中茴丰，可以在這里自定義處理是否信任服務(wù)器。如果你沒有實現(xiàn)這個方法贿肩，就會調(diào)用
URLSession:task:didReceiveChallenge:completionHandler:

- (void)URLSessionDidFinishEventsForBackgroundURLSession:(NSURLSession *)session API_AVAILABLE(ios(7.0), watchos(2.0), tvos(9.0)) API_UNAVAILABLE(macos)
后臺模式會用到

- (void)URLSession:(NSURLSession *)session task:(NSURLSessionTask *)task willBeginDelayedRequest:(NSURLRequest *)request completionHandler:(void (^)(NSURLSessionDelayedRequestDisposition disposition, NSURLRequest * _Nullable newRequest))completionHandler API_AVAILABLE(macos(10.13), ios(11.0), watchos(4.0), tvos(11.0))
iOS11新增汰规。
用于后臺任務(wù)汤功。這個方法告訴代理一個延遲的task（通過設(shè)置earliestBeginDate）要開始執(zhí)行了
只有在等待網(wǎng)絡(luò)或者需要被新的請求替代而導(dǎo)致當(dāng)前請求可能會變過時的時候才需要實現(xiàn)這個方法
你需要調(diào)用此方法參數(shù)中的completionHandler溜哮，并提供disposition指示如何做下一步處理，
disposition提供3個值

NSURLSessionDelayedRequestContinueLoading: 繼續(xù)執(zhí)行
NSURLSessionDelayedRequestUseNewRequest: 用新的request替換舊的
NSURLSessionDelayedRequestCancel: 取消請求

disposition傳NSURLSessionDelayedRequestCancel和直接調(diào)用task的cancel方法效果是一樣餐茵。

- (void)URLSession:(NSURLSession *)session taskIsWaitingForConnectivity:(NSURLSessionTask *)task API_AVAILABLE(macos(10.13), ios(11.0), watchos(4.0), tvos(11.0))
iOS11新增述吸，當(dāng)前網(wǎng)絡(luò)不可用的時候會調(diào)用忿族，前提是 NSURLSessionConfiguration的waitsForConnectivity屬性為YES.每個task只會最多調(diào)一次蝌矛，并且只有當(dāng)任務(wù)開始的時候網(wǎng)絡(luò)不可用才有效。后臺任務(wù)不會調(diào)用此方法隆豹。

- (void)URLSession:(NSURLSession *)session task:(NSURLSessionTask *)task willPerformHTTPRedirection:(NSHTTPURLResponse *)response newRequest:(NSURLRequest *)request completionHandler:(void (^)(NSURLRequest * _Nullable))completionHandler
用于處理重定向茅逮，調(diào)用completionHandler決定怎么處理重定向簿煌。

- (void)URLSession:(NSURLSession *)session task:(NSURLSessionTask *)task didReceiveChallenge:(NSURLAuthenticationChallenge *)challenge completionHandler:(void (^)(NSURLSessionAuthChallengeDisposition disposition, NSURLCredential * _Nullable credential))completionHandler
用于處理身份認(rèn)證鉴吹，前面的URLSession:didReceiveChallenge:completionHandler: 為session級，這個為task級豆励。
如果是session級的身份認(rèn)證，則會先調(diào)session級的代理方法良蒸，如果沒有提供session級的方法，就會調(diào)用task級的剿吻。
如果你需要自己處理身份認(rèn)證串纺，你必須2個方法都實現(xiàn)丽旅，

- (void)URLSession:(NSURLSession *)session task:(NSURLSessionTask *)task needNewBodyStream:(void (^)(NSInputStream * _Nullable bodyStream))completionHandler
當(dāng)需要新的body stream的時候會調(diào)用纺棺。只有才用stream的形式發(fā)起的請求才會調(diào)用此方法（用uploadTaskWithStreamedRequest:創(chuàng)建的task）。使用file url 或者NSData提供body的不會調(diào)用此方法茅撞。

- (void)URLSession:(NSURLSession *)session task:(NSURLSessionTask *)task didSendBodyData:(int64_t)bytesSent totalBytesSent:(int64_t)totalBytesSent totalBytesExpectedToSend:(int64_t)totalBytesExpectedToSend
通知代理請求body的發(fā)送進度

- (void)URLSession:(NSURLSession *)session task:(NSURLSessionTask *)task didFinishCollectingMetrics:(NSURLSessionTaskMetrics *)metrics API_AVAILABLE(macosx(10.12), ios(10.0), watchos(3.0), tvos(10.0))
用來統(tǒng)計task生命期內(nèi)的一些信息巨朦，統(tǒng)計信息保存在NSURLSessionTaskMetrics對象里面

image.png

NSURLSessionTaskMetrics總共有3個屬性

transactionMetrics：子過程的統(tǒng)計信息，類型為數(shù)組拄查；比如重定向就有2個請求悔橄，這里就會有2條記錄
taskInterval：task花費的時間
redirectCount：重定向的次數(shù)

- (void)URLSession:(NSURLSession *)session task:(NSURLSessionTask *)task didCompleteWithError:(nullable NSError *)error
請求完成的回調(diào)腺毫，error為nil的代表請求成功，不為nil表示客戶端發(fā)生了錯誤（比如地址不正確）潮酒。

NSURLSessionDataDelegate

- (void)URLSession:(NSURLSession *)session dataTask:(NSURLSessionDataTask *)dataTask didReceiveResponse:(NSURLResponse *)response completionHandler:(void (^)(NSURLSessionResponseDisposition disposition))completionHandler
當(dāng)接受完服務(wù)器返回的響應(yīng)頭部分會調(diào)用此方法，調(diào)用completionHandler指示下一步工作急黎，有4種處理方式
NSURLSessionResponseCancel = 0
NSURLSessionResponseAllow = 1,
NSURLSessionResponseBecomeDownload = 2,
NSURLSessionResponseBecomeStream = 3

- (void)URLSession:(NSURLSession *)session dataTask:(NSURLSessionDataTask *)dataTask didBecomeDownloadTask:(NSURLSessionDownloadTask *)downloadTask
如果你在- URLSession:dataTask:didReceiveResponse:completionHandler中決定把task從data task變?yōu)閐ownload task后，就會調(diào)用此代理淤击，會給你提供新的task對象

- (void)URLSession:(NSURLSession *)session dataTask:(NSURLSessionDataTask *)dataTask didBecomeStreamTask:(NSURLSessionStreamTask *)streamTask
task類型變?yōu)閟tream時會調(diào)用此方法

- (void)URLSession:(NSURLSession *)session dataTask:(NSURLSessionDataTask *)dataTask didReceiveData:(NSData *)data
告訴代理接收到了一些data

- (void)URLSession:(NSURLSession *)session dataTask:(NSURLSessionDataTask *)dataTask willCacheResponse:(NSCachedURLResponse *)proposedResponse completionHandler:(void (^)(NSCachedURLResponse * _Nullable cachedResponse))completionHandler
當(dāng)接受完所有的數(shù)據(jù)后，會調(diào)用此代理詢問是否緩存此次請求的內(nèi)容汞贸。如果沒有實現(xiàn)此方法印机，默認(rèn)就會使用session的configuration里面的緩存策略

NSURLSessionDownloadDelegate

- (void)URLSession:(NSURLSession *)session downloadTask:(NSURLSessionDownloadTask *)downloadTask didFinishDownloadingToURL:(NSURL *)location
通知代理 download task已經(jīng)完成了，開發(fā)者注意在這里把文件從location移到合適的地方射赛，應(yīng)為如果不移動，location對應(yīng)的文件會在方法返回的時候刪除

- (void)URLSession:(NSURLSession *)session downloadTask:(NSURLSessionDownloadTask *)downloadTask didWriteData:(int64_t)bytesWritten totalBytesWritten:(int64_t)totalBytesWritten totalBytesExpectedToWrite:(int64_t)totalBytesExpectedToWrite
用來通知跟新下載task的進度

- (void)URLSession:(NSURLSession *)session downloadTask:(NSURLSessionDownloadTask *)downloadTask didResumeAtOffset:(int64_t)fileOffset expectedTotalBytes:(int64_t)expectedTotalBytes
通知舊的下載任務(wù)恢復(fù)下載了
當(dāng)一個可恢復(fù)的任務(wù)取消或者失敗時竣灌，你可以保存resume data,然后將這為參數(shù)調(diào)用downloadTaskWithResumeData:或downloadTaskWithResumeData:completionHandler:來創(chuàng)建新的task就可以在之前的進度上繼續(xù)秆麸。此任務(wù)開始時就會調(diào)用這個代理方法帐偎。
resume data 的獲取方式
1.通過調(diào)用task的-cancelByProducingResumeData:方法來取消
2.任務(wù)失敗的時候蛔屹，系統(tǒng)調(diào)會用任務(wù)完成的代理或block，從傳過來的NSError對象的userInfo字典里面取key為NSURLSessionDownloadTaskResumeData的值

NSURLSessionStreamDelegate

- (void)URLSession:(NSURLSession *)session readClosedForStreamTask:(NSURLSessionStreamTask *)streamTask
通知底層socket的read端已經(jīng)關(guān)閉了

- (void)URLSession:(NSURLSession *)session writeClosedForStreamTask:(NSURLSessionStreamTask *)streamTask
通知底層socket的write端已經(jīng)關(guān)閉了

- (void)URLSession:(NSURLSession *)session betterRouteDiscoveredForStreamTask:(NSURLSessionStreamTask *)streamTask
通知代理一條更好的路由被發(fā)現(xiàn)了漫贞，你可以在這里創(chuàng)建新的stream task來利用新路由的優(yōu)勢

- (void)URLSession:(NSURLSession *)session streamTask:(NSURLSessionStreamTask *)streamTask didBecomeInputStream:(NSInputStream *)inputStream outputStream:(NSOutputStream *)outputStream
通知代理stream task完成了

最后編輯于 ：
?著作權(quán)歸作者所有,轉(zhuǎn)載或內(nèi)容合作請聯(lián)系作者
  • 人面猴
    序言：七十年代末育叁，一起剝皮案震驚了整個濱河市，隨后出現(xiàn)的幾起案子谴蔑，更是在濱河造成了極大的恐慌龟梦，老刑警劉巖隐锭，帶你破解...
    沈念sama閱讀 206,311評論 6贊 481
  • 死咒
    序言：濱河連續(xù)發(fā)生了三起死亡事件计贰，死亡現(xiàn)場離奇詭異，居然都是意外死亡荞怒，警方通過查閱死者的電腦和手機，發(fā)現(xiàn)死者居然都...
    沈念sama閱讀 88,339評論 2贊 382
  • 救了他兩次的神仙讓他今天三更去死
    文/潘曉璐 我一進店門褐桌，熙熙樓的掌柜王于貴愁眉苦臉地迎上來，“玉大人停士，你說我怎么就攤上這事完丽×导迹” “怎么了逻族？”我有些...
    開封第一講書人閱讀 152,671評論 0贊 342
  • 道士緝兇錄：失蹤的賣姜人
    文/不壞的土叔 我叫張陵，是天一觀的道長薄辅。 經(jīng)常有香客問我抠璃，道長站楚，這世上最難降的妖魔是什么搏嗡？ 我笑而不...
    開封第一講書人閱讀 55,252評論 1贊 279
  • ?港島之戀（遺憾婚禮）
    正文 為了忘掉前任，我火速辦了婚禮旧乞，結(jié)果婚禮上磅氨，老公的妹妹穿的比我還像新娘。我一直安慰自己烦租，他們只是感情好，可當(dāng)我...
    茶點故事閱讀 64,253評論 5贊 371
  • 惡毒庶女頂嫁案：這布局不是一般人想出來的
    文/花漫 我一把揭開白布挫以。 她就那樣靜靜地躺著，像睡著了一般屡贺。 火紅的嫁衣襯著肌膚如雪锌杀。 梳的紋絲不亂的頭發(fā)上甩栈，一...
    開封第一講書人閱讀 49,031評論 1贊 285
  • 城市分裂傳說
    那天量没，我揣著相機與錄音，去河邊找鬼殴蹄。 笑死猾担，一個胖子當(dāng)著我的面吹牛袭灯，可吹牛的內(nèi)容都是我干的绑嘹。 我是一名探鬼主播，決...
    沈念sama閱讀 38,340評論 3贊 399
  • 雙鴛鴦連環(huán)套：你想象不到人心有多黑
    文/蒼蘭香墨 我猛地睜開眼姨丈，長吁一口氣：“原來是場噩夢啊……” “哼擅腰！你這毒婦竟也來了蟋恬？” 一聲冷哼從身側(cè)響起趁冈，我...
    開封第一講書人閱讀 36,973評論 0贊 259
  • 萬榮殺人案實錄
    序言：老撾萬榮一對情侶失蹤，失蹤者是張志新（化名）和其女友劉穎矾飞，沒想到半個月后呀邢，有當(dāng)?shù)厝嗽跇淞掷锇l(fā)現(xiàn)了一具尸體洒沦，經(jīng)...
    沈念sama閱讀 43,466評論 1贊 300
  • ?護林員之死
    正文 獨居荒郊野嶺守林人離奇死亡申眼，尸身上長有42處帶血的膿包…… 初始之章·張勛 以下內(nèi)容為張勛視角 年9月15日...
    茶點故事閱讀 35,937評論 2贊 323
  • ?白月光啟示錄
    正文 我和宋清朗相戀三年蝉衣，在試婚紗的時候發(fā)現(xiàn)自己被綠了。 大學(xué)時的朋友給我發(fā)了我未婚夫和他白月光在一起吃飯的照片病毡。...
    茶點故事閱讀 38,039評論 1贊 333
  • 活死人
    序言：一個原本活蹦亂跳的男人離奇死亡，死狀恐怖，靈堂內(nèi)的尸體忽然破棺而出淌喻，到底是詐尸還是另有隱情雀摘，我是刑警寧澤裸删，帶...
    沈念sama閱讀 33,701評論 4贊 323
  • ?日本核電站爆炸內(nèi)幕
    正文 年R本政府宣布涯塔，位于F島的核電站，受9級特大地震影響清蚀，放射性物質(zhì)發(fā)生泄漏。R本人自食惡果不足惜枷邪，卻給世界環(huán)境...
    茶點故事閱讀 39,254評論 3贊 307
  • 男人毒藥：我在死后第九天來索命
    文/蒙蒙 一、第九天 我趴在偏房一處隱蔽的房頂上張望药薯。 院中可真熱鬧救斑，春花似錦童本、人聲如沸脸候。這莊子的主人今日做“春日...
    開封第一講書人閱讀 30,259評論 0贊 19
  • 一樁弒父案运沦，背后竟有這般陰謀
    文/蒼蘭香墨 我抬頭看了看天上的太陽。三九已至嫁盲，卻和暖如春，著一層夾襖步出監(jiān)牢的瞬間羞秤，已是汗流浹背左敌。 一陣腳步聲響...
    開封第一講書人閱讀 31,485評論 1贊 262
  • 情欲美人皮
    我被黑心中介騙來泰國打工， 沒想到剛下飛機就差點兒被人妖公主榨干…… 1. 我叫王不留矫限，地道東北人佩抹。 一個月前我還...
    沈念sama閱讀 45,497評論 2贊 354
  • 代替公主和親
    正文 我出身青樓取董，卻偏偏與公主長得像，于是被迫代替她去往敵國和親甲葬。 傳聞我的和親對象是個殘疾皇子懈贺，可洞房花燭夜當(dāng)晚...
    茶點故事閱讀 42,786評論 2贊 345

推薦閱讀更多精彩內(nèi)容