HYBNetworking

概述

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

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

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

本篇为基于AFNetworking3.0以上的版本,支持iOS7及其以上版本。若要支持iOS6,请阅读旧版本:基于AFNetworking2.5封装,旧版本不再维护!

常用接口类型

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

GET接口

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

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

POST接口

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

图片上传接口

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

上传文件接口

文件下载接口

取消请求

在使用中,可以通过这样来调用:

缓存

BaseURL

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

添加公共请求头参数

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

请求、响应类型

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

URL编码问题

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

格式化接口数据打印日志

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


安装使用

现在已经支持cocoapods,引入以下命令即可:

或者直接下载源代码,拖入工程使用!

源代码

请大家到我的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
联系标哥 关于标哥 保持活跃在最前线
版权声明:本文为【标哥的技术博客】原创出品,欢迎转载,转载时请注明出处!
1 2 收藏 评论

相关文章

可能感兴趣的话题



直接登录
跳到底部
返回顶部