基于AFNetworking3.0网络封装

梦里梦外; 2022-07-28 09:00 131阅读 0赞

# 基于AFNetworking3.0网络封装 #

# 概述 #

对于开发人员来说，学习网络层知识是必备的，任何一款`App`的开发，都需要到网络请求接口。很多朋友都还在使用原生的`NSURLConnection`一行一行地写，代码到处是，这样维护起来更困难了。

对于使用`AFNetworking`的朋友来说，很多朋友都是直接调用`AFNetworking`的`API`，这样不太好，无法做到全工程统一配置。

最好的方式就是对网络层再封装一层，全工程不允许直接使用`AFNetworking`的`API`，必须调用我们自己封装的一层，如此一来，任何网络配置都可以在这一层里配置好，使用的人无须知道里面在干嘛，只管调用就可以了。

本篇为**基于AFNetworking3.0以上**的版本，支持iOS7及其以上版本。若要支持iOS6，请阅读旧版本：[基于AFNetworking2.5封装][AFNetworking2.5]

# 升级为3.0版本 #

*  简化API，以降低使用的要求
 *  增加GET/POST数据缓存、获取缓存大小、清空缓存功能
 *  接口增加刷新缓存功能
 *  增加取消所有请求、取消单个请求功能
 *  格式化打印日志
 *  增加对手动取消请求接口是否在失败时还回调的控制

# 常用接口类型 #

应用开发过程中，所使用类型通常是`GET`、`POST`及上传图片。因此，这里只是对这几种类型提供`API`。

## GET接口 ##

这里提供了两个`GET`请求的`API`，需要一般情况下`GET`请求都是直接写一个完整的`URL`，但是有时候为了参数可读性更强，改成传一个字典过来更容易阅读。

`HYBResponseSuccess`是响应成功的回调，返回的是字典，外部再转换成模型就可以了。  
`HYBResponseFail`是响应失败的回调，只有一个`NSError`对象，外部可接收处理。

