AFNetworking3.0源码解读（一）之 AFNetworkReachabilityManager

谁践踏了优雅 2023-10-17 14:55 34阅读 0赞

转载链接博主博客地址：[马在路上][Link 1]

[AFNetworking 3.0 源码解读（二）之 AFSecurityPolicy][AFNetworking 3.0 _ AFSecurityPolicy]

[AFNetworking 3.0 源码解读（三）之 AFURLRequestSerialization][AFNetworking 3.0 _ AFURLRequestSerialization]

[AFNetworking 3.0 源码解读（四）之 AFURLResponseSerialization][AFNetworking 3.0 _ AFURLResponseSerialization]

[AFNetworking 3.0 源码解读（五）之 AFURLSessionManager][AFNetworking 3.0 _ AFURLSessionManager]

[AFNetworking 3.0 源码解读（六）之 AFHTTPSessionManager][AFNetworking 3.0 _ AFHTTPSessionManager]

[AFNetworking 3.0 源码解读（七）之 AFAutoPurgingImageCache][AFNetworking 3.0 _ AFAutoPurgingImageCache]

[AFNetworking 3.0 源码解读（八）之 AFImageDownloader][AFNetworking 3.0 _ AFImageDownloader]

[AFNetworking 3.0 源码解读（九）之 AFNetworkActivityIndicatorManager][AFNetworking 3.0 _ AFNetworkActivityIndicatorManager]

[AFNetworking 3.0 源码解读（十）之 UIActivityIndicatorView/UIRefreshControl/UIImageView + AFNetworking][AFNetworking 3.0 _ UIActivityIndicatorView_UIRefreshControl_UIImageView _ AFNetworking]

[AFNetworking 3.0 源码解读（十一）之 UIButton/UIProgressView/UIWebView + AFNetworking][AFNetworking 3.0 _ UIButton_UIProgressView_UIWebView _ AFNetworking]

[AFNetworking 3.0 源码解读 总结（干货）（上）][AFNetworking 3.0 _]

[AFNetworking 3.0 源码解读 总结（干货）（下）][AFNetworking 3.0 _ 1]

博主看了一下这位名叫马在路上博主的文章，深感解读的很好，故粘贴出来供大家参考。

做ios开发，AFNetworking 这个网络框架肯定都非常熟悉，也许我们平时只使用了它的部分功能，而且我们对它的实现原理并不是很清楚，就好像总是有一团迷雾在眼前一样。

接下来我们就非常详细的来读一读这个框架的代码，我们的目标就是理解了它的思想之后，能够明白我们的请求是如何实现的，我们的代码哪里还需要进行改进，如果能够更进一步，我们能够总结出一套适合大部分应用的网络架构思想。

能够让一些人从中受益。

我们先来看看整个框架的文件系统，我们先不对每个文件的作用进行说明，在整个源码解读最后的一篇中我们会对整个框架进行总结。会有一张清晰的图表来说明这个问题。

![637318-20160718153255826-2095808018.png][]

我们在看一个框架的时候呢，可以这样先看，先看每个文件的头文件，也就是.h文件

![637318-20160718155323654-2115638629.png][]

可以看到，有的头文件是包含了别的头文件的，在不考虑系统的头文件的情况下，我们能够发现一些比较独立的类，从上图中，我们可以看出

比较独立的类有：

1.AFURLResponseSerialization.h

2.AFNetworkReachabilityManager.h

3.AFURLRequestSerialization.h

4.AFSecurityPolicy.h

本篇就介绍AFNetworkReachabilityManager.h的内容，这个是用来监控网络环境变化的类。

#import <SystemConfiguration/SystemConfiguration.h>

通过导入了这个头文件，我们得知：网络监控的实现是依赖SystemConfiguration这个api的。说明这个api能够提供这样的功能，至少让我们明白了我们平时都会导入它的一个用途。

![637318-20160719091917060-109035038.png][]

这是一个枚举封装，还是遵循一个使用枚举的原则，当满足一个有限的并具有统一主题的集合的时候，我们就考虑枚举。在这里作者是枚举了4种类型。这几种类型能够满足我们开发中大部分的功能，如果不满足，可以自行进行扩展。

NS_ASSUME_NONNULL_BEGIN
    NS_ASSUME_NONNULL_END

