写点什么

AFNetworkReachabilityManager 监控网络状态(四)

  • 2019-12-10
  • 本文字数:5547 字

    阅读完需:约 18 分钟

AFNetworkReachabilityManager 监控网络状态(四)

AFNetworkReachabilityManager 是对 SystemConfiguration 模块的封装,苹果的文档中也有一个类似的项目 Reachability 这里对网络状态的监控跟苹果官方的实现几乎是完全相同的。


同样在 github 上有一个类似的项目叫做 Reachability 不过这个项目由于命名的原因可能会在审核时被拒绝


无论是 AFNetworkReachabilityManager,苹果官方的项目或者说 github 上的 Reachability,它们的实现都是类似的,而在这里我们会以 AFNetworking 中的 AFNetworkReachabilityManager 为例来说明在 iOS 开发中,我们是怎样监控网络状态的。

AFNetworkReachabilityManager 的使用和实现

AFNetworkReachabilityManager 的使用还是非常简单的,只需要三个步骤,就基本可以完成对网络状态的监控。


  1. 初始化 AFNetworkReachabilityManager

  2. 调用 startMonitoring 方法开始对网络状态进行监控

  3. 设置 networkReachabilityStatusBlock 在每次网络状态改变时, 调用这个 block

初始化 AFNetworkReachabilityManager

在初始化方法中,使用 SCNetworkReachabilityCreateWithAddress 或者 SCNetworkReachabilityCreateWithName 生成一个 SCNetworkReachabilityRef 的引用。


Objective-C


+ (instancetype)managerForDomain:(NSString *)domain {    SCNetworkReachabilityRef reachability = SCNetworkReachabilityCreateWithName(kCFAllocatorDefault, [domain UTF8String]);
AFNetworkReachabilityManager *manager = [[self alloc] initWithReachability:reachability];
return manager;}
+ (instancetype)managerForAddress:(const void *)address { SCNetworkReachabilityRef reachability = SCNetworkReachabilityCreateWithAddress(kCFAllocatorDefault, (const struct sockaddr *)address); AFNetworkReachabilityManager *manager = [[self alloc] initWithReachability:reachability];
return manager;}
复制代码


  1. 这两个方法会通过一个域名或者一个 sockaddr_in 的指针生成一个 SCNetworkReachabilityRef

  2. 调用 - [AFNetworkReachabilityManager initWithReachability:] 将生成的 SCNetworkReachabilityRef 引用传给 networkReachability

  3. 设置一个默认的 networkReachabilityStatus


Objective-C


- (instancetype)initWithReachability:(SCNetworkReachabilityRef)reachability {    self = [super init];    if (!self) {        return nil;    }
self.networkReachability = CFBridgingRelease(reachability); self.networkReachabilityStatus = AFNetworkReachabilityStatusUnknown;
return self;}
复制代码


当调用 CFBridgingRelease(reachability) 后,会把 reachability 桥接成一个 NSObject 对象赋值给 self.networkReachability,然后释放原来的 CoreFoundation 对象。

监控网络状态

在初始化 AFNetworkReachabilityManager 后,会调用 startMonitoring 方法开始监控网络状态。


Objective-C


