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

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

• 优点:
  • 网络状态已经封装,在通过GET/POST请求会回调;
  • 缓存已经封装,当GET/POST请求失败后会回调;
  • 开发接口少,只需调用相应功能功能的接口即可。

• 配置公共的请求头(可以不配置)

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

• 更新请求接口基础url(如果服务器地址有多个,可以不配置)

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

• 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支持CocoaPods(CocoaPods是什么?)

  写在Podfile文件中,

  source 'https://github.com/CocoaPods/Specs.git'
  inhibit_all_warnings!
   
  target "这里写你的工程名字" do
  pod 'NJAFNetworking', '~> 1.0.1'
  end
  

• 下载NJAFNetworking(下载地址) 下载完后将NJAFNetworking文件夹拖入工程中即可。

结束。

你们的支持也是我前进的动力,非常感谢支持!