这个是为了swift的可选类型配添加的，在这两个终点的内容的参数默认都是nonnull的。

![637318-20160719092900216-154644523.png][]

这段文字是对这个类的说明。我们估且不去管它说了什么，在看看苹果官方的

![637318-20160719093216357-1662764032.png][]

\*\*\* 这样的内容会出现在一个属性或者方法的上方，目的是对其内容的解释。我看到这里就想到了我们平时的开发，我们能够把每段代码都当成是api的开发，也把注释写的详细一点。曾经看过两种不同的说辞，一种是说把代码注释尽量少些，要求代码简介可读性强。另一种是说注释要详细，着重考虑他人读代码的感受。个人感觉还是写详细一点比较好，因为可能过一段时间之后，自己再去看自己当时写的代码可能就不记得了。很有可能在写这些繁琐的注释的过程中，能够想到些什么，比如如何合并掉一些没必要的方法等等。

![637318-20160719094744701-929485174.png][]

本类提供了四个只读的属性来让我们获取我们需要的内容

1. 网络状态

2. 是否是可达的

3. 当前连接是否是WWAN

4. 当前连接是够是WiFi

四个属性均为只读属性，只给了用户访问权，注意BOOL属性一般是要写getter方法的。

![637318-20160719095058904-809807148.png][]

作者使用了这个来分隔同一类中不同功能模块。这个算是个人习惯问题吧。举个平时开发的例子，在.m文件中我个人使用\#pragma mark 分隔不同功能。

![637318-20160719101738341-768102019.png][]

提供了5中初始化方法，能够满足大部分的需求。

SCNetworkReachabilityRef 这个很重要，这个类的就是基于它开发的。

\+ (instancetype)managerForDomain:(NSString \*)domain; 监听制定domain的网络状态。

\+ (instancetype)managerForAddress:(constvoid \*)address; 监听某个socket地址的网络状态，socket通信请看这篇文章：[socket通信][socket]

![637318-20160719102724029-666959631.png][]

打开和关闭监听的方法。

![637318-20160719102808732-1711210583.png][]

返回一个网络状态的本地语言的字符串。往往我们可以根据这个字符串来告诉用户，当前网络发生了什么，当然，也可以根据状态自定义提示文字。

![637318-20160719102950029-1061905457.png][]

设置网络转态改变的回调，监听网络改变的回调有两种方式：

1.使用上边的这个方法。

2.监听AFNetworkingReachabilityDidChangeNotification通知。

![637318-20160719103243279-1856388794.png][]

这个是与网络状态变化相关的通知。接受的通知中会有一个userinfo 是一个NSDictionary 其中key就是

AFNetworkingReachabilityNotificationStatusItem

\*\*\* 这简单的两行代码能够告诉我们的是，我们平时的开发中 但凡设计到发通知的功能，我们应该把通知的字符串封装到一个专有的文件中，同时在文件内部按不同模块进行区分，当然必要的注释也很有必要。

ps： FOUNDATION\_EXPORT 和\#define 都能定义常量。FOUNDATION\_EXPORT 能够使用==进行判断，效率略高。而且能够隐藏定义细节(就是实现部分不在.中)

![637318-20160719104106997-954383058.png][]

对函数：根据状态获取字符串 声明。

好了，这个类的.h文件我们已经非常相信的进行解读了，我们并不是大概的说了下他提供的功能，而是通过读每行代码，我们能联想到什么，什么东西能帮助我们更好的编程。

我们接着看 AFNetworkReachabilityManager.m 的内容

![637318-20160719104414310-118130700.png][]

这几个头文件是系统库，是为了后边的 sockaddr\_in6 / sockaddr\_in 准备的，不熟悉的可以看这篇文章 [socket通信][socket]

![637318-20160719104626747-1741664735.png][]

这几个就没什么好说的了，我们接着看

![637318-20160719104727154-1411024288.png][]

这个方法是对.h 中最后一个方法的实现。指的我们注意的是NSLocalizedStringFromTable这个宏。为什么要注意它呢？

这就涉及到本地国际化的问题。所谓的国际化就是让你的app能够根据不同的语言显示相对应的语言。