<table> 
 <tbody> 
  <tr> 
   <td> 
    <div style="font-size:15px!important; line-height:20px!important"> 
     <div>
       1 
     </div> 
     <div>
       2 
     </div> 
     <div>
       3 
     </div> 
     <div>
       4 
     </div> 
     <div>
       5 
     </div> 
     <div>
       6 
     </div> 
     <div>
       7 
     </div> 
     <div>
       8 
     </div> 
     <div>
       9 
     </div> 
     <div>
       10 
     </div> 
     <div>
       11 
     </div> 
     <div>
       12 
     </div> 
     <div>
       13 
     </div> 
     <div>
       14 
     </div> 
     <div>
       15 
     </div> 
     <div>
       16 
     </div> 
     <div>
       17 
     </div> 
     <div>
       18 
     </div> 
     <div>
       19 
     </div> 
     <div>
       20 
     </div> 
     <div>
       21 
     </div> 
     <div>
       22 
     </div> 
     <div>
       23 
     </div> 
     <div>
       24 
     </div> 
     <div>
       25 
     </div> 
     <div>
       26 
     </div> 
     <div>
       27 
     </div> 
     <div>
       28 
     </div> 
     <div>
       29 
     </div> 
     <div>
       30 
     </div> 
     <div>
       31 
     </div> 
     <div>
       32 
     </div> 
    </div> </td> 
   <td> 
    <div style=""> 
     <div>
       &nbsp; 
     </div> 
     <div> 
      <span>/*!</span> 
     </div> 
     <div> 
      <span>*&nbsp;&nbsp;@author 黄仪标, 15-11-15 13:11:50</span> 
     </div> 
     <div> 
      <span>*</span> 
     </div> 
     <div> 
      <span>*&nbsp;&nbsp;GET请求接口，若不指定baseurl，可传完整的url</span> 
     </div> 
     <div> 
      <span>*</span> 
     </div> 
     <div> 
      <span>*&nbsp;&nbsp;@param url&nbsp;&nbsp;&nbsp;&nbsp; 接口路径，如/path/getArticleList</span> 
     </div> 
     <div> 
      <span>*&nbsp;&nbsp;@param refreshCache 是否刷新缓存。由于请求成功也可能没有数据，对于业务失败，只能通过人为手动判断</span> 
     </div> 
     <div> 
      <span>*&nbsp;&nbsp;@param params&nbsp;&nbsp;接口中所需要的拼接参数，如@{"categoryid" : @(12)}</span> 
     </div> 
     <div> 
      <span>*&nbsp;&nbsp;@param success 接口成功请求到数据的回调</span> 
     </div> 
     <div> 
      <span>*&nbsp;&nbsp;@param fail&nbsp;&nbsp;&nbsp;&nbsp;接口请求数据失败的回调</span> 
     </div> 
     <div> 
      <span>*</span> 
     </div> 
     <div> 
      <span>*&nbsp;&nbsp;@return 返回的对象中有可取消请求的API</span> 
     </div> 
     <div> 
      <span>*/</span> 
     </div> 
     <div> 
      <span>+</span> 
      <span> </span> 
      <span>(</span> 
      <span>HYBURLSessionTask</span> 
      <span> </span> 
      <span>*</span> 
      <span>)</span> 
      <span>getWithUrl</span> 
      <span>:</span> 
      <span>(</span> 
      <span>NSString</span> 
      <span> </span> 
      <span>*</span> 
      <span>)</span> 
      <span>url</span> 
     </div> 
     <div> 
      <span>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; refreshCache</span> 
      <span>:</span> 
      <span>(</span> 
      <span>BOOL</span> 
      <span>)</span> 
      <span>refreshCache</span> 
     </div> 
     <div> 
      <span>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;success</span> 
      <span>:</span> 
      <span>(</span> 
      <span>HYBResponseSuccess</span> 
      <span>)</span> 
      <span>success</span> 
     </div> 
     <div> 
      <span>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; fail</span> 
      <span>:</span> 
      <span>(</span> 
      <span>HYBResponseFail</span> 
      <span>)</span> 
      <span>fail</span> 
      <span>;</span> 
     </div> 
     <div> 
      <span>// 多一个params参数</span> 
     </div> 
     <div> 
      <span>+</span> 
      <span> </span> 
      <span>(</span> 
      <span>HYBURLSessionTask</span> 
      <span> </span> 
      <span>*</span> 
      <span>)</span> 
      <span>getWithUrl</span> 
      <span>:</span> 
      <span>(</span> 
      <span>NSString</span> 
      <span> </span> 
      <span>*</span> 
      <span>)</span> 
      <span>url</span> 
     </div> 
     <div> 
      <span>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; refreshCache</span> 
      <span>:</span> 
      <span>(</span> 
      <span>BOOL</span> 
      <span>)</span> 
      <span>refreshCache</span> 
     </div> 
     <div> 
      <span>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; params</span> 
      <span>:</span> 
      <span>(</span> 
      <span>NSDictionary</span> 
      <span> </span> 
      <span>*</span> 
      <span>)</span> 
      <span>params</span> 
     </div> 
     <div> 
      <span>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;success</span> 
      <span>:</span> 
      <span>(</span> 
      <span>HYBResponseSuccess</span> 
      <span>)</span> 
      <span>success</span> 
     </div> 
     <div> 
      <span>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; fail</span> 
      <span>:</span> 
      <span>(</span> 
      <span>HYBResponseFail</span> 
      <span>)</span> 
      <span>fail</span> 
      <span>;</span> 
     </div> 
     <div> 
      <span>// 多一个带进度回调</span> 
     </div> 
     <div> 
      <span>+</span> 
      <span> </span> 
      <span>(</span> 
      <span>HYBURLSessionTask</span> 
      <span> </span> 
      <span>*</span> 
      <span>)</span> 
      <span>getWithUrl</span> 
      <span>:</span> 
      <span>(</span> 
      <span>NSString</span> 
      <span> </span> 
      <span>*</span> 
      <span>)</span> 
      <span>url</span> 
     </div> 
     <div> 
      <span>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; refreshCache</span> 
      <span>:</span> 
      <span>(</span> 
      <span>BOOL</span> 
      <span>)</span> 
      <span>refreshCache</span> 
     </div> 
     <div> 
      <span>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; params</span> 
      <span>:</span> 
      <span>(</span> 
      <span>NSDictionary</span> 
      <span> </span> 
      <span>*</span> 
      <span>)</span> 
      <span>params</span> 
     </div> 
     <div> 
      <span>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; progress</span> 
      <span>:</span> 
      <span>(</span> 
      <span>HYBGetProgress</span> 
      <span>)</span> 
      <span>progress</span> 
     </div> 
     <div> 
      <span>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;success</span> 
      <span>:</span> 
      <span>(</span> 
      <span>HYBResponseSuccess</span> 
      <span>)</span> 
      <span>success</span> 
     </div> 
     <div> 
      <span>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; fail</span> 
      <span>:</span> 
      <span>(</span> 
      <span>HYBResponseFail</span> 
      <span>)</span> 
      <span>fail</span> 
      <span>;</span> 
     </div> 
     <div>
       &nbsp; 
     </div> 
    </div> </td> 
  </tr> 
 </tbody> 
