概述
对于开发人员来说，学习网络层知识是必备的，任何一款App的开发，都需要到网络请求接口。很多朋友都还在使用原生的NSURLConnection一行一行地写，代码到处是，这样维护起来更困难了。
对于使用AFNetworking的朋友来说，很多朋友都是直接调用AFNetworking的API，这样不太好，无法做到全工程统一配置。
最好的方式就是对网络层再封装一层，全工程不允许直接使用AFNetworking的API，必须调用我们自己封装的一层，如此一来，任何网络配置都可以在这一层里配置好，使用的人无须知道里面在干嘛，只管调用就可以了。
本篇为基于AFNetworking3.0以上的版本，支持iOS7及其以上版本。若要支持iOS6，请阅读旧版本：基于AFNetworking2.5封装，旧版本不再维护！
常用接口类型
应用开发过程中，所使用类型通常是GET、POST及上传图片。因此，这里只是对这几种类型提供API。
GET接口
这里提供了两个GET请求的API，需要一般情况下GET请求都是直接写一个完整的URL，但是有时候为了参数可读性更强，改成传一个字典过来更容易阅读。
HYBResponseSuccess是响应成功的回调，返回的是字典，外部再转换成模型就可以了。
HYBResponseFail是响应失败的回调，只有一个NSError对象，外部可接收处理。
|
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
|
/*!
* @author 黄仪标, 15-11-15 13:11:50
*
* GET请求接口，若不指定baseurl，可传完整的url
*
* @param url 接口路径，如/path/getArticleList
* @param refreshCache 是否刷新缓存。由于请求成功也可能没有数据，对于业务失败，只能通过人为手动判断
* @param params 接口中所需要的拼接参数，如@{"categoryid" : @(12)}
* @param success 接口成功请求到数据的回调
* @param fail 接口请求数据失败的回调
*
* @return 返回的对象中有可取消请求的API
*/
+
(
HYBURLSessionTask
*
)
getWithUrl
:
(
NSString
*
)
url
refreshCache
:
(
BOOL
)
refreshCache
success
:
(
HYBResponseSuccess
)
success
fail
:
(
HYBResponseFail
)
fail
;
// 多一个params参数
+
(
HYBURLSessionTask
*
)
getWithUrl
:
(
NSString
*
)
url
refreshCache
:
(
BOOL
)
refreshCache
params
:
(
NSDictionary
*
)
params
success
:
(
HYBResponseSuccess
)
success
fail
:
(
HYBResponseFail
)
fail
;
// 多一个带进度回调
+
(
HYBURLSessionTask
*
)
getWithUrl
:
(
NSString
*
)
url
refreshCache
:
(
BOOL
)
refreshCache
params
:
(
NSDictionary
*
)
params
progress
:
(
HYBGetProgress
)
progress
success
:
(
HYBResponseSuccess
)
success
fail
:
(
HYBResponseFail
)
fail
;
|
POST接口
对于POST请求类型的接口，只有一个，看注释就可以明白如何使用了。
|
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
|
/*!
* @author 黄仪标, 15-11-15 13:11:50
*
* POST请求接口，若不指定baseurl，可传完整的url
*
* @param url 接口路径，如/path/getArticleList
* @param params 接口中所需的参数，如@{"categoryid" : @(12)}
* @param success 接口成功请求到数据的回调
* @param fail 接口请求数据失败的回调
*
* @return 返回的对象中有可取消请求的API
*/
+
(
HYBURLSessionTask
*
)
postWithUrl
:
(
NSString
*
)
url
refreshCache
:
(
BOOL
)
refreshCache
params
:
(
NSDictionary
*
)
params
success
:
(
HYBResponseSuccess
)
success
fail
:
(
HYBResponseFail
)
fail
;
+
(
HYBURLSessionTask
*
)
postWithUrl
:
(
NSString
*
)
url
refreshCache
:
(
BOOL
)
refreshCache
params
:
(
NSDictionary
*
)
params
progress
:
(
HYBPostProgress
)
progress
success
:
(
HYBResponseSuccess
)
success
fail
:
(
HYBResponseFail
)
fail
;
|
图片上传接口
接口一次只能上传一张图片，通常也是这么处理的。这里是以文件流的形式来上传的哦。其中，mineType为image/jpeg。
|
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
|
/**
* @author 黄仪标, 16-01-31 00:01:40
*
* 图片上传接口，若不指定baseurl，可传完整的url
*
* @param image 图片对象
* @param url 上传图片的接口路径，如/path/images/
* @param filename 给图片起一个名字，默认为当前日期时间,格式为"yyyyMMddHHmmss"，后缀为`jpg`
* @param name 与指定的图片相关联的名称，这是由后端写接口的人指定的，如imagefiles
* @param mimeType 默认为image/jpeg
* @param parameters 参数
* @param progress 上传进度
* @param success 上传成功回调
* @param fail 上传失败回调
*
* @return
*/
+
(
HYBURLSessionTask
*
)
uploadWithImage
:
(
UIImage
*
)
image
url
:
(
NSString
*
)
url
filename
:
(
NSString
*
)
filename
name
:
(
NSString
*
)
name
mimeType
:
(
NSString
*
)
mimeType
parameters
:
(
NSDictionary
*
)
parameters
progress
:
(
HYBUploadProgress
)
progress
success
:
(
HYBResponseSuccess
)
success
fail
:
(
HYBResponseFail
)
fail
;
|
上传文件接口
|
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
|
/**
* @author 黄仪标, 16-01-31 00:01:59
*
* 上传文件操作
*
* @param url 上传路径
* @param uploadingFile 待上传文件的路径
* @param progress 上传进度
* @param success 上传成功回调
* @param fail 上传失败回调
*
* @return
*/
+
(
HYBURLSessionTask
*
)
uploadFileWithUrl
:
(
NSString
*
)
url
uploadingFile
:
(
NSString
*
)
uploadingFile
progress
:
(
HYBUploadProgress
)
progress
success
:
(
HYBResponseSuccess
)
success
fail
:
(
HYBResponseFail
)
fail
;
|
文件下载接口
|
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
|
/*!
* @author 黄仪标, 16-01-08 15:01:11
*
* 下载文件
*
* @param url 下载URL
* @param saveToPath 下载到哪个路径下
* @param progressBlock 下载进度
* @param success 下载成功后的回调
* @param failure 下载失败后的回调
*/
+
(
HYBURLSessionTask
*
)
downloadWithUrl
:
(
NSString
*
)
url
saveToPath
:
(
NSString
*
)
saveToPath
progress
:
(
HYBDownloadProgress
)
progressBlock
success
:
(
HYBResponseSuccess
)
success
failure
:
(
HYBResponseFail
)
failure
;
|
取消请求
|
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
|
/**
* @author 黄仪标
*
* 取消所有请求
*/
+
(
void
)
cancelAllRequest
;
/**
* @author 黄仪标
*
* 取消某个请求。如果是要取消某个请求，最好是引用接口所返回来的HYBURLSessionTask对象，
* 然后调用对象的cancel方法。如果不想引用对象，这里额外提供了一种方法来实现取消某个请求
*
* @param url URL，可以是绝对URL，也可以是path（也就是不包括baseurl）
*/
+
(
void
)
cancelRequestWithURL
:
(
NSString
*
)
url
;
|
在使用中，可以通过这样来调用：
|
1
2
3
4
5
6
7
8
|
// 取消全部请求
// [HYBNetworking cancelAllRequest];
// 取消单个请求方法一
// [HYBNetworking cancelRequestWithURL:path];
// 取消单个请求方法二
// [task cancel];
|
缓存
|
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
|
/**
* @author 黄仪标
*
* 默认只缓存GET请求的数据，对于POST请求是不缓存的。如果要缓存POST获取的数据，需要手动调用设置
* 对JSON类型数据有效，对于PLIST、XML不确定！
*
* @param isCacheGet 默认为YES
* @param shouldCachePost 默认为NO
*/
+
(
void
)
cacheGetRequest
:
(
BOOL
)
isCacheGet
shoulCachePost
:
(
BOOL
)
shouldCachePost
;
/**
* @author 黄仪标
*
* 获取缓存总大小/bytes
*
* @return 缓存大小
*/
+
(
unsigned
long
long
)
totalCacheSize
;
/**
* @author 黄仪标
*
* 清除缓存
*/
+
(
void
)
clearCaches
;
/**
* 默认不会自动清除缓存，如果需要，可以设置自动清除缓存，并且需要指定上限。当指定上限>0M时，
* 若缓存达到了上限值，则每次启动应用则尝试自动去清理缓存。
*
* @param mSize 缓存上限大小，单位为M（兆），默认为0，表示不清理
*/
+
(
void
)
autoToClearCacheWithLimitedToSize
:
(
NSUInteger
)
mSize
;
|
BaseURL
这里还提供了两个公共接口，一个是用于设置或者更新网络接口的基础URL，一个是获取当前设置使用的网络接口基础URL。
|
1
2
3
4
5
6
7
8
9
10
11
12
|
/*!
* @author 黄仪标, 15-11-15 13:11:45
*
* 用于指定网络请求接口的基础url，如：
* http://henishuo.com或者http://101.200.209.244
* 通常在AppDelegate中启动时就设置一次就可以了。如果接口有来源
* 于多个服务器，可以调用更新
*
* @param baseUrl 网络接口的基础url
*/
+
(
void
)
updateBaseUrl
:
(
NSString
*
)
baseUrl
;
+
(
NSString
*
)
baseUrl
;
|
添加公共请求头参数
通常每家公司的接口都会设置公共的请求头参数，以代表是公司的接口。默认已经配置了可接收的类型，但是如果需要额外配置，可通过调用此api来添加：
|
1
2
3
4
5
6
7
8
|
/*!
* @author 黄仪标, 15-11-16 13:11:41
*
* 配置公共的请求头，只调用一次即可，通常放在应用启动的时候配置就可以了
*
* @param httpHeaders 只需要将与服务器商定的固定参数设置即可
*/
+
(
void
)
configCommonHttpHeaders
:
(
NSDictionary
*
)
httpHeaders
;
|
请求、响应类型
默认responseType和requestType都是JSON格式。如果不使用JSON，可以全局配置成自己希望的格式即可。若不配置，默认就是JSON。
|
1
2
3
4
5
6
7
8
9
10
11
12
13
14
|
/*!
* @author 黄仪标, 15-12-25 15:12:45
*
* 配置请求格式，默认为JSON。如果要求传XML或者PLIST，请在全局配置一下
*
* @param requestType 请求格式，默认为JSON
* @param responseType 响应格式，默认为JSO，
* @param shouldAutoEncode YES or NO,默认为NO，是否自动encode url
* @param shouldCallbackOnCancelRequest 当取消请求时，是否要回调，默认为YES
*/
+
(
void
)
configRequestType
:
(
HYBRequestType
)
requestType
responseType
:
(
HYBResponseType
)
responseType
shouldAutoEncodeUrl
:
(
BOOL
)
shouldAutoEncode
callbackOnCancelRequest
:
(
BOOL
)
shouldCallbackOnCancelRequest
;
|
URL编码问题
考虑到网络请求接口中，有时候会有中文参数，这时候就会请求失败，因此我们要对这种类型的URL进行编码，否则请求会失败。这里是开启或者关闭自动将URL编码的接口，默认为NO，表示不开启。
|
1
2
3
4
5
6
7
8
|
/*!
* @author 黄仪标, 15-11-15 15:11:16
*
* 开启或关闭是否自动将URL使用UTF8编码，用于处理链接中有中文时无法请求的问题
*
* @param shouldAutoEncode YES or NO,默认为NO
*/
+
(
void
)
shouldAutoEncodeUrl
:
(
BOOL
)
shouldAutoEncode
;
|
格式化接口数据打印日志
|
1
2
3
4
5
6
7
8
|
/*!
* @author 黄仪标, 15-11-15 14:11:40
*
* 开启或关闭接口打印信息
*
* @param isDebug 开发期，最好打开，默认是NO
*/
+
(
void
)
enableInterfaceDebug
:
(
BOOL
)
isDebug
;
|
通常在AppDelegate中应用启动的代理方法中调用设置为开启就可以了。不过是否设置为开启，当应用以发布证书打包时，都不会打印日志，因为这里做了处理，可放心使用。现在已经公开在外部，项目中都可以使用哦：
|
1
2
3
4
5
6
|
// 项目打包上线都不会打印日志，因此可放心。
#ifdef DEBUG
#define HYBAppLog(s, ... ) NSLog( @"[%@ in line %d] ===============>%@", [[NSString stringWithUTF8String:__FILE__] lastPathComponent], __LINE__, [NSString stringWithFormat:(s), ##__VA_ARGS__] )
#else
#define HYBAppLog(s, ... )
#endif
|
安装使用
现在已经支持cocoapods，引入以下命令即可：
|
1
|
pod
'HYBNetworking'
,
'~> 3.3.0'
|
或者直接下载源代码，拖入工程使用！
源代码
请大家到我的github下载源代码：HYBNetworking
温馨提示
最近老有人问：编译一直报错library not found for -lAFNetworking什么问题？
注意：如果您是使用cocoapods来管理第三方库的，那么直接通过上面安装使用的方式来安装即可，然后pod update一下。如果您不是使用cocoapods来引入的，请手动将AFNetworking对应的版本添加到工程。
历史版本变化
- 1.1
- 升级AFNetworking到2.5.4
- 新增带上传进度的API和带进度的下载API，详细请阅读下面的博文
- 1.1.1
- 修改原来默认URLEncode由YES改为NO。
- 1.1.2
- 追加text/plain格式
- 1.1.3
- 追加两个兼容性API，图片上传时可额外上传参数
- 2.0.0
- 升级AFNetworking到3.0，基于AFNetworking3.0.4而写的版本
- 支持iOS7.0及其以上版本
- 2.0.1
- fix pod安装2.0.0却是1.1.3版本的问题
- 3.0.0
- 简化API，以降低使用的要求
- 增加GET/POST数据缓存、获取缓存大小、清空缓存功能
- 接口增加刷新缓存功能
- 增加取消所有请求、取消单个请求功能
- 格式化打印日志
- 增加对手动取消请求接口是否在失败时还回调的控制
- 3.1.0
- fix download data can’t start request.
- 3.2.0
- 增加请求超时设置
- 增加配置是否在网络异常（无网络）时自动尝试从本地读取缓存。
- 3.2.1
- 完善无网状态下缓存的处理
- 3.2.2
- 将download url存储修改
- 3.2.3
- 修改默认requestType为plainText，以解决很多小伙伴们出现后台接收不到参数的问题！
- 3.3.0
- 修改AFSessionManager获取方式为只使用一个，除非修改了BASEURL，否则一直使用同一个
- 增加了自动清除缓存的策略，由开发者决定是否自动清除缓存，可设置上限大小
关注标哥
| 联系方式 | 关注 | 备注 |
|---|---|---|
| 合作联系群 | 347363861 | 接项目、私活 |
| iOS直播音视频技术 | 256239496(群6满) | 实名制且群规严，定期清理 |
| 标哥博客iOS交流群 | 211039962(群7新) | 群里很活跃，定期清理 |
| 标哥博客iOS交流群 | 324400294(群1满)|494669518(群2满)|494669518(群3满) 250351140(群4满)|552095943(群5满) | 群里很活跃，定期清理 |
| 微信公众号 | iOSDevShares或者iOS开发技术分享 | 关注公众号阅读好文章 |
| 新浪微博 | @标哥的技术博客 | 关注微博动态 |
| GITHUB | CoderJackyHuang | 文章Demo都在GITHUB |
| 联系标哥 | 关于标哥 | 保持活跃在最前线 |
版权声明：本文为
【标哥的技术博客】原创出品，欢迎转载，转载时请注明出处！
扫一扫
472
被折叠的 条评论
为什么被折叠?
到【灌水乐园】发言