\*\*\* 但这并不简单，没有经验的开发人员，一开始可能不会做这样的设置，如果日后需要国际话了，在做就很麻烦了。所以说在开中，但凡使用到字符串的地方都要考虑语言的不同。不同的语言下，一个意思的表达所使用的字符串长度是不一样的，这就影射出空间的宽度可能会不一样。

好了，国际化的内容就不说了，请自行搜索。

![复制代码][copycode.gif]

1 /**
     2  *  根据SCNetworkReachabilityFlags这个网络标记来转换成我们在开发中经常使用的网络状态
     3      1.不能连接网络
     4      2.蜂窝连接
     5      3.WiFi连接
     6      4.未知连接
     7  */
     8 static AFNetworkReachabilityStatus AFNetworkReachabilityStatusForFlags(SCNetworkReachabilityFlags flags) {
     9     
    10     // 是否能够到达
    11     BOOL isReachable = ((flags & kSCNetworkReachabilityFlagsReachable) != 0);
    12     
    13     // 在联网之前需要建立连接
    14     BOOL needsConnection = ((flags & kSCNetworkReachabilityFlagsConnectionRequired) != 0);
    15     
    16     // 是否可以自动连接
    17     BOOL canConnectionAutomatically = (((flags & kSCNetworkReachabilityFlagsConnectionOnDemand ) != 0) || ((flags & kSCNetworkReachabilityFlagsConnectionOnTraffic) != 0));
    18     
    19     // 是否可以连接，在不需要用户手动设置的前提下
    20     BOOL canConnectWithoutUserInteraction = (canConnectionAutomatically && (flags & kSCNetworkReachabilityFlagsInterventionRequired) == 0);
    21     
    22     // 是否可以联网的条件 1.能够到达 2.不需要建立连接或者不需要用户手动设置连接 就表示能够连接到网络
    23     BOOL isNetworkReachable = (isReachable && (!needsConnection || canConnectWithoutUserInteraction));
    24 
    25     AFNetworkReachabilityStatus status = AFNetworkReachabilityStatusUnknown;
    26     if (isNetworkReachable == NO) {
    27         status = AFNetworkReachabilityStatusNotReachable;
    28     }
    29 #if    TARGET_OS_IPHONE
    30     else if ((flags & kSCNetworkReachabilityFlagsIsWWAN) != 0) {
    31         status = AFNetworkReachabilityStatusReachableViaWWAN;
    32     }
    33 #endif
    34     else {
    35         status = AFNetworkReachabilityStatusReachableViaWiFi;
    36     }
    37 
    38     return status;
    39 }

![复制代码][copycode.gif]

这个方法根据SCNetworkReachabilityFlags这个标记转换成我们自定义的枚举类型。至于转换规则，上边的代码中注释部分写的很清楚。

\*\*\* 在这里不得不多说几句，很多框架中都会把一个类中的私有方法写成这样。为什么呢？ 我们在开发中经常会写成- (void)funcName; 这样的私有方法。

我个人的意见是一个类中的私有方法写成static void funcName() 这样的c函数比较好。

1. 在文件的最前方，比较容易查找

2. 可以适当的使用内联函数，提高效率。

![637318-20160719110007247-35793250.png][]

根据一个标识 来处理Block和通知。保证两者同一状态。

![637318-20160719110416747-1957157748.png][]

包含了 类中需要处理的属性。

![637318-20160719110528982-1062728004.png][]

来看这个最基本的初始化方法，初始化了自身的属性。

CFRetain()后要记得CFRelease().

![637318-20160719111111779-1876647765.png][]

通过一个socket地址来初始化。 首先新建 SCNetworkReachabilityRef 对象，然后调用initWithReachability: 方法。记得手动管理内存。

![637318-20160719111314341-590937185.png][]

这个方法基本同上。

综合上边两个方法，我们发现 SCNetworkReachabilityRef 有两个创建方法：

1. SCNetworkReachabilityCreateWithName

2. SCNetworkReachabilityCreateWithAddress

![637318-20160719111508419-715996672.png][]

由于IPv6 是ios9和os\_x 10.11后边推出的，所有要进行版本判断。这礼拜呢设计到的socket的知识，请看 [socket通信][socket]

通过这段代码我们能学到什么呢？

1，方法的创建也是有顺序的，可以使用函数访问函数的思想。