</table>

## POST接口 ##

对于`POST`请求类型的接口，只有一个，看注释就可以明白如何使用了。

<table> 
 <tbody> 
  <tr> 
   <td> 
    <div style="font-size:15px!important; line-height:20px!important"> 
     <div>
       1 
     </div> 
     <div>
       2 
     </div> 
     <div>
       3 
     </div> 
     <div>
       4 
     </div> 
     <div>
       5 
     </div> 
     <div>
       6 
     </div> 
     <div>
       7 
     </div> 
     <div>
       8 
     </div> 
     <div>
       9 
     </div> 
     <div>
       10 
     </div> 
     <div>
       11 
     </div> 
     <div>
       12 
     </div> 
     <div>
       13 
     </div> 
     <div>
       14 
     </div> 
     <div>
       15 
     </div> 
     <div>
       16 
     </div> 
     <div>
       17 
     </div> 
     <div>
       18 
     </div> 
     <div>
       19 
     </div> 
     <div>
       20 
     </div> 
     <div>
       21 
     </div> 
     <div>
       22 
     </div> 
     <div>
       23 
     </div> 
     <div>
       24 
     </div> 
     <div>
       25 
     </div> 
    </div> </td> 
   <td> 
    <div style=""> 
     <div>
       &nbsp; 
     </div> 
     <div> 
      <span>/*!</span> 
     </div> 
     <div> 
      <span>*&nbsp;&nbsp;@author 黄仪标, 15-11-15 13:11:50</span> 
     </div> 
     <div> 
      <span>*</span> 
     </div> 
     <div> 
      <span>*&nbsp;&nbsp;POST请求接口，若不指定baseurl，可传完整的url</span> 
     </div> 
     <div> 
      <span>*</span> 
     </div> 
     <div> 
      <span>*&nbsp;&nbsp;@param url&nbsp;&nbsp;&nbsp;&nbsp; 接口路径，如/path/getArticleList</span> 
     </div> 
     <div> 
      <span>*&nbsp;&nbsp;@param params&nbsp;&nbsp;接口中所需的参数，如@{"categoryid" : @(12)}</span> 
     </div> 
     <div> 
      <span>*&nbsp;&nbsp;@param success 接口成功请求到数据的回调</span> 
     </div> 
     <div> 
      <span>*&nbsp;&nbsp;@param fail&nbsp;&nbsp;&nbsp;&nbsp;接口请求数据失败的回调</span> 
     </div> 
     <div> 
      <span>*</span> 
     </div> 
     <div> 
      <span>*&nbsp;&nbsp;@return 返回的对象中有可取消请求的API</span> 
     </div> 
     <div> 
      <span>*/</span> 
     </div> 
     <div> 
      <span>+</span> 
      <span> </span> 
      <span>(</span> 
      <span>HYBURLSessionTask</span> 
      <span> </span> 
      <span>*</span> 
      <span>)</span> 
      <span>postWithUrl</span> 
      <span>:</span> 
      <span>(</span> 
      <span>NSString</span> 
      <span> </span> 
      <span>*</span> 
      <span>)</span> 
      <span>url</span> 
     </div> 
     <div> 
      <span>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;refreshCache</span> 
      <span>:</span> 
      <span>(</span> 
      <span>BOOL</span> 
      <span>)</span> 
      <span>refreshCache</span> 
     </div> 
     <div> 
      <span>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;params</span> 
      <span>:</span> 
      <span>(</span> 
      <span>NSDictionary</span> 
      <span> </span> 
      <span>*</span> 
      <span>)</span> 
      <span>params</span> 
     </div> 
     <div> 
      <span>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; success</span> 
      <span>:</span> 
      <span>(</span> 
      <span>HYBResponseSuccess</span> 
      <span>)</span> 
      <span>success</span> 
     </div> 
     <div> 
      <span>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;fail</span> 
      <span>:</span> 
      <span>(</span> 
      <span>HYBResponseFail</span> 
      <span>)</span> 
      <span>fail</span> 
      <span>;</span> 
     </div> 
     <div> 
      <span>+</span> 
      <span> </span> 
      <span>(</span> 
      <span>HYBURLSessionTask</span> 
      <span> </span> 
      <span>*</span> 
      <span>)</span> 
      <span>postWithUrl</span> 
      <span>:</span> 
      <span>(</span> 
      <span>NSString</span> 
      <span> </span> 
      <span>*</span> 
      <span>)</span> 
      <span>url</span> 
     </div> 
     <div> 
      <span>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;refreshCache</span> 
      <span>:</span> 
      <span>(</span> 
      <span>BOOL</span> 
      <span>)</span> 
      <span>refreshCache</span> 
     </div> 
     <div> 
      <span>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;params</span> 
      <span>:</span> 
      <span>(</span> 
      <span>NSDictionary</span> 
      <span> </span> 
      <span>*</span> 
      <span>)</span> 
      <span>params</span> 
     </div> 
     <div> 
      <span>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;progress</span> 
      <span>:</span> 
      <span>(</span> 
      <span>HYBPostProgress</span> 
      <span>)</span> 
      <span>progress</span> 
     </div> 
     <div> 
      <span>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; success</span> 
      <span>:</span> 
      <span>(</span> 
      <span>HYBResponseSuccess</span> 
      <span>)</span> 
      <span>success</span> 
     </div> 
     <div> 
      <span>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;fail</span> 
      <span>:</span> 
      <span>(</span> 
      <span>HYBResponseFail</span> 
      <span>)</span> 
      <span>fail</span> 
      <span>;</span> 
     </div> 
     <div>
       &nbsp; 
     </div> 
    </div> </td> 
  </tr> 
 </tbody> 
