电子发烧友网>电子资料下载>电子资料>XDNetworking基于AFNetworking网络框架

XDNetworking基于AFNetworking网络框架

2077738 2022-06-24 | zip | 0.24 MB | 次下载 | 2积分

普通下载普通下载

资料介绍

授权协议 MIT

开发语言 Objec tive-C

操作系统 iOS

软件类型开源软件

所属分类 iOS代码库、网络(Networking)

软件简介

基于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暴露只面向业务的参数。