2. @if 这样的预编译指令能够替换掉代码中部分if else 。好处就是代码会不会被编译的区别。

![637318-20160719112318576-1809078029.png][]

单例的写法。

![637318-20160719112355622-647546733.png][]

对需要释放时，做一些处理。

![637318-20160719112533669-1049831324.png][]

这个是.h文件暴露出来的3个BOOL 属性的getter方法，注意，由于我们在@property中定义了getter方法，所以getter方法就要写成我们定义的那种。

从这3个方法中也能看出，函数嵌套的思想还是很重要，要想做到这一点，只能是多想才行。

![637318-20160719113051513-1494619373.png][]

这个算是这个类的核心方法，设置监听网咯监听。

我们先来了解下基础知识。

SCNetworkReachabilityContext

点进去，会发现这是一个结构体，一般c语言的结构体是对要保存的数据的一种描述

![637318-20160719113349919-151565801.png][]

1. 第一个参数接受一个signed long 的参数

2. 第二个参数接受一个void \* 类型的值，相当于oc的id类型，void \* 可以指向任何类型的参数

3. 第三个参数 是一个函数 目的是对info做retain操作，

4. 第四个参数是一个函数，目的是对info做release操作

5. 第五个参数是 一个函数，根据info获取Description字符串

在这里我们要携带的这个info就是下边的这个block

![复制代码][copycode.gif]

1 __weak __typeof(self)weakSelf = self;
     2     AFNetworkReachabilityStatusBlock callback = ^(AFNetworkReachabilityStatus status) {
     3         __strong __typeof(weakSelf)strongSelf = weakSelf;
     4 
     5         strongSelf.networkReachabilityStatus = status;
     6         if (strongSelf.networkReachabilityStatusBlock) {
     7             strongSelf.networkReachabilityStatusBlock(status);
     8         }
     9 
    10     };

![复制代码][copycode.gif]

retain和release 函数是下边的这两个函数

![复制代码][copycode.gif]

1 static const void * AFNetworkReachabilityRetainCallback(const void *info) {
    2     return Block_copy(info);
    3 }
    4 
    5 static void AFNetworkReachabilityReleaseCallback(const void *info) {
    6     if (info) {
    7         Block_release(info);
    8     }
    9 }

![复制代码][copycode.gif]

设置网络监控分为下边几个步骤：

1.我们先新建上下文

1 SCNetworkReachabilityContext context = {
       0, (__bridge void *)callback, AFNetworkReachabilityRetainCallback, AFNetworkReachabilityReleaseCallback, NULL};

2.设置回调

1 SCNetworkReachabilitySetCallback(self.networkReachability, AFNetworkReachabilityCallback, &context);

其中这个AFNetworkReachabilityCallback 是这样被定义的一个函数

typedef void (*SCNetworkReachabilityCallBack)    (
                            SCNetworkReachabilityRef            target,
                            SCNetworkReachabilityFlags            flags,
                            void                 *    __nullable    info
                            );

在本类中

1 static void AFNetworkReachabilityCallback(SCNetworkReachabilityRef __unused target, SCNetworkReachabilityFlags flags, void *info) {
    2     AFPostReachabilityStatusChange(flags, (__bridge AFNetworkReachabilityStatusBlock)info);
    3 }

3.加入RunLoop池

1 SCNetworkReachabilityScheduleWithRunLoop(self.networkReachability, CFRunLoopGetMain(), kCFRunLoopCommonModes);

其中CFRunLoopGetMain()代表主RunLoop

ok，差不多已经完成

![637318-20160719115454466-1321679246.png][]

在异步线程 发送一次当前的网络状态。

![637318-20160719152713435-1731887766.png][]

停止网络监控

![637318-20160719152807310-1000112926.png][]

这两个方法没什么好说的了，一个是getter 一个是setter

![637318-20160719154331388-959111188.png][]

注册键值依赖，这个可能大家平时用的比较少。可以了解一下

比如说一个类User中有两个属性

![637318-20160719154603794-898499404.png][]

还有一个卡片的类card

![637318-20160719154856404-155385259.png][]

我们写一个info的setter 和 getter 方法，

![637318-20160719155438951-1699611420.png][]

![复制代码][copycode.gif]