- (void)startMonitoring {    [self stopMonitoring];
if (!self.networkReachability) { return; }
__weak __typeof(self)weakSelf = self; AFNetworkReachabilityStatusBlock callback = ^(AFNetworkReachabilityStatus status) { __strong __typeof(weakSelf)strongSelf = weakSelf;
strongSelf.networkReachabilityStatus = status; if (strongSelf.networkReachabilityStatusBlock) { strongSelf.networkReachabilityStatusBlock(status); }
};
id networkReachability = self.networkReachability; SCNetworkReachabilityContext context = {0, (__bridge void *)callback, AFNetworkReachabilityRetainCallback, AFNetworkReachabilityReleaseCallback, NULL}; SCNetworkReachabilitySetCallback((__bridge SCNetworkReachabilityRef)networkReachability, AFNetworkReachabilityCallback, &context); SCNetworkReachabilityScheduleWithRunLoop((__bridge SCNetworkReachabilityRef)networkReachability, CFRunLoopGetMain(), kCFRunLoopCommonModes);
dispatch_async(dispatch_get_global_queue(DISPATCH_QUEUE_PRIORITY_BACKGROUND, 0),^{ SCNetworkReachabilityFlags flags; if (SCNetworkReachabilityGetFlags((__bridge SCNetworkReachabilityRef)networkReachability, &flags)) { AFPostReachabilityStatusChange(flags, callback); } });}
复制代码


  1. 先调用 - stopMonitoring 方法,如果之前设置过对网络状态的监听,使用 SCNetworkReachabilityUnscheduleFromRunLoop 方法取消之前在 Main Runloop 中的监听


   - (void)stopMonitoring {        if (!self.networkReachability) {            return;        }
SCNetworkReachabilityUnscheduleFromRunLoop((__bridge SCNetworkReachabilityRef)self.networkReachability, CFRunLoopGetMain(), kCFRunLoopCommonModes); }
复制代码


  1. 创建一个在每次网络状态改变时的回调


   __weak __typeof(self)weakSelf = self;    AFNetworkReachabilityStatusBlock callback = ^(AFNetworkReachabilityStatus status) {        __strong __typeof(weakSelf)strongSelf = weakSelf;
strongSelf.networkReachabilityStatus = status; if (strongSelf.networkReachabilityStatusBlock) { strongSelf.networkReachabilityStatusBlock(status); }
};
复制代码


* 每次回调被调用时
* 重新设置 `networkReachabilityStatus` 属性 * 调用 `networkReachabilityStatusBlock`
复制代码


  1. 创建一个 SCNetworkReachabilityContext


   typedef struct {        CFIndex    version;        void *    __nullable info;        const void  * __nonnull (* __nullable retain)(const void *info);        void    (* __nullable release)(const void *info);        CFStringRef  __nonnull (* __nullable copyDescription)(const void *info);    } SCNetworkReachabilityContext;
SCNetworkReachabilityContext context = { 0, (__bridge void *)callback, AFNetworkReachabilityRetainCallback, AFNetworkReachabilityReleaseCallback, NULL };
复制代码


* 其中的 `callback` 就是上一步中的创建的 block 对象* 这里的 `AFNetworkReachabilityRetainCallback` 和 `AFNetworkReachabilityReleaseCallback` 都是非常简单的 block,在回调被调用时,只是使用 `Block_copy` 和 `Block_release` 这样的宏* 传入的 `info` 会以参数的形式在 `AFNetworkReachabilityCallback` 执行时传入
static const void * AFNetworkReachabilityRetainCallback(const void *info) { return Block_copy(info); }
static void AFNetworkReachabilityReleaseCallback(const void *info) { if (info) { Block_release(info); } }
复制代码


  1. 当目标的网络状态改变时,会调用传入的回调


   SCNetworkReachabilitySetCallback(        (__bridge SCNetworkReachabilityRef)networkReachability,        AFNetworkReachabilityCallback,        &context    );
复制代码


  1. 在 Main Runloop 中对应的模式开始监控网络状态


   SCNetworkReachabilityScheduleWithRunLoop(        (__bridge SCNetworkReachabilityRef)networkReachability,        CFRunLoopGetMain(),        kCFRunLoopCommonModes    );
复制代码


  1. 获取当前的网络状态,调用 callback


   dispatch_async(dispatch_get_global_queue(DISPATCH_QUEUE_PRIORITY_BACKGROUND, 0),^{        SCNetworkReachabilityFlags flags;        if (SCNetworkReachabilityGetFlags((__bridge SCNetworkReachabilityRef)networkReachability, &flags)) {            AFPostReachabilityStatusChange(flags, callback);        }    });
复制代码


在下一节中会介绍上面所提到的一些 C 函数以及各种回调。

设置 networkReachabilityStatusBlock 以及回调

在 Main Runloop 中对网络状态进行监控之后,在每次网络状态改变,就会调用 AFNetworkReachabilityCallback 函数:


Objective-C


static void AFNetworkReachabilityCallback(SCNetworkReachabilityRef __unused target, SCNetworkReachabilityFlags flags, void *info) {    AFPostReachabilityStatusChange(flags, (__bridge AFNetworkReachabilityStatusBlock)info);}
复制代码


这里会从 info 中取出之前存在 context 中的 AFNetworkReachabilityStatusBlock


