AFN3.X研究

使用AFN時在自然不過的一件事了，正如在java中會使用httpClient。AFN3.0開始完全基于NSURLSession了，從此就告別了繁瑣的線程操作的一些東西，轉(zhuǎn)而更加關(guān)注于請求功能的實(shí)現(xiàn)。最近一段時間研究了下AFN3.0，得到一些淺薄的筆記，記錄下來。

0. 一句話總結(jié)AFN

  • 基于NSURLSession的輕量級，用于發(fā)送異步請求（get，post，文件上傳，下載）的框架。
  • 包含了對NSURLRequest的封裝，NURLResponse的處理，以及連接的創(chuàng)建、管理，https安全性的配置，網(wǎng)絡(luò)的監(jiān)測，UIKit的擴(kuò)展。
  • AFN3.X版本僅僅基于NSURLSession，AFN2.X主流用法還是繼續(xù)NSURLConnection。3.X比2.X結(jié)構(gòu)更加簡單清晰。

1. AFN 是什么

AFN是一個輕量級的框架，它將通用的客戶端與服務(wù)器的交互的操作封裝了起來，包括了請求的創(chuàng)建，請求操作的管理，響應(yīng)的序列化，網(wǎng)絡(luò)指示器的監(jiān)測，安全性，以及UI控件異步加載網(wǎng)絡(luò)數(shù)據(jù)的便捷擴(kuò)展。

2. AFN3.X能干什么

  • 發(fā)異步請求：
  • 文件上傳
  • 文件下載（小文件，大文件和斷點(diǎn)續(xù)傳等操作目前需要自己封裝）
  • 網(wǎng)絡(luò)監(jiān)聽

3.AFN包含什么

AFN3.X的主要功能模塊包括：NSURLRequest的構(gòu)建，NSURLSessionTask的創(chuàng)建和管理，進(jìn)度的監(jiān)測回調(diào)，結(jié)果的回調(diào)，響應(yīng)的序列化處理

    - AFN3.X
        + AFURLSessionManager
            *工廠模式創(chuàng)建Task
            *Task綁定TaskDelegate
            *session代理回調(diào)，回調(diào)TaskDelegate響應(yīng)回調(diào)
        + AFURLSessionManagerTaskDelegate
            *KVO監(jiān)測進(jìn)度，并回調(diào)
            *結(jié)果回調(diào)
        + AFHTTPSessionManager(繼承前者封裝了常用的 HTTP 方法)
            * GET
            * POST
            * POST constructBody
        + AFURLRequestSerialization 請求的數(shù)據(jù)格式/默認(rèn)是二進(jìn)制的
            *requestWithMethod
            *multipartFormRequestWithMethod
            * requestBySerializingRequest
          +AFJSONRequestSerializer
              * requestBySerializingRequest
          +AFPropertyListRequestSerializer
              * requestBySerializingRequest
       + AFURLResponseSerialization :響應(yīng)的數(shù)據(jù)格式/默認(rèn)是JSON格式
       + AFSecurityPolicy
       + AFNetworkReachabilityManager
  • AFHTTPSessionManager的get方法基于NSURLSessionDataTask
  • AFHTTPSessionManager的post方法基于NSURLSessionDataTask
  • AFHTTPSessionManager的postconstruct方法基于 NSURLSessionUpLoadTask
  • NSURLSessionDownLoadTask的封裝可以自己實(shí)現(xiàn)

4. AFN3.X的功能實(shí)現(xiàn)流程

根據(jù)請求參數(shù)創(chuàng)建請求——發(fā)送請求——響應(yīng)處理

  • 輸入：NSURLRequest，NSMutableURLRequest，
    NSURLSession，NSOperation，NSOperationQueue
  • 輸出data，序列化的對象
  • KVO監(jiān)測下載和上傳的進(jìn)度
  • AFHTTPSessionManager get方法沒有封裝DownLoadTask，需要手動實(shí)現(xiàn)
  • 上傳使用的是：uploadTaskWithStreamedRequest ，上傳的body使用的
    是request.HTTPBodyStream

1）請求的序列化

目的：根據(jù)輸入的URL，參數(shù)字典，上傳數(shù)據(jù)（可選），構(gòu)造NSURLRequest。
功能：默認(rèn)構(gòu)造為application/x-www-form-urlencodedbody類型的數(shù)據(jù)。get直接拼接URL，post作為請求體。
子類可以構(gòu)造application/json和application/x-plist請求數(shù)據(jù)。設(shè)置為httpbodyData。
上傳數(shù)據(jù)形式為multipart/form-data; boundary=XXXX,設(shè)置的是httpbodystream
原生沒有提供 僅僅上傳單個文件，和純文本body形式的API。但是話說回來，這兩種并不常用。
實(shí)現(xiàn)：兩個關(guān)鍵的方法構(gòu)造請求：
- requestWithMethod:URLString: parameters:error:此方法調(diào)用協(xié)議方法requestBySerializingRequest: withParameters:error:
- multipartFormRequestWithMethod:URLString:parameters:constructingBodyWithBlock:error:
前者設(shè)置的是httpBody
后者設(shè)置是httpBodystream
具體實(shí)現(xiàn)細(xì)節(jié)：待續(xù)

