XDNetworking基于AFNetworking網(wǎng)絡(luò)框架

基于AFNetworking3.0封裝網(wǎng)絡(luò)請求功能，API面向業(yè)務(wù)層更友好，基礎(chǔ)功能包括GET、POST、下載、單文件上傳、多文件上傳、取消網(wǎng)絡(luò)請求。此外還拓展出了緩存功能，緩存分為內(nèi)存緩存和磁盤緩存。

使用

將XDNetworking包拉進(jìn)工程

#import?"XDNetworking.h"

GET請求

/**
?*??GET請求
?*
?*??@param?url??????????????請求路徑
?*??@param?cache????????????是否緩存
?*??@param?refresh??????????是否刷新請求(遇到重復(fù)請求，若為YES，則會取消舊的請求，用新的請求，若為NO，則忽略新請???求，用舊請求)
?*??@param?params???????????拼接參數(shù)
?*??@param?progressBlock????進(jìn)度回調(diào)
?*??@param?successBlock?????成功回調(diào)
?*??@param?failBlock????????失敗回調(diào)
?*
?*??@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???????????拼接參數(shù)
?*??@param?progressBlock????進(jìn)度回調(diào)
?*??@param?successBlock?????成功回調(diào)
?*??@param?failBlock????????失敗回調(diào)
?*
?*??@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?下載進(jìn)度
?*??@param?successBlock??成功回調(diào)
?*??@param?failBlock?????下載回調(diào)
?*
?*??@return?返回的對象可取消請求
?*/
+?(XDURLSessionTask?*)downloadWithUrl:(NSString?*)url
????????????????????????progressBlock:(XDDownloadProgress)progressBlock
?????????????????????????successBlock:(XDDownloadSuccessBlock)successBlock
????????????????????????????failBlock:(XDDownloadFailBlock)failBlock;

文件上傳

/**
?*??文件上傳
?*
?*??@param?url??????????????上傳文件接口地址
?*??@param?data?????????????上傳文件數(shù)據(jù)
?*??@param?type?????????????上傳文件類型
?*??@param?name?????????????上傳文件服務(wù)器文件夾名
?*??@param?mimeType?????????mimeType
?*??@param?progressBlock????上傳文件路徑
?*??@param?successBlock?????成功回調(diào)
?*??@param?failBlock????????失敗回調(diào)
?*
?*??@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?????????數(shù)據(jù)集合
?*??@param?type??????????類型
?*??@param?name??????????服務(wù)器文件夾名
?*??@param?mimeType??????mimeTypes
?*??@param?progressBlock?上傳進(jìn)度
?*??@param?successBlock??成功回調(diào)
?*??@param?failBlock?????失敗回調(diào)
?*
?*??@return?任務(wù)集合
?*/
+?(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;

取消所有網(wǎng)絡(luò)請求

+?(void)cancleAllRequest;

取消下載請求

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

獲取緩存大小

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

清理緩存

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

自動清理緩存

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

獲取當(dāng)前正在運(yùn)行的任務(wù)

/**
?*??正在運(yùn)行的網(wǎng)絡(luò)任務(wù)
?*
?*??@return?
?*/
+?(NSArray?*)currentRunningTasks;

Usage Tip

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

Extension For Future

1.?為緩存添加相應(yīng)的緩存淘汰算法LRU；
2.?再封裝面向業(yè)務(wù)更友好的manager，管理業(yè)務(wù)層的API，使其方便在不同網(wǎng)絡(luò)環(huán)境下切換（測試環(huán)境與正式環(huán)境......）