</table>

## 图片上传接口 ##

接口一次只能上传一张图片，通常也是这么处理的。这里是以文件流的形式来上传的哦。其中，`mineType`为`image/jpeg`。

<table> 
 <tbody> 
  <tr> 
   <td> 
    <div style="font-size:15px!important; line-height:20px!important"> 
     <div>
       1 
     </div> 
     <div>
       2 
     </div> 
     <div>
       3 
     </div> 
     <div>
       4 
     </div> 
     <div>
       5 
     </div> 
     <div>
       6 
     </div> 
     <div>
       7 
     </div> 
     <div>
       8 
     </div> 
     <div>
       9 
     </div> 
     <div>
       10 
     </div> 
     <div>
       11 
     </div> 
     <div>
       12 
     </div> 
     <div>
       13 
     </div> 
     <div>
       14 
     </div> 
     <div>
       15 
     </div> 
     <div>
       16 
     </div> 
     <div>
       17 
     </div> 
     <div>
       18 
     </div> 
     <div>
       19 
     </div> 
     <div>
       20 
     </div> 
     <div>
       21 
     </div> 
     <div>
       22 
     </div> 
     <div>
       23 
     </div> 
     <div>
       24 
     </div> 
     <div>
       25 
     </div> 
     <div>
       26 
     </div> 
     <div>
       27 
     </div> 
     <div>
       28 
     </div> 
    </div> </td> 
   <td> 
    <div style=""> 
     <div>
       &nbsp; 
     </div> 
     <div> 
      <span>/**</span> 
     </div> 
     <div> 
      <span>*&nbsp;&nbsp;@author 黄仪标, 16-01-31 00:01:40</span> 
     </div> 
     <div> 
      <span>*</span> 
     </div> 
     <div> 
      <span>*&nbsp;&nbsp;图片上传接口，若不指定baseurl，可传完整的url</span> 
     </div> 
     <div> 
      <span>*</span> 
     </div> 
     <div> 
      <span>*&nbsp;&nbsp;@param image&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;图片对象</span> 
     </div> 
     <div> 
      <span>*&nbsp;&nbsp;@param url&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;上传图片的接口路径，如/path/images/</span> 
     </div> 
     <div> 
      <span>*&nbsp;&nbsp;@param filename&nbsp;&nbsp;&nbsp;&nbsp; 给图片起一个名字，默认为当前日期时间,格式为"yyyyMMddHHmmss"，后缀为`jpg`</span> 
     </div> 
     <div> 
      <span>*&nbsp;&nbsp;@param name&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; 与指定的图片相关联的名称，这是由后端写接口的人指定的，如imagefiles</span> 
     </div> 
     <div> 
      <span>*&nbsp;&nbsp;@param mimeType&nbsp;&nbsp;&nbsp;&nbsp; 默认为image/jpeg</span> 
     </div> 
     <div> 
      <span>*&nbsp;&nbsp;@param parameters&nbsp;&nbsp; 参数</span> 
     </div> 
     <div> 
      <span>*&nbsp;&nbsp;@param progress&nbsp;&nbsp;&nbsp;&nbsp; 上传进度</span> 
     </div> 
     <div> 
      <span>*&nbsp;&nbsp;@param success&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;上传成功回调</span> 
     </div> 
     <div> 
      <span>*&nbsp;&nbsp;@param fail&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; 上传失败回调</span> 
     </div> 
     <div> 
      <span>*</span> 
     </div> 
     <div> 
      <span>*&nbsp;&nbsp;@return</span> 
     </div> 
     <div> 
      <span>*/</span> 
     </div> 
     <div> 
      <span>+</span> 
      <span> </span> 
      <span>(</span> 
      <span>HYBURLSessionTask</span> 
      <span> </span> 
      <span>*</span> 
      <span>)</span> 
      <span>uploadWithImage</span> 
      <span>:</span> 
      <span>(</span> 
      <span>UIImage</span> 
      <span> </span> 
      <span>*</span> 
      <span>)</span> 
      <span>image</span> 
     </div> 
     <div> 
      <span>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; url</span> 
      <span>:</span> 
      <span>(</span> 
      <span>NSString</span> 
      <span> </span> 
      <span>*</span> 
      <span>)</span> 
      <span>url</span> 
     </div> 
     <div> 
      <span>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;filename</span> 
      <span>:</span> 
      <span>(</span> 
      <span>NSString</span> 
      <span> </span> 
      <span>*</span> 
      <span>)</span> 
      <span>filename</span> 
     </div> 
     <div> 
      <span>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;name</span> 
      <span>:</span> 
      <span>(</span> 
      <span>NSString</span> 
      <span> </span> 
      <span>*</span> 
      <span>)</span> 
      <span>name</span> 
     </div> 
     <div> 
      <span>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;mimeType</span> 
      <span>:</span> 
      <span>(</span> 
      <span>NSString</span> 
      <span> </span> 
      <span>*</span> 
      <span>)</span> 
      <span>mimeType</span> 
     </div> 
     <div> 
      <span>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;parameters</span> 
      <span>:</span> 
      <span>(</span> 
      <span>NSDictionary</span> 
      <span> </span> 
      <span>*</span> 
      <span>)</span> 
      <span>parameters</span> 
     </div> 
     <div> 
      <span>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;progress</span> 
      <span>:</span> 
      <span>(</span> 
      <span>HYBUploadProgress</span> 
      <span>)</span> 
      <span>progress</span> 
     </div> 
     <div> 
      <span>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; success</span> 
      <span>:</span> 
      <span>(</span> 
      <span>HYBResponseSuccess</span> 
      <span>)</span> 
      <span>success</span> 
     </div> 
     <div> 
      <span>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;fail</span> 
      <span>:</span> 
      <span>(</span> 
      <span>HYBResponseFail</span> 
      <span>)</span> 
      <span>fail</span> 
      <span>;</span> 
     </div> 
     <div>
       &nbsp; 
     </div> 
    </div> </td> 
  </tr> 
 </tbody> 
