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方法中即可.
