XDNetworking基于AFNetworking網絡框架

基于AFNetworking3.0封裝網絡請求功能，API面向業務層更友好，基礎功能包括GET、POST、下載、單文件上傳、多文件上傳、取消網絡請求。此外還拓展出了緩存功能，緩存分為內存緩存和磁盤緩存。

使用

將XDNetworking包拉進工程

#import?"XDNetworking.h"

GET請求

/**
?*??GET請求
?*
?*??@param?url??????????????請求路徑
?*??@param?cache????????????是否緩存
?*??@param?refresh??????????是否刷新請求(遇到重復請求，若為YES，則會取消舊的請求，用新的請求，若為NO，則忽略新請???求，用舊請求)
?*??@param?params???????????拼接參數
?*??@param?progressBlock????進度回調
?*??@param?successBlock?????成功回調
?*??@param?failBlock????????失敗回調
?*
?*??@return?返回的對象中可取消請求
?*/
+?(XDURLSessionTask?*)getWithUrl:(NSString?*)url
??????????????????refreshRequest:(BOOL)refresh
???????????????????????????cache:(BOOL)cache
??????????????????????????params:(NSDictionary?*)params
???????????????????progressBlock:(XDGetProgress)progressBlock
????????????????????successBlock:(XDResponseSuccessBlock)successBlock
???????????????????????failBlock:(XDResponseFailBlock)failBlock;

POST請求

/**
?*??POST請求
?*
?*??@param?url??????????????請求路徑
?*??@param?cache????????????是否緩存
?*??@param?refresh??????????解釋同上
?*??@param?params???????????拼接參數
?*??@param?progressBlock????進度回調
?*??@param?successBlock?????成功回調
?*??@param?failBlock????????失敗回調
?*
?*??@return?返回的對象中可取消請求
?*/
+?(XDURLSessionTask?*)postWithUrl:(NSString?*)url
???????????????????refreshRequest:(BOOL)refresh
????????????????????????????cache:(BOOL)cache
???????????????????????????params:(NSDictionary?*)params
????????????????????progressBlock:(XDPostProgress)progressBlock
?????????????????????successBlock:(XDResponseSuccessBlock)successBlock
????????????????????????failBlock:(XDResponseFailBlock)failBlock;

下載請求

/**
?*??文件下載
?*
?*??@param?url???????????下載文件接口地址
?*??@param?progressBlock?下載進度
?*??@param?successBlock??成功回調
?*??@param?failBlock?????下載回調
?*
?*??@return?返回的對象可取消請求
?*/
+?(XDURLSessionTask?*)downloadWithUrl:(NSString?*)url
????????????????????????progressBlock:(XDDownloadProgress)progressBlock
?????????????????????????successBlock:(XDDownloadSuccessBlock)successBlock
????????????????????????????failBlock:(XDDownloadFailBlock)failBlock;

文件上傳

/**
?*??文件上傳
?*
?*??@param?url??????????????上傳文件接口地址
?*??@param?data?????????????上傳文件數據
?*??@param?type?????????????上傳文件類型
?*??@param?name?????????????上傳文件服務器文件夾名
?*??@param?mimeType?????????mimeType
?*??@param?progressBlock????上傳文件路徑
?*??@param?successBlock?????成功回調
?*??@param?failBlock????????失敗回調
?*
?*??@return?返回的對象中可取消請求
?*/
+?(XDURLSessionTask?*)uploadFileWithUrl:(NSString?*)url
????????????????????????????????fileData:(NSData?*)data
????????????????????????????????????type:(NSString?*)type
????????????????????????????????????name:(NSString?*)name
????????????????????????????????mimeType:(NSString?*)mimeType
???????????????????????????progressBlock:(XDUploadProgressBlock)progressBlock
????????????????????????????successBlock:(XDResponseSuccessBlock)successBlock
???????????????????????????????failBlock:(XDResponseFailBlock)failBlock;

多文件上傳

/**
?*??多文件上傳
?*
?*??@param?url???????????上傳文件地址
?*??@param?datas?????????數據集合
?*??@param?type??????????類型
?*??@param?name??????????服務器文件夾名
?*??@param?mimeType??????mimeTypes
?*??@param?progressBlock?上傳進度
?*??@param?successBlock??成功回調
?*??@param?failBlock?????失敗回調
?*
?*??@return?任務集合
?*/
+?(NSArray?*)uploadMultFileWithUrl:(NSString?*)url
?????????????????????????fileDatas:(NSArray?*)datas
??????????????????????????????type:(NSString?*)type
??????????????????????????????name:(NSString?*)name
??????????????????????????mimeType:(NSString?*)mimeTypes
?????????????????????progressBlock:(XDUploadProgressBlock)progressBlock
??????????????????????successBlock:(XDMultUploadSuccessBlock)successBlock
?????????????????????????failBlock:(XDMultUploadFailBlock)failBlock;

取消所有網絡請求

+?(void)cancleAllRequest;

取消下載請求

+?(void)cancelRequestWithURL:(NSString?*)url;

獲取緩存大小

/**
?*??獲取緩存大小
?*
?*??@return?緩存大小
?*/
+?(unsigned?long?long)totalCacheSize;

清理緩存

/**
?*??清除所有緩存
?*/
+?(void)clearTotalCache;

自動清理緩存

????//每次網絡請求的時候，檢查此時磁盤中的緩存大小，如果超過閾值，則清理所有緩存
????//未來優化點：1、這里到時會做進一步優化，到時會有兩種清理策略，一種基于時間維度，一種基于緩存大小,
????//??????????2、清理也不會清理全部，會采取LRU算法來淘汰在磁盤中價值最低的緩存
????if?([self?totalCacheSize]?>?CACHEMAXSIZE)?[self?clearTotalCache];

獲取當前正在運行的任務

/**
?*??正在運行的網絡任務
?*
?*??@return?
?*/
+?(NSArray?*)currentRunningTasks;

Usage Tip

1.?對于cache與否，到時大家針對自己的業務數據的特征來決定是否開啟cache,即時性或時效性的數據建議不開啟緩存，一般建議開啟，開啟緩存后會回調兩次，第一次獲取是緩存數據，第二次獲取的是最新的網絡數據；
2.?新版本多了一個刷新請求參數，設置它是為了解決重復請求的問題，舉個例子，當我們在列表里面上拉獲取更多數據的時候，有時候因為網絡慢，還沒有回調響應刷新出數據，這時候我們可能不斷去上拉列表，如果業務層不判斷，就會發起很多重復的請求。遇到重復請求，若參數設為YES，則會取消舊的請求，用新的請求，若設為NO，則忽略新請求，用舊請求。
3.?具體使用的時候，建議面向業務層再封裝一次Service層或者將網絡請求寫進MVVM的viewModel中，向controller暴露只面向業務的參數。

Extension For Future

1.?為緩存添加相應的緩存淘汰算法LRU；
2.?再封裝面向業務更友好的manager，管理業務層的API，使其方便在不同網絡環境下切換（測試環境與正式環境......）