以下内容仅为做笔记之用。
最近在看ReactNative源码,发现逐字细节看,总是不久后就遗忘掉,就准备用简书的笔记功能,做下笔记,以备不时翻看。
刚好看到ReactNative的网络模块,就从这里开始好了。
在JS中看到NetInfo
模块可以监听网络状态,因此就到对应的RCTNetInfo
OC模块看看内部实现。
RCTNetInfo.h
#import <SystemConfiguration/SystemConfiguration.h>
#import <React/RCTEventEmitter.h>
@interface RCTNetInfo : RCTEventEmitter
- (instancetype)initWithHost:(NSString *)host;
@end
发现引入了两个库, 一个是系统
SystemConfiguration
库,System Configuration框架可用于确定设备的网络配置。你可以使用该框架判断Wifi或者蜂窝连接是否正在使用中,也可以判断某个主机服务是否可以使用。具体细节可以在这里查看。另一个是Facebook官方实现的<React/RCTEventEmitter.h>,
RCTEventEmitter
是一个基础类,用于向JS传递被监测的事件。我们主要关心RCTEventEmitter
3个方法:
- (NSArray<NSString *> *)supportedEvents;
- (void)startObserving;
- (void)stopObserving;
在官方注释中,这三个方法都要被子类重写,而RCTNetInfo
继承自RCTEventEmitter
.
supportedEvent
被用来返回支持事件名称。
startObserving
在获取到第一个监听者将被调用。
stopObserving
在最后一个监听者被移除的时候被调用。
startObserving
和stopObserving
在RCTEventEmitter
的子类开始/结束发送事件的时候需要被重写。
RCTNetInfo.m
在看具体代码之前,我们先了解几个概念。
SCNetworkReachablility
是SystemConfiguration
下的一个网络服务。SCNetworkReachability
编程接口允许应用来确定当前系统的网络状况和目标主机是否可连接。具体文档可以看这里。
SCNetworkReachabilityCreateWithName(CFAllocator?, UnsafePointer<Int8>)
可以创建一个网络连接测试,返回该连接测试的引用。它有两个参数:
第一个是内存分配器,是一个CFAllocator对象,默认为kCFAllocatorDefault。
第二个是测试的主机域名。
测试网络连接,需要在网络变化时,接受相关信息,下面是SCNetworkReachability
上下文对象:
SCNetworkReachabilityContext
指向一个结构体类型。
- version: 第一个参数是要一个向SCDynamicStore
create
功能传递的版本号, SCDynamicStorecreate
提供一个存储配置信息和当前网络信息的键值对,不同的结构体使用不同的版本号,该结构体使用版本号0。 - info: 第二个参数是一个C指针,指向特定的数据块
- retain 第三个参数: 是一个对info字段进行retain操作的callback。
- release 第四个参数: 是一个对info字段进行release操作的callback。
- copyDescription 第五个参数通常是一个对info字段进行描述的callback。
后3个参数可以为空。
为网络连接变化提供回调
SCNetworkReachabilitySetCallback
该函数用于监听网络状态变化
target 第一个参数是一个SCNetworkReachabilityRef类型的结构体。即为刚才创建的测试连接。
callout 当网络状况变化时进行的回调。
context 跟回调相关的连接上下文。
Return Value true: 通知服务被正确设置, 否则,返回false。
将网络连接测试放入runLoop
中
Boolean SCNetworkReachabilityScheduleWithRunLoop(SCNetworkReachabilityRef target, CFRunLoopRef runLoop, CFStringRef runLoopMode);
- target 网络测试连接
- runLoop 测试连接所在的runLoop
- runLoopMode 测试连接所在的runLoop Mode
- Return Value true: 测试连接被成功分配到runLoop中,否则,返回false。
下面这段代码就是网络监测的主要流程:
- (void)startObserving
{
_status = RCTReachabilityStateUnknown;
_reachability = SCNetworkReachabilityCreateWithName(kCFAllocatorDefault, _host.UTF8String ?: "apple.com");
SCNetworkReachabilityContext context = { 0, ( __bridge void *)self, NULL, NULL, NULL };
SCNetworkReachabilitySetCallback(_reachability, RCTReachabilityCallback, &context);
SCNetworkReachabilityScheduleWithRunLoop(_reachability, CFRunLoopGetMain(), kCFRunLoopCommonModes);
}
上面这段代码在网络变化时,总是回调用RCTReachabilityCallback
static void RCTReachabilityCallback(__unused SCNetworkReachabilityRef target, SCNetworkReachabilityFlags flags, void *info)
的实现中有这么一段代码:
if (![status isEqualToString:self->_status]) {
self->_status = status;
[self sendEventWithName:@"networkStatusDidChange" body:@{@"network_info": status}];
}
sendEventWithName
是ReactNative
中OC端主动向JS端
发送事件的一个方法。其中的EventName
networkStatusDidChange
可以在supportedEvents
中找到:
- (NSArray<NSString *> *)supportedEvents
{
return @[@"networkStatusDidChange"];
}
stopObserving
至于去除监听如下:
- (void)stopObserving
{
if (_reachability) {
SCNetworkReachabilityUnscheduleFromRunLoop(_reachability, CFRunLoopGetMain(), kCFRunLoopCommonModes);
CFRelease(_reachability);
}
}
上面这段代码就是判断是否有网络测试连接,有则从RunLoop
中取消。因为SCNetworkReachability
的功能遵循Core Foundation naming conventions
. 一个函数名称中包含有 "Create" or "Copy",其返回的引用必须用CFRelease
释放。