</table>

## 上传文件接口 ##

## 文件下载接口 ##

# 取消请求 #

在使用中，可以通过这样来调用：

# 缓存 #

# BaseURL #

这里还提供了两个公共接口，一个是用于设置或者更新网络接口的基础URL，一个是获取当前设置使用的网络接口基础URL。

# 添加公共请求头参数 #

通常每家公司的接口都会设置公共的请求头参数，以代表是公司的接口。默认已经配置了可接收的类型，但是如果需要额外配置，可通过调用此`api`来添加：

# 请求、响应类型 #

默认responseType和requestType都是JSON格式。如果不使用JSON，可以全局配置成自己希望的格式即可。若不配置，默认就是JSON。

# URL编码问题 #

考虑到网络请求接口中，有时候会有中文参数，这时候就会请求失败，因此我们要对这种类型的`URL`进行编码，否则请求会失败。这里是开启或者关闭自动将`URL`编码的接口，默认为NO，表示不开启。

# 格式化接口数据打印日志 #

开启后会有非常好的打印效果，效果如下：

![image][]

通常在`AppDelegate`中应用启动的代理方法中调用设置为开启就可以了。不过是否设置为开启，当应用以发布证书打包时，都不会打印日志，因为这里做了处理，可放心使用。现在已经公开在外部，项目中都可以使用哦：