2）響應(yīng)的反序列化

目的：根據(jù)得到的NSURLResponse和body data轉(zhuǎn)化為所需要的數(shù)據(jù)類型。
功能： responseObjectForResponse:response data:error:方法 得到感興趣的數(shù)據(jù)類型(id )responseObject：
默認(rèn)為data，json形式往往為NSDictionary。json的序列化可以設(shè)置是否去除null value。沒有提供responseString的功能，需要自己轉(zhuǎn)化。
響應(yīng)默認(rèn)為json處理形式，響應(yīng)非json的話一定需要顯示的設(shè)置為AFURLResponseSerialization類型

3）請求的創(chuàng)建，管理，維護(hù)

目的：發(fā)送請求，得到響應(yīng)，處理好進(jìn)度的回調(diào)，請求成功，失敗的回調(diào)
實(shí)現(xiàn)：
GET:parameters: progress:success:failure:
POST:parameters: progress:success:failure:
會調(diào)用
dataTaskWithHTTPMethod:URLString:parameters:uploadProgress:downloadProgress: success:failure:
然后調(diào)用
dataTaskWithRequest: uploadProgress: downloadProgress: completionHandler（這是工廠方法創(chuàng)建Task的其中之一）
之后
調(diào)用
addDelegateForDataTask:uploadProgress: downloadProgress: completionHandler
在這里創(chuàng)建一個自定義的taskDelegate對象，將參數(shù)賦值給它。taskDelegate和Task是一一對應(yīng)的，Task的進(jìn)度檢測，結(jié)果的回調(diào)完全都是在taskDelegate中進(jìn)行。
再調(diào)用
setDelegate:forTask:這個方法是線程安全的，加上鎖的，功能：把delegate放入一個字典中做記錄，設(shè)置delegate的進(jìn)度指示，KVO方法監(jiān)測task的 countOfBytesReceived， countOfBytesExpectedToReceive等屬性

Session的代理方法在manager中調(diào)用：
manager中每一個代理方法都定義了一個block。調(diào)用相應(yīng)代理方法的時候如果有相應(yīng)的block就會回調(diào)。但是實(shí)際上，定義的get和post等方法并未使用。
反而，在代理方法中
調(diào)用
delegateForTask:方法(加鎖的操作)根據(jù)task取得相應(yīng)的taskDelegate然后回調(diào)相應(yīng)的taskDelegate的方法。
taskDelegate中，KVO回調(diào)方法會實(shí)時監(jiān)測進(jìn)度并回調(diào)響應(yīng)的block
在taskDelegate的 URLSession:task:didCompleteWithError:中
獲取到之前拼接的data，根據(jù)序列化得到responseObject，response直接取task的屬性
然后回調(diào) completionHandler block并發(fā)送相應(yīng)通知。如果不設(shè)置 manager.completionQueue，就在main_queue中回調(diào)。

最后掃尾工作：移除taskDelegate的KVO和task的通知，保存task和taskDelegate的字典中移除（這個操作也需要加鎖）

POST:parameters: constructingBodyWithBlock:progress:success:failure:
調(diào)用
uploadTaskWithStreamedRequest:progress:uploadProgressBlock completionHandler:
之后的流程類似
progress回調(diào)是在sessionQueue中回調(diào)，不是在mainQueue

5.常用的封裝

待續(xù)

6.需要的背景知識

1)NSURLSession簡介

  • NSURLSession的創(chuàng)建需要指定模式，代理，和代理的線程隊列
  • NSURLSession的提供了豐富的構(gòu)建task的方法，使用block的話就不會回調(diào)代理了
  • NSURLSessionTask提供了開啟，中斷，取消的操作，狀態(tài)，發(fā)送接收數(shù)據(jù)的屬性，request，response，error屬性，沒有data屬性
    使用代理的話，需要把data疊加
  • NSURLSessionDelegate:session狀態(tài)的代理回調(diào)
  • NSURLSessionDataDelegate: dataTask的方法回調(diào)
  • NSURLSessionTaskDelegate：只要是TASK的方法回調(diào)
  • NSURLSessionDownLoadTask：downLoadTask的方法回調(diào)
最后編輯于 ：
?著作權(quán)歸作者所有,轉(zhuǎn)載或內(nèi)容合作請聯(lián)系作者
【社區(qū)內(nèi)容提示】社區(qū)部分內(nèi)容疑似由AI輔助生成，瀏覽時請結(jié)合常識與多方信息審慎甄別。
平臺聲明：文章內(nèi)容（如有圖片或視頻亦包括在內(nèi)）由作者上傳并發(fā)布，文章內(nèi)容僅代表作者本人觀點(diǎn)，簡書系信息發(fā)布平臺，僅提供信息存儲服務(wù)。

相關(guān)閱讀更多精彩內(nèi)容

友情鏈接更多精彩內(nèi)容