写点什么

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:471585

评论

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

如何应对YashanDB数据库中的数据一致性挑战

数据库砖家

如何在YashanDB中管理用户权限与角色

数据库砖家

使用YashanDB进行实时数据分析的完整流程

数据库砖家

怎样做用YashanDB构建企业统一数据管理平台?

数据库砖家

Hype 4 Pro 4.1.19 - 创建动画和交互式的Web内容

Rose

2025 年 MQTT 技术趋势:驱动 AI 与物联网未来发展的关键动力

EMQ映云科技

mqtt emqx MCP

优化YashanDB查询逻辑提高响应速度

数据库砖家

三大 Mac 软件下载站,总有一款适合你!

晨光熹微

深入了解YashanDB数据库的功能与模块

数据库砖家

怎样做轻松迁移至YashanDB数据库避免数据丢失

数据库砖家

Ae/Pr/视觉特效和转场BCC插件 Boris FX Continuum 2023亮点功能

Rose

如何实现YashanDB数据库的负载均衡

数据库砖家

如何通过YashanDB实施弹性计算环境的数据管理

数据库砖家

使用YashanDB时如何进行有效的查询优化

数据库砖家

构建基于YashanDB数据库的分布式事务管理系统技术分析

数据库砖家

Ableton Live 12 Suite v12.2中文版注册机+许可证

Rose

如何优化YashanDB数据库以提升数据处理速度?

数据库砖家

怎样做数据库负载高峰应对?YashanDB动态调节机制

数据库砖家

整合YashanDB数据库与人工智能技术的优势

数据库砖家

苹果macOS 26兼容设备 macos 26完整pkg安装程序

Rose

3D数字绘画和雕刻 Mudbox 2025新功能

Rose

Ableton Live 12 Suite for mac v12.2中文:音乐制作软件

晨光熹微

使用YashanDB数据库进行日志数据管理

数据库砖家

云原生数据库架构设计指南——基于YashanDB的方案解析

数据库砖家

微信小程序上线后的运维

北京木奇移动技术有限公司

微信小游戏 软件外包公司 游戏外包公司

2025Java面试八股①(含121道面试题和答案)

王中阳Go

Java 面试

YashanDB数据库安装与配置的详细步骤

数据库砖家

怎样做YashanDB数据一致性校验,确保业务准确?

数据库砖家

怎样做YashanDB支持高性能事务处理

数据库砖家

如何通过YashanDB丰富企业的客户数据

数据库砖家

YashanDB数据库自动化测试方案

数据库砖家

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