SCNetworkReachabilityRef监测网络状态

SCNetworkReachabilityRef接口可以确定当前主机的网络状态以及目标主机的可达性, 可达性是指data packet(数据包)可以从当前主机发送出去, 而不是目标主机可以接收到data packet(数据包).

SCNetworkReachabilityRef接口有同步和异步两种模式. 在同步模式下, 可以通过SCNetworkReachabilityGetFlags方法获取网络状态; 在异步模式下, 可以调度一个SCNetworkReachability对象到客户端的运行循环上, 客户端实现一个回调函数接收网络状态变化的通知, 这个回调函数遵循Core Foundation命名规范, 只要函数名中包含 "Create" 或 "Copy"的函数返回的引用，都必须调用CFRelease来释放。

SCNetworkReachabilityRef中几个主要的方法和属性:

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;
复制代码

结构体中包含用户指定的数据信息和用于SCNetworkReachabilitySetCallback方法的回调info. version为版本号, 作为参数传递给SCDynamicStore创建结构体类型的版本号. 这个结构体的版本号为0. info是一个C语言的指针对象, 这里一般传入当网络状态发生改变时执行的block回调, 个人理解为C语言的指针不在ARC的管理范围内, 需要手动管理内存, 所以这里传入release info和retain info用于管理内存. 这个结构体需要在SCNetworkReachabilitySetCallback设置才能起作用.

创建网络连接引用

SCNetworkReachabilityRef SCNetworkReachabilityCreateWithAddress(CFAllocatorRef allocator, const struct sockaddr *address);
复制代码

通过传入需要测试的IP地址创建网络连接引用, allocator可以设置为NULL或者kCFAllocatorDefault.

SCNetworkReachabilityRef SCNetworkReachabilityCreateWithName(CFAllocatorRef allocator, const char *nodename);
复制代码

通过传入需要测试的网址创建网络连接引用, 同上个方法.

获取网络连接状态

Boolean SCNetworkReachabilityGetFlags(SCNetworkReachabilityRef target, SCNetworkReachabilityFlags *flags);
复制代码

用于获取网络连接的状态, 传入的第一个参数是SCNetworkReachabilityRef网络连接引用, 第二个参数用来保存获取的网络连接状态, 如果能获取到连接就返回true否则返回false.

网络状态改变时的通知

Boolean SCNetworkReachabilitySetCallback(SCNetworkReachabilityRef target, SCNetworkReachabilityCallBack callout, SCNetworkReachabilityContext *context);
复制代码

当网络状态发生变化时, 就会调用callout, 第一个参数是网络连接引用, 第二个参数是回调, 如果为NULL, 当前的target就会被移除, SCNetworkReachabilityCallBack的类型为(typedef void (*SCNetworkReachabilityCallBack)(SCNetworkReachabilityRef target, SCNetworkReachabilityFlags flags, void *info);) callout回调中的info参数就是从第三个参数context结构体中取的info回调, 这样就把结构体context中的数据传到了SCNetworkReachabilityCallBack参数中, 第三个参数是与callout相关联的上下文, 可能为空. 如果通知客户端成功就返回true, 否则返回false.

Boolean SCNetworkReachabilityScheduleWithRunLoop(SCNetworkReachabilityRef target, CFRunLoopRef runLoop, CFStringRef runLoopMode);
复制代码

使用指定的运行循环和模式调度指定的网络目标, 第一个参数是网络连接引用, 第二个参数runloop循环, 第三个参数循环模式. 如果target运行成功就返回true, 否则返回false. 这里将target加入指定的runloop中, 会一直监测target的网络状态, 当网络状态发生变化时就会执行SCNetworkReachabilitySetCallback方法中的callout回调, 所以我们只需要定义一个SCNetworkReachabilityCallBack类型的block, 将其传入SCNetworkReachabilitySetCallback方法中即可.