1 @interface User :NSObject
     2 @property (nonatomic,copy)NSString *name;
     3 @property (nonatomic,assign)NSUInteger age;
     4 @end
     5 
     6 
     7 
     8 @interface card :NSObject
     9 @property (nonatomic,copy)NSString *info;
    10 @property (nonatomic,strong)User *user;
    11 @end
    12 @implementation card
    13 
    14 - (NSString *)info {
    15     return [NSString stringWithFormat:@"%@/%lu",_user.name,(unsigned long)_user.age];
    16 }
    17 - (void)setInfo:(NSString *)info {
    18     
    19     NSArray *array = [info componentsSeparatedByString:@"/"];
    20     _user.name = array[0];
    21     _user.age = [array[1] integerValue];
    22     
    23 }
    24 
    25 + (NSSet<NSString *> *)keyPathsForValuesAffectingValueForKey:(NSString *)key {
    26     NSSet * keyPaths = [super keyPathsForValuesAffectingValueForKey:key];
    27     NSArray * moreKeyPaths = nil;
    28 
    29     if ([key isEqualToString:@"info"])
    30     {
    31         moreKeyPaths = [NSArray arrayWithObjects:@"user.name", @"user.age", nil];
    32     }
    33 
    34     if (moreKeyPaths)
    35     {
    36         keyPaths = [keyPaths setByAddingObjectsFromArray:moreKeyPaths];
    37     }
    38     
    39     return keyPaths;
    40 }
    41 
    42 @end

![复制代码][copycode.gif]

代码差不多就是上边的。我们可以监听card的info属性，当user中的name或者age的值发生改变的时候，就会触发info的键值监听方法。这就是键值依赖的作用。

好了 本篇文章就到此为止了。下一篇会是AFSecurityPolicy

