前言
对于开发人员来说，学习网络层知识是必备的，任何一款App的开发，都需要到网络请求接口。很多朋友都还在使用原生的NSURLConnection一行一行地写，代码到处是，这样维护起来更困难了。
对于使用AFNetworking的朋友来说，很多朋友都是直接调用AFNetworking的API，这样不太好，无法做到全工程统一配置。
最好的方式就是对网络层再封装一层，全工程不允许直接使用AFNetworking的API，必须调用我们自己封装的一层，如此一来，任何网络配置都可以在这一层里配置好，使用的人无须知道里面在干嘛，只管调用就可以了。
常用接口类型
应用开发过程中，所使用类型通常是GET、POST及上传图片。因此，这里只是对这几种类型提供API。
GET接口
这里提供了两个GET请求的API，需要一般情况下GET请求都是直接写一个完整的URL，但是有时候为了参数可读性更强，改成传一个字典过来更容易阅读。
HYBResponseSuccess是响应成功的回调，返回的是字典，外部再转换成模型就可以了。HYBResponseFail是响应失败的回调，只有一个NSError对象，外部可接收处理。
1 /*!
2 * @author 黄仪标, 15-11-15 13:11:50
3 *
4 * GET请求接口，若不指定baseurl，可传完整的url
5 *
6 * @param url 接口路径，如/path/getArticleList?categoryid=1
7 * @param success 接口成功请求到数据的回调
8 * @param fail 接口请求数据失败的回调
9 *
10 * @return 返回的对象中有可取消请求的API
11 */
12 + (HYBURLSessionTask *)getWithUrl:(NSString *)url
13 success:(HYBResponseSuccess)success
14 fail:(HYBResponseFail)fail;
15 /*!
16 * @author 黄仪标, 15-11-15 13:11:50
17 *
18 * GET请求接口，若不指定baseurl，可传完整的url
19 *
20 * @param url 接口路径，如/path/getArticleList
21 * @param params 接口中所需要的拼接参数，如@{"categoryid" : @(12)}
22 * @param success 接口成功请求到数据的回调
23 * @param fail 接口请求数据失败的回调
24 *
25 * @return 返回的对象中有可取消请求的API
26 */
27 + (HYBURLSessionTask *)getWithUrl:(NSString *)url
28 params:(NSDictionary *)params
29 success:(HYBResponseSuccess)success
30 fail:(HYBResponseFail)fail;
31
32 // 支持进度
33 + (HYBURLSessionTask *)getWithUrl:(NSString *)url
34 params:(NSDictionary *)params
35 progress:(HYBGetProgress)progress
36 success:(HYBResponseSuccess)success
37 fail:(HYBResponseFail)fail;
POST接口
对于POST请求类型的接口，只有一个，看注释就可以明白如何使用了。
1 /*!
2 * @author 黄仪标, 15-11-15 13:11:50
3 *
4 * POST请求接口，若不指定baseurl，可传完整的url
5 *
6 * @param url 接口路径，如/path/getArticleList
7 * @param params 接口中所需的参数，如@{"categoryid" : @(12)}
8 * @param success 接口成功请求到数据的回调
9 * @param fail 接口请求数据失败的回调
10 *
11 * @return 返回的对象中有可取消请求的API
12 */
13 + (HYBURLSessionTask *)postWithUrl:(NSString *)url
14 params:(NSDictionary *)params
15 success:(HYBResponseSuccess)success
16 fail:(HYBResponseFail)fail;
17
18 // 支持进度
19 + (HYBURLSessionTask *)postWithUrl:(NSString *)url
20 params:(NSDictionary *)params
21 progress:(HYBPostProgress)progress
22 success:(HYBResponseSuccess)success
23 fail:(HYBResponseFail)fail;`
图片上传接口
接口一次只能上传一张图片，通常也是这么处理的。这里是以文件流的形式来上传的哦。其中，mineType为image/jpeg。
1 /**
2 * @author 黄仪标, 16-01-31 00:01:40
3 *
4 * 图片上传接口，若不指定baseurl，可传完整的url
5 *
6 * @param image 图片对象
7 * @param url 上传图片的接口路径，如/path/images/
8 * @param filename 给图片起一个名字，默认为当前日期时间,格式为"yyyyMMddHHmmss"，后缀为`jpg`
9 * @param name 与指定的图片相关联的名称，这是由后端写接口的人指定的，如imagefiles
10 * @param mimeType 默认为image/jpeg
11 * @param parameters 参数
12 * @param progress 上传进度
13 * @param success 上传成功回调
14 * @param fail 上传失败回调
15 *
16 * @return
17 */
18 + (HYBURLSessionTask *)uploadWithImage:(UIImage *)image
19 url:(NSString *)url
20 filename:(NSString *)filename
21 name:(NSString *)name
22 mimeType:(NSString *)mimeType
23 parameters:(NSDictionary *)parameters
24 progress:(HYBUploadProgress)progress
25 success:(HYBResponseSuccess)success
26 fail:(HYBResponseFail)fail;
27
| |
设置基础URL
这里还提供了两个公共接口，一个是用于设置或者更新网络接口的基础URL，一个是获取当前设置使用的网络接口基础URL。
1 /*!
2 * @author 黄仪标, 15-11-15 13:11:45
3 *
4 * 用于指定网络请求接口的基础url，如：
5 * http://henishuo.com或者http://101.200.209.244
6 * 通常在AppDelegate中启动时就设置一次就可以了。如果接口有来源
7 * 于多个服务器，可以调用更新
8 *
9 * @param baseUrl 网络接口的基础url
10 */
11 + (void)updateBaseUrl:(NSString *)baseUrl;
12
13 /*!
14 * @author 黄仪标, 15-11-15 13:11:06
15 *
16 * 对外公开可获取当前所设置的网络接口基础url
17 *
18 * @return 当前基础url
19 */
20 + (NSString *)baseUrl;
添加公共请求头参数
通常每家公司的接口都会设置公共的请求头参数，以代表是公司的接口。默认已经配置了可接收的类型，但是如果需要额外配置，可通过调用此api来添加：
1 /*!
2 * @author 黄仪标, 15-11-16 13:11:41
3 *
4 * 配置公共的请求头，只调用一次即可，通常放在应用启动的时候配置就可以了
5 *
6 * @param httpHeaders 只需要将与服务器商定的固定参数设置即可
7 */
8 + (void)configCommonHttpHeaders:(NSDictionary *)httpHeaders;
9
|
|
请求与响应格式设置
默认responseType和requestType都是JSON格式。如果不使用JSON，可以全局配置成自己希望的格式即可。若不配置，默认就是JSON。
1 /*!
2 * @author 黄仪标, 15-12-25 15:12:38
3 *
4 * 配置返回格式，默认为JSON。若为XML或者PLIST请在全局修改一下
5 *
6 * @param responseType 响应格式
7 */
8 + (void)configResponseType:(HYBResponseType)responseType;
9
10 /*!
11 * @author 黄仪标, 15-12-25 15:12:45
12 *
13 * 配置请求格式，默认为JSON。如果要求传XML或者PLIST，请在全局配置一下
14 *
15 * @param requestType 请求格式
16 */
17 + (void)configRequestType:(HYBRequestType)requestType;
URL编码问题
考虑到网络请求接口中，有时候会有中文参数，这时候就会请求失败，因此我们要对这种类型的URL进行编码，否则请求会失败。这里是开启或者关闭自动将URL编码的接口，默认为NO，表示不开启。
1 /*!
2 * @author 黄仪标, 15-11-15 14:11:40
3 *
4 * 开启或关闭接口打印信息
5 *
6 * @param isDebug 开发期，最好打开，默认是NO
7 */
8 + (void)enableInterfaceDebug:(BOOL)isDebug;
9
10 /*!
11 * @author 黄仪标, 15-11-15 15:11:16
12 *
13 * 开启或关闭是否自动将URL使用UTF8编码，用于处理链接中有中文时无法请求的问题
14 *
15 * @param shouldAutoEncode YES or NO,默认为NO
16 */
17 + (void)shouldAutoEncodeUrl:(BOOL)shouldAutoEncode;
网络接口数据日志
对于网络请求回来的结果，如果没有一个格式化好的日志打印出来查看，就要通过断点一步步跟踪，然后打开出来看，这太麻烦。因此，这里提供了打印日志的私有API。默认是不开启打印日志的。
1 /*!
2 * @author 黄仪标, 15-11-15 14:11:40
3 *
4 * 开启或关闭接口打印信息
5 *
6 * @param isDebug 开发期，最好打开，默认是NO
7 */
8 + (void)enableInterfaceDebug:(BOOL)isDebug;
|
|
通常在AppDelegate中应用启动的代理方法中调用设置为开启就可以了。不过是否设置为开启，当应用以发布证书打包时，都不会打印日志，因为这里做了处理，可放心使用。
1 // 项目打包上线都不会打印日志，因此可放心。
2 #ifdef DEBUG
3 #define HYBAppLog(s, ... ) NSLog( @"[%@：in line: %d]-->[message: %@]", [[NSString stringWithUTF8String:__FILE__] lastPathComponent], __LINE__, [NSString stringWithFormat:(s), ##__VA_ARGS__] )
4 #else
5 #define HYBAppLog(s, ... )
6 #endif
安装使用
现在已经支持cocoapods，引入以下命令即可：
1 pod 'HYBNetworking', '~> 2.0.0' 2
温馨提示
最近老有人问：编译一直报错library not found for -lAFNetworking什么问题？
注意：如果您是使用cocoapods来管理第三方库的，那么直接通过上面安装使用的方式来安装即可，然后pod update一下。如果您不是使用cocoapods来引入的，请手动将AFNetworking对应的版本添加到工程。
