一、AFNetworking概述
使用Object-C语言的开发者都知道,AFNetworking是一个开发iOS应用程序必备的网络库,主要实现了底层网络通讯。有了这个网络库,我们开发者可以少关注底层网络,把更多的注意力放在我们的业务上。这样大大地提升我们的开发效率。
注:做iOS开发,有Object-C和Swift两门语言。对于使用Swift的开发者来说,不会使用AFNetworking网络库,而是使用Alamofire网络库。这个库是由AFNetworking的原班开发人员,使用Swift开发出来的。
二、版本差异
正如上文所说,AFNetworking从发布之日起,就得到了众多iOS开发者的青睐,迄今为止,已经发展到4.0版本。
下面简单描述下各个版本的差异:
- AFNetworking 1.0 是基于NSURLConnection开发出来的。而NSURLConnection是苹果早些年提供的网络通讯的API接口。目前该接口已经废弃。
- AFNetworking 2.0 是基于部分NSURLConnection接口 和部分NSURLSession接口开发的。简单来说,2.0是介于NSURLConnection和NSURLSession的过渡阶段。其中NSURLSession接口是苹果提供且目前主推的网络通讯API接口。
- AFNetworking 3.0 完全基于NSURLSession开发,此版本中的NSURLConnection全部弃用。这样不仅降低了代码维护工作,还更好地支持了NSURLSession提供的额外功能。
- AFNetworking 4.0 是2020年发布的。主要是配合苹果公司弃用UIWebView控件的升级,同时也移除之前弃用的API接口。不过要特别说明,这个版本支持的iOS版是9.0(之前是7.0),macOS 10.10。
三、AFNetworking源码获取方式
源码地址:
https://github.com/AFNetworking/AFNetworking
四、AFNetworking 框架使用方法
1.引入工程
a.编辑podfile,引入AFNetworking的脚本,如下所示。
platform :ios,'9.0'
pod 'AFNetworking', '~> 4.0'
保存这个 podfile 文件并退出。
b.下载 AFNetworking。在 MAC 终端窗口,输入命令:
pod install
2.工程文件介绍
AFNetworking 4.0主要由三大类文件。
注:
2.1 作为会话管理器的有
AFURLSessionManager,AFHTTPSessionManager。
分别表示URL和HTTP两种类型。
2.2 文件名中带Serializtion字段为序列化文件。主要做发起请求和响应处理的序列化操作。目前支持二进制、JSON、XML和PropertyList四种格式。
2.3 AFSecuritPolicy文件主要做安全方面的,如TLS,SSL。
2.4 AFNetworkReachabilityManager是网络监测模块,有无网络,WIFI、数据网络(4G)等网络情况。
3. 发起一个Get请求实例
NSURLSessionConfiguration *configuration = [NSURLSessionConfiguration defaultSessionConfiguration];
AFURLSessionManager *manager = [[AFURLSessionManager alloc] initWithSessionConfiguration:configuration];
NSURL *URL = [NSURL URLWithString:@"http://baidu.com/get"];
NSURLRequest *request = [NSURLRequest requestWithURL:URL];
NSURLSessionDataTask *dataTask = [manager dataTaskWithRequest:request completionHandler:^(NSURLResponse *response, id responseObject, NSError *error) {
if (error) {
NSLog(@"Error: %@", error);
} else {
NSLog(@"%@ %@", response, responseObject);
}
}];
[dataTask resume];
五、AFNetworking的二次封装
以上是AFNetworking的介绍。但在实际项目开发过程中,业务模块一般很少直接使用AFNetworking API(如果直接调用 AFNetworking的API,一个显示程序员的技术水平不那么地牛逼;二是实际开发中,无法做到整个工程的统一配置)。
所以我们建议最好的方式就是对AFNetworking做二次封装(工程内不直接直接使用 AFNetworking 的 API,而是使用二次封装好的API)。
这样做至少有三大好处:
1.统一了配置接口。方便统一管理和维护。
2.对AFNetworking接口进行了屏蔽,使用者不需要知道内部实现细节,只关注调用。
3.当AFNetworking升级或变化时,二次封装的接口不用动。
当然,对于二次封装,有以下几个方面的考虑:
1.对AFNetworking中的GET、POST、DELETE等请求进行处理,最好是由AFNetworking中是参数变成业务API接口。
2.对网络状态进行处理。包括不限于有无网络,WIFI网络,4G网络。
3.提供统一的,简化的业务API接口。理想情况下,只需要业务模块输入一个请求数据,返回返回数据即可。对于timeout,header参数,网络层默认处理。
4.针对网络请求异常,提供简化的异常处理机制。使业务更简单、更方便的使用。
以下举一个实际项目中的例子。
//发送GET请求,返回数据在handler中
//对外开放
- (void)queryDataWithGet:(NSString*)url Param:(NSDictionary*)dic CompleteHandler:(CompleteHandler)handler {
[self queryData:url Param:dic Method:"GET" Header:nil Timeout:30.0f CompleteHandler:handler];
}
//发送POST请求,返回数据在handler中
//对外开放
- (void)queryDataWithPost:(NSString*)url Param:(NSDictionary*)dic CompleteHandler:(CompleteHandler)handler {
[self queryData:url Param:dic Method:"POST" Header:nil Timeout:30.0f CompleteHandler:handler];
}
//处理所有的GET,POST,DELETE等请求
//内部接口,不对外开放
- (void)queryData:(NSString*)url Param:(NSDictionary*)dic Method:(NSString*)method Header:(NSDictionary*)header Timeout:(float)timeout CompleteHandler:(CompleteHandler)handler {
//….调用AFNetwroking底层库代码
}
注:
1.对外开放的接口为固定的GET,POST等接口,接口固定。
2.对外开放的接口参数精简化,只有url,参数和返回数据三个参数。header和timeout由模块统一配置。
3.内部还统一一个接口。实现所有接口的汇集,方便统一配置和处理。
以上就是AFNetworking基本介绍。