[Link 1]: http://www.cnblogs.com/machao/
[AFNetworking 3.0 _ AFSecurityPolicy]: http://www.cnblogs.com/machao/p/5704201.html
[AFNetworking 3.0 _ AFURLRequestSerialization]: http://www.cnblogs.com/machao/p/5725874.html
[AFNetworking 3.0 _ AFURLResponseSerialization]: http://www.cnblogs.com/machao/p/5755947.html
[AFNetworking 3.0 _ AFURLSessionManager]: http://www.cnblogs.com/machao/p/5768253.html
[AFNetworking 3.0 _ AFHTTPSessionManager]: http://www.cnblogs.com/machao/p/5790708.html
[AFNetworking 3.0 _ AFAutoPurgingImageCache]: http://www.cnblogs.com/machao/p/5796234.html
[AFNetworking 3.0 _ AFImageDownloader]: http://www.cnblogs.com/machao/p/5803850.html
[AFNetworking 3.0 _ AFNetworkActivityIndicatorManager]: http://www.cnblogs.com/machao/p/5813054.html
[AFNetworking 3.0 _ UIActivityIndicatorView_UIRefreshControl_UIImageView _ AFNetworking]: http://www.cnblogs.com/machao/p/5817701.html
[AFNetworking 3.0 _ UIButton_UIProgressView_UIWebView _ AFNetworking]: http://www.cnblogs.com/machao/p/5821462.html
[AFNetworking 3.0 _]: http://www.cnblogs.com/machao/p/5830337.html
[AFNetworking 3.0 _ 1]: http://www.cnblogs.com/machao/p/5833794.html
[637318-20160718153255826-2095808018.png]: http://images2015.cnblogs.com/blog/637318/201607/637318-20160718153255826-2095808018.png
[637318-20160718155323654-2115638629.png]: http://images2015.cnblogs.com/blog/637318/201607/637318-20160718155323654-2115638629.png
[637318-20160719091917060-109035038.png]: http://images2015.cnblogs.com/blog/637318/201607/637318-20160719091917060-109035038.png
[637318-20160719092900216-154644523.png]: http://images2015.cnblogs.com/blog/637318/201607/637318-20160719092900216-154644523.png
[637318-20160719093216357-1662764032.png]: http://images2015.cnblogs.com/blog/637318/201607/637318-20160719093216357-1662764032.png
[637318-20160719094744701-929485174.png]: http://images2015.cnblogs.com/blog/637318/201607/637318-20160719094744701-929485174.png
[637318-20160719095058904-809807148.png]: http://images2015.cnblogs.com/blog/637318/201607/637318-20160719095058904-809807148.png
[637318-20160719101738341-768102019.png]: http://images2015.cnblogs.com/blog/637318/201607/637318-20160719101738341-768102019.png
[socket]: http://www.cnblogs.com/machao/p/5654661.html
[637318-20160719102724029-666959631.png]: http://images2015.cnblogs.com/blog/637318/201607/637318-20160719102724029-666959631.png
[637318-20160719102808732-1711210583.png]: http://images2015.cnblogs.com/blog/637318/201607/637318-20160719102808732-1711210583.png
[637318-20160719102950029-1061905457.png]: http://images2015.cnblogs.com/blog/637318/201607/637318-20160719102950029-1061905457.png
[637318-20160719103243279-1856388794.png]: http://images2015.cnblogs.com/blog/637318/201607/637318-20160719103243279-1856388794.png
[637318-20160719104106997-954383058.png]: http://images2015.cnblogs.com/blog/637318/201607/637318-20160719104106997-954383058.png
[637318-20160719104414310-118130700.png]: http://images2015.cnblogs.com/blog/637318/201607/637318-20160719104414310-118130700.png
[637318-20160719104626747-1741664735.png]: http://images2015.cnblogs.com/blog/637318/201607/637318-20160719104626747-1741664735.png
[637318-20160719104727154-1411024288.png]: http://images2015.cnblogs.com/blog/637318/201607/637318-20160719104727154-1411024288.png
[copycode.gif]: http://common.cnblogs.com/images/copycode.gif
[637318-20160719110007247-35793250.png]: http://images2015.cnblogs.com/blog/637318/201607/637318-20160719110007247-35793250.png
[637318-20160719110416747-1957157748.png]: http://images2015.cnblogs.com/blog/637318/201607/637318-20160719110416747-1957157748.png
[637318-20160719110528982-1062728004.png]: http://images2015.cnblogs.com/blog/637318/201607/637318-20160719110528982-1062728004.png
[637318-20160719111111779-1876647765.png]: http://images2015.cnblogs.com/blog/637318/201607/637318-20160719111111779-1876647765.png
[637318-20160719111314341-590937185.png]: http://images2015.cnblogs.com/blog/637318/201607/637318-20160719111314341-590937185.png
[637318-20160719111508419-715996672.png]: http://images2015.cnblogs.com/blog/637318/201607/637318-20160719111508419-715996672.png
[637318-20160719112318576-1809078029.png]: http://images2015.cnblogs.com/blog/637318/201607/637318-20160719112318576-1809078029.png
[637318-20160719112355622-647546733.png]: http://images2015.cnblogs.com/blog/637318/201607/637318-20160719112355622-647546733.png
[637318-20160719112533669-1049831324.png]: http://images2015.cnblogs.com/blog/637318/201607/637318-20160719112533669-1049831324.png
[637318-20160719113051513-1494619373.png]: http://images2015.cnblogs.com/blog/637318/201607/637318-20160719113051513-1494619373.png
[637318-20160719113349919-151565801.png]: http://images2015.cnblogs.com/blog/637318/201607/637318-20160719113349919-151565801.png
[637318-20160719115454466-1321679246.png]: http://images2015.cnblogs.com/blog/637318/201607/637318-20160719115454466-1321679246.png
[637318-20160719152713435-1731887766.png]: http://images2015.cnblogs.com/blog/637318/201607/637318-20160719152713435-1731887766.png
[637318-20160719152807310-1000112926.png]: http://images2015.cnblogs.com/blog/637318/201607/637318-20160719152807310-1000112926.png
[637318-20160719154331388-959111188.png]: http://images2015.cnblogs.com/blog/637318/201607/637318-20160719154331388-959111188.png
[637318-20160719154603794-898499404.png]: http://images2015.cnblogs.com/blog/637318/201607/637318-20160719154603794-898499404.png
[637318-20160719154856404-155385259.png]: http://images2015.cnblogs.com/blog/637318/201607/637318-20160719154856404-155385259.png
[637318-20160719155438951-1699611420.png]: http://images2015.cnblogs.com/blog/637318/201607/637318-20160719155438951-1699611420.png