<table> 
 <tbody> 
  <tr> 
   <td> 
    <div style="font-size:15px!important; line-height:20px!important"> 
     <div>
       1 
     </div> 
     <div>
       2 
     </div> 
     <div>
       3 
     </div> 
     <div>
       4 
     </div> 
     <div>
       5 
     </div> 
     <div>
       6 
     </div> 
     <div>
       7 
     </div> 
     <div>
       8 
     </div> 
    </div> </td> 
   <td> 
    <div style=""> 
     <div>
       &nbsp; 
     </div> 
     <div> 
      <span>// 项目打包上线都不会打印日志，因此可放心。</span> 
     </div> 
     <div> 
      <span>#ifdef DEBUG</span> 
     </div> 
     <div> 
      <span>#define HYBAppLog(s, ... ) NSLog( @"[%@ in line %d] ===============&gt;%@", [[NSString stringWithUTF8String:__FILE__] lastPathComponent], __LINE__, [NSString stringWithFormat:(s), ##__VA_ARGS__] )</span> 
     </div> 
     <div> 
      <span>#else</span> 
     </div> 
     <div> 
      <span>#define HYBAppLog(s, ... )</span> 
     </div> 
     <div> 
      <span>#endif</span> 
     </div> 
     <div>
       &nbsp; 
     </div> 
    </div> </td> 
  </tr> 
 </tbody> 
</table>

# 安装使用 #

现在已经支持`cocoapods`，引入以下命令即可：

<table> 
 <tbody> 
  <tr> 
   <td> 
    <div style="font-size:15px!important; line-height:20px!important"> 
     <div>
       1 
     </div> 
     <div>
       2 
     </div> 
     <div>
       3 
     </div> 
    </div> </td> 
   <td> 
    <div style=""> 
     <div>
       &nbsp; 
     </div> 
     <div> 
      <span>pod</span> 
      <span> </span> 
      <span>'HYBNetworking'</span> 
      <span>,</span> 
      <span> </span> 
      <span>'~&gt; 3.0.0'</span> 
     </div> 
     <div>
       &nbsp; 
     </div> 
    </div> </td> 
  </tr> 
 </tbody> 
</table>

或者直接下载源代码，拖入工程使用！

# 源代码 #

请大家到我的`github`下载源代码：[HYBNetworking][]

# 温馨提示 #

最近老有人问：编译一直报错library not found for -lAFNetworking什么问题？

**注意：**如果您是使用cocoapods来管理第三方库的，那么直接通过上面安装使用的方式来安装即可，然后pod update一下。如果您不是使用cocoapods来引入的，请手动将AFNetworking对应的版本添加到工程。

[AFNetworking2.5]: http://www.henishuo.com/base-on-afnetworking-wrapper/
[image]: http://7xrs9h.com1.z0.glb.clouddn.com/wp-content/uploads/2016/03/QQ20160325-0@2x-1-e1458921436643.png
[HYBNetworking]: https://github.com/CoderJackyHuang/HYBNetworking