KJNetworkPluginManager插件版網絡請求庫

KJNetworkPlugin?是一款基于面向協議的網絡抽象層的插件版網絡請求庫，基于AFNetworking的基礎上再次封裝使用。

• 熟悉swift的朋友應該都知道一款優秀的三方庫Moya，插件版網絡請求是真香，于是乎借鑒思路制作一款純oc版本的插件網絡請求庫
• 熟悉oc的朋友又應該都知道一款優秀的三方庫YTKNetwork，基于對象的協議版網絡請求，然后他的批量網絡請求和鏈式網絡請求也超級香
• 結合一下兩者優點，制作一款批量和鏈式插件版網絡請求庫
• 目前整理九款插件：解析插件，緩存插件，配置自建證書插件，加載提示插件，修改請求插件，日志抓包插件，錯誤碼插件，刷新插件，網絡錯誤和空數據插件

功能清單

插件版網絡請求可以更方便快捷的定制專屬網絡請求，并且支持批量操作，鏈式操作

主要功能清單如下：

• 支持基本的網絡請求，下載上傳文件
• 支持配置通用請求跟路徑，通用參數等
• 支持設置加載和提示框插件
• 支持解析結果插件
• 支持網絡緩存插件
• 支持配置自建證書插件
• 支持修改請求體和獲取響應結果插件
• 支持網絡日志抓包插件
• 支持刷新加載更多插件
• 支持錯誤碼解析插件
• 支持錯誤和空數據UI展示插件
• 支持批量操作
• 支持鏈式網絡請求

使用教程

• 基本使用教程
• 插件使用教程
• 批量網絡使用教程
• 鏈式網絡使用教程

模塊組成

簡單講應該分為這么幾大板塊：

• Chain：鏈式插件版網絡請求
• Batch：批量插件版網絡請求
• Network：插件管理器和網絡請求基類
• Plugins：插件集合，目前已有5款插件供使用 ? - Loading：加載錯誤提示插件 ? - Anslysis：數據解析插件 ? - Cache：緩存插件 ? - Certificate：自建證書插件 ? - Thief：修改器插件 ? - Capture：網絡日志抓包插件 ? - Code：錯誤碼插件 ? - Refresh：刷新插件 ? - Empty：網絡錯誤和空數據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;

• 目前抽離出以下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：基于MBProgressHUD封裝的加載框和錯誤提示框插件

• KJNetworkAnslysisPlugin：基于MJExtension封裝的解析數據插件

• KJNetworkCachePlugin：基于YYCache封裝的網絡緩存插件

• KJNetworkCertificatePlugin：配置自建證書插件

• KJNetworkThiefPlugin：修改KJNetworkingRequest和獲取KJNetworkingResponse插件

• KJNetworkCapturePlugin：網絡日志抓包插件

• KJNetworkCodePlugin：錯誤碼解析插件

• KJNetworkRefreshPlugin：刷新加載更多插件

• KJNetworkEmptyPlugin：錯誤信息和空數據UI展示插件

Chain鏈式插件網絡

• 鏈式網絡使用教程

Batch批量插件網絡

• 批量網絡使用教程

關于作者

• ?