Objective-C


__weak __typeof(self)weakSelf = self;AFNetworkReachabilityStatusBlock callback = ^(AFNetworkReachabilityStatus status) {    __strong __typeof(weakSelf)strongSelf = weakSelf;
strongSelf.networkReachabilityStatus = status; if (strongSelf.networkReachabilityStatusBlock) { strongSelf.networkReachabilityStatusBlock(status); }
};
复制代码


取出这个 block 之后,传入 AFPostReachabilityStatusChange 函数:


Objective-C


static void AFPostReachabilityStatusChange(SCNetworkReachabilityFlags flags, AFNetworkReachabilityStatusBlock block) {    AFNetworkReachabilityStatus status = AFNetworkReachabilityStatusForFlags(flags);    dispatch_async(dispatch_get_main_queue(), ^{        if (block) {            block(status);        }        NSNotificationCenter *notificationCenter = [NSNotificationCenter defaultCenter];        NSDictionary *userInfo = @{ AFNetworkingReachabilityNotificationStatusItem: @(status) };        [notificationCenter postNotificationName:AFNetworkingReachabilityDidChangeNotification object:nil userInfo:userInfo];    });}
复制代码


  1. 调用 AFNetworkReachabilityStatusForFlags 获取当前的网络可达性状态

  2. 在主线程中异步执行上面传入的 callback block(设置 self 的网络状态,调用 networkReachabilityStatusBlock

  3. 发送 AFNetworkingReachabilityDidChangeNotification 通知.


Objective-C


static AFNetworkReachabilityStatus AFNetworkReachabilityStatusForFlags(SCNetworkReachabilityFlags flags) {    BOOL isReachable = ((flags & kSCNetworkReachabilityFlagsReachable) != 0);    BOOL needsConnection = ((flags & kSCNetworkReachabilityFlagsConnectionRequired) != 0);    BOOL canConnectionAutomatically = (((flags & kSCNetworkReachabilityFlagsConnectionOnDemand ) != 0) || ((flags & kSCNetworkReachabilityFlagsConnectionOnTraffic) != 0));    BOOL canConnectWithoutUserInteraction = (canConnectionAutomatically && (flags & kSCNetworkReachabilityFlagsInterventionRequired) == 0);    BOOL isNetworkReachable = (isReachable && (!needsConnection || canConnectWithoutUserInteraction));
AFNetworkReachabilityStatus status = AFNetworkReachabilityStatusUnknown; if (isNetworkReachable == NO) { status = AFNetworkReachabilityStatusNotReachable; }#if TARGET_OS_IPHONE else if ((flags & kSCNetworkReachabilityFlagsIsWWAN) != 0) { status = AFNetworkReachabilityStatusReachableViaWWAN; }#endif else { status = AFNetworkReachabilityStatusReachableViaWiFi; }
return status;}
复制代码


因为 flags 是一个 SCNetworkReachabilityFlags,它的不同位代表了不同的网络可达性状态,通过 flags 的位操作,获取当前的状态信息 AFNetworkReachabilityStatus


Objective-C


typedef CF_OPTIONS(uint32_t, SCNetworkReachabilityFlags) {  kSCNetworkReachabilityFlagsTransientConnection  = 1<<0,  kSCNetworkReachabilityFlagsReachable    = 1<<1,  kSCNetworkReachabilityFlagsConnectionRequired  = 1<<2,  kSCNetworkReachabilityFlagsConnectionOnTraffic  = 1<<3,  kSCNetworkReachabilityFlagsInterventionRequired  = 1<<4,  kSCNetworkReachabilityFlagsConnectionOnDemand  = 1<<5,  // __OSX_AVAILABLE_STARTING(__MAC_10_6,__IPHONE_3_0)  kSCNetworkReachabilityFlagsIsLocalAddress  = 1<<16,  kSCNetworkReachabilityFlagsIsDirect    = 1<<17,#if  TARGET_OS_IPHONE  kSCNetworkReachabilityFlagsIsWWAN    = 1<<18,#endif  // TARGET_OS_IPHONE
kSCNetworkReachabilityFlagsConnectionAutomatic = kSCNetworkReachabilityFlagsConnectionOnTraffic};
复制代码


这里就是在 SystemConfiguration 中定义的全部的网络状态的标志位。

与 AFNetworking 协作

其实这个类与 AFNetworking 整个框架并没有太多的耦合。正相反,它在整个框架中作为一个即插即用的类使用,每一个 AFURLSessionManager 都会持有一个 AFNetworkReachabilityManager 的实例。


Objective-C


self.reachabilityManager = [AFNetworkReachabilityManager sharedManager];
复制代码


这是整个框架中除了 AFNetworkReachabilityManager.h/m 文件,唯一一个引用到这个类的地方。


在实际的使用中,我们也可以直接操作 AFURLSessionManagerreachabilityManager 来获取当前的网络可达性状态,而不是自己手动初始化一个实例,当然这么做也是没有任何问题的。

总结

  1. AFNetworkReachabilityManager 实际上只是一个对底层 SystemConfiguration 库中的 C 函数封装的类,它为我们隐藏了 C 语言的实现,提供了统一的 Objective-C 语言接口

  2. 它是 AFNetworking 中一个即插即用的模块


本文转载自 Draveness 技术博客。


原文链接:https://draveness.me/afnetworking4


2019-12-10 17:471581

评论

发布
暂无评论
发现更多内容

【设计模式】桥接模式

Andy阿辉

编程 后端 设计模式 8月日更

Druid 加载 Kafka 数据时通过控制台来提交一个 supervisor

HoneyMoose

Druid 加载 Kafka 数据时直接提交一个 supervisor

HoneyMoose

spring的循环依赖

卢卡多多

spring aop 8月日更

在线邮箱地址提取工具

入门小站

工具

JavaScript代码片段学设计模式

devpoint

设计模式 工厂模式 8月日更

Druid 加载 Kafka 数据后查询和清理数据

HoneyMoose

有状态流处理简介(一)

Databri_AI

flink 批处理 状态

Druid 使用 Kafka 数据加载教程——下载和启动 Kafka

HoneyMoose

oeasy教您玩转vim - 9 - # 换行插入

o

netty系列之:Event、Handler和Pipeline

程序那些事

Java Netty nio 程序那些事

oeasy教您玩转vim - 8 - # 追加文本

o

Go并发之CSP并发模型、协程并发

Regan Yue

协程 CSP Go 语言 8月日更

linux中常见工具安装问题集锦

liuzhen007

8月日更

前端之数据结构(三)集合和字典

Augus

数据结构 8月日更

超全激活函数学习总结!!!

Shirakawa

神经网络 机器学习 算法 激活函数

架构训练营 模块4作业

sophiahuxh

元数据管理服务分析报告

漫长的白日梦

数据湖 AWS 元数据

Druid 使用 Kafka 将数据载入到 Kafka

HoneyMoose

【Flutter 专题】75 图解基本 TabBar 标签导航栏 (一)

阿策小和尚

Flutter 小菜 0 基础学习 Flutter Android 小菜鸟 8月日更

数据探索

南湖职业技术学院机械狗

☕【Java技术指南】教你如何使用【精巧好用】的DelayQueue(延时队列)

码界西柚

Java 延迟队列 8月日更 DelayedQueue

深入了解NIO底层原理

陈皮的JavaLib

Java 面试 nio 8月日更

docker编排参数详解(docker-compose.yml配置文件编写)

xcbeyond

Docker 容器 8月日更

Linux中buff-cache占用过高解决方案

入门小站

Linux

🏆【Java技术之旅】「编译器专题」重塑认识Java编译器的执行过程(消除数组边界检查+公共子表达式)!

码界西柚

Java 编译器 8月日更 JIT编译器

kubernetes入门:harbor个人私有仓库傻瓜式搭建

小鲍侃java

8月日更

两个小女孩

箭上有毒

8月日更

oeasy教您玩转vim - 7 - # 从头插入

o

如何从 0 到 1 设计 B 端产品?

蒋川

后台开发 产品开发 后台 后台管理系统 tob产品

番外2. OpenCV 中摄像头捕获与视频处理与常见问题解决方案

梦想橡皮擦

8月日更

AFNetworkReachabilityManager 监控网络状态(四)_语言 & 开发_Draveness_InfoQ精选文章