iOS开发-网络框架-b

网络框架（以下称NJAFNetworking）是基于AFNetworking框架的简单封装，基本功能包括POST请求，GET请求，上传文件，下载文件，网络状态，缓存等。

为什么要使用NJAFNetworking？

在使用AFNetworking的时候我们会发现对外开发接口比较多，当项目需求涉及到缓存，以及网络判断的时候，我们都无从下手。然NJAFNetworking框架将这些过多的开发接口封装到一起，让我们使用起来更为方便。

优点：

网络状态已经封装，在通过GET/POST请求会回调；

缓存已经封装，当GET/POST请求失败后会回调；

开发接口少，只需调用相应功能功能的接口即可。

NJAFNetworking究竟是什么？

配置公共的请求头（可以不配置）

/**
*  配置公共的请求头，用于区分请求来源，需要与服务器约定好
*  @param httpHeaders      如@{"client" : "iOS"}
*/
+ (void)configCommonHttpHeaders:(NSDictionary *)httpHeaders;

更新请求接口基础url（如果服务器地址有多个，可以不配置）

/**
*  更新请求接口基础url（如果服务器地址有多个）
*  @param baseUrl 请求接口基础url
*/
+ (void)updateBaseUrl:(NSString *)baseUrl;

GET请求接口

/**
*  GET请求接口
*  @param url          访问地址路径，如/user/index/login
*  @param refreshCache 是否刷新缓存，YES
*  @param params       需要传的参数，如@{@"user_id" :@(80011)}
*  @param progress     进度回调，
*  @param success      接口请求响应成功回调
*  @param fail         接口请求响应失败回调
*  @return             NSURLSessionTask
*/
+ (NJURLSessionTask *)getWithUrl:(NSString *)url
refreshCache:(BOOL)refreshCache
params:(NSDictionary *)params
progress:(NJLoadProgress)progress
success:(NJResponseSuccess)success
fail:(NJResponseFail)fail;

POST请求接口

/**
*  POST请求接口
*  @param url          访问地址路径，如/user/index/login
*  @param refreshCache 是否刷新缓存，YES
*  @param params       需要传的参数，如@{@"user_id" :@(80011)}
*  @param progress     进度回调，
*  @param success      接口请求响应成功回调
*  @param fail         接口请求响应失败回调
*  @return             NSURLSessionTask
*/
+ (NJURLSessionTask *)postWithUrl:(NSString *)url
refreshCache:(BOOL)refreshCache
params:(NSDictionary *)params
progress:(NJLoadProgress)progress
success:(NJResponseSuccess)success
fail:(NJResponseFail)fail;

图片上传接口

/**
*  图片上传接口
*  @param image        图片对象
*  @param url          上传图片路径，如/user/images
*  @param filename     文件名字，默认为当前时间yyyyMMddHHmmss.jpg
*  @param name         约定关联名称，如image
*  @param mimeType     默认iamge/jpeg
*  @param parameters   需要传的参数，如@{@"user_id" :@(80011)}
*  @param progress     上传进度回调
*  @param success      上传成功回调
*  @param fail         上传失败回调
*  @return             NSURLSessionTask
*/
+ (NJURLSessionTask *)uploadWithImage:(UIImage *)image
url:(NSString *)url
filename:(NSString *)filename
name:(NSString *)name
mimeType:(NSString *)mimeType
parameters:(NSDictionary *)parameters
progress:(NJLoadProgress)progress
success:(NJResponseSuccess)success
fail:(NJResponseFail)fail;

上传文件

/**
*  上传文件
*  @param url              上传文件路径，如/user/images
*  @param uploadingFile    待上传文件路径，如/user/images
*  @param progress         进度回调
*  @param success          上传成功回调
*  @param fail             上传失败回调
*  @return                 NSURLSessionTask
*/
+ (NJURLSessionTask *)uploadFileWithUrl:(NSString *)url
uploadingFile:(NSString *)uploadingFile
progress:(NJLoadProgress)progress
success:(NJResponseSuccess)success
fail:(NJResponseFail)fail;

下载文件

/**
*  下载文件
*  @param url              下载文件URL
*  @param saveToPath       下载到那个路径下
*  @param progress         下载进度
*  @param success          下载成功后的回调
*  @param fail             下载失败后的回调
*  @return NSURLSessionTask
*/
+ (NJURLSessionTask *)downloadWithUrl:(NSString *)url
saveToPath:(NSString *)saveToPath
progress:(NJLoadProgress)progress
success:(NJResponseSuccess)success
fail:(NJResponseFail)fail;

如何使用NJAFNetworking？

NJAFNetworking支持CocoaPods(CocoaPods是什么？)
写在Podfile文件中，

source 'https://github.com/CocoaPods/Specs.git'
inhibit_all_warnings!

target "这里写你的工程名字" do
pod 'NJAFNetworking', '~> 1.0.1'
end

下载NJAFNetworking（下载地址）
下载完后将NJAFNetworking文件夹拖入工程中即可。