fengyun911/KJNetworkPlugin

English Documents

插件版网络请求架构，支持批量操作和链式操作

熟悉swift的朋友应该都知道一款优秀的三方库Moya，插件版网络请求是真香，于是乎借鉴思路制作一款纯oc版本的插件网络请求库。
熟悉oc的朋友又应该都知道一款优秀的三方库YTKNetwork，基于对象的协议版网络请求，然后他的批量网络请求和链式网络请求也超级香。
结合两者部分优点，制作一款纯OC版批量和链式插件版网络请求库。

功能清单

插件版网络请求可以更方便快捷的定制专属网络请求，并且支持批量操作，链式操作

支持基本的网络请求，下载上传文件
支持配置通用请求跟路径，通用参数等
支持设置加载和提示框插件
支持解析结果插件
支持网络缓存插件
支持配置自建证书插件
支持修改请求体和获取响应结果插件
支持网络日志抓包插件
支持刷新加载更多插件
支持错误码解析插件
支持错误和空数据UI展示插件
支持批量操作
支持链式网络请求

Network

**KJBaseNetworking**：网络请求基类，基于 AFNetworking 封装使用

这里也提供两个入口，设置通用的根路径和通用参数，类似：userID，token等

/// 根路径地址
@property (nonatomic, strong, class) NSString *baseURL;
/// 基本参数，类似：userID，token等
@property (nonatomic, strong, class) NSDictionary *baseParameters;

封装的有基本的网络请求，上传下载文件等方法

**KJNetworkingRequest**：请求体，设置网络请求相关参数，其中包含参数，请求方式，插件等等

**KJNetworkingResponse**：响应请求结果，获取插件之间产生的数据等等

**KJNetworkingType**：汇总所有枚举和回调声明

**KJNetworkBasePlugin**：插件基类，插件父类

**KJNetworkPluginManager**：插件管理器，中枢神经

/// 插件版网络请求
/// @param request 请求体
/// @param success 成功回调
/// @param failure 失败回调
+ (void)HTTPPluginRequest:(KJNetworkingRequest *)request success:(KJNetworkPluginSuccess)success failure:(KJNetworkPluginFailure)failure;

**KJNetworkingDelegate**：插件协议，管理网络请求结果

目前抽离出5条协议方法，开始时刻、网络请求时刻、网络成功、网络失败、最终返回

/// 开始准备网络请求
/// @param request 请求相关数据
/// @param endRequest 是否结束下面的网络请求
/// @return 返回准备插件处理后的数据
- (KJNetworkingResponse *)prepareWithRequest:(KJNetworkingRequest *)request endRequest:(BOOL *)endRequest;

/// 网络请求开始时刻请求
/// @param request 请求相关数据
/// @param stopRequest 是否停止网络请求
/// @return 返回网络请求开始时刻插件处理后的数据
- (KJNetworkingResponse *)willSendWithRequest:(KJNetworkingRequest *)request stopRequest:(BOOL *)stopRequest;

/// 成功接收数据
/// @param request 请求相关数据
/// @param againRequest 是否需要再次请求该网络
/// @return 返回成功插件处理后的数据
- (KJNetworkingResponse *)succeedWithRequest:(KJNetworkingRequest *)request againRequest:(BOOL *)againRequest;

/// 失败处理
/// @param request 请求相关数据
/// @param againRequest 是否需要再次请求该网络
/// @return 返回失败插件处理后的数据
- (KJNetworkingResponse *)failureWithRequest:(KJNetworkingRequest *)request againRequest:(BOOL *)againRequest;

/// 准备返回给业务逻辑时刻调用
/// @param request 请求相关数据
/// @param error 错误信息
/// @return 返回最终加工之后的数据
- (KJNetworkingResponse *)processSuccessResponseWithRequest:(KJNetworkingRequest *)request error:(NSError **)error;

Plugins插件集合

目前已有9款插件供使用：

KJNetworkLoadingPlugin：加载框和错误提示框插件
KJNetworkAnslysisPlugin：解析数据插件
KJNetworkCachePlugin：网络缓存插件
KJNetworkCertificatePlugin：配置自建证书插件
KJNetworkThiefPlugin：修改器插件
KJNetworkCapturePlugin：网络日志抓包插件
KJNetworkCodePlugin：错误码解析插件
KJNetworkRefreshPlugin：刷新加载更多插件
KJNetworkEmptyPlugin：错误信息和空数据UI展示插件

Chain链式插件网络

KJNetworkChainManager

Batch批量插件网络

KJNetworkBatchManager

关于作者

🎷 邮箱地址：ykj310@126.com 🎷
🎸 GitHub地址：yangKJ 🎸
🎺 掘金地址：茶底世界之下 🎺
🚴🏻 简书地址：77___ 🚴🏻

fengyun911 / KJNetworkPlugin