AFNetworking源码(三)

前言

飞机上的旅客要靠枕.我向他解释经济舱不提供枕头,如果头等舱有富余的枕头才可以提供给他.他都反复强调自己的腰不好.表示出一副没有枕头会死的样子.我很无奈的从头等舱给他要了一个枕头.落地之后,在下飞机的途中非得要我的联系方式.我反复表示并不方便给联系方式.他非得知道哪里不方便.
我说:算了吧,你的腰不好!

timg.jpeg

• AFNetworkReachabilityManager网络监控类,重要负责网络的监听并回调网络状态.

一、四种状态

• 涉及状态类型, 推荐使用枚举类型.

#import 
//通过导入了这个头文件，我们得知：网络监控的实现是依赖SystemConfiguration这个api的。说明这个api能够提供这样的功能
// 网络类型
typedef NS_ENUM(NSInteger, AFNetworkReachabilityStatus) {
    // 未知
    AFNetworkReachabilityStatusUnknown          = -1,
    // 无网络
    AFNetworkReachabilityStatusNotReachable     = 0,
    //  WWAN 蜂窝数据  即手机自带网络
    AFNetworkReachabilityStatusReachableViaWWAN = 1,
   //  WiFi
    AFNetworkReachabilityStatusReachableViaWiFi = 2,
};

• 四种状态的来源

// 获取网络状态的方法
SCNetworkReachabilityGetFlags(self.networkReachability, &flags)

// 把SC状态转换成  枚举状态
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;
         WiFi
    }

    return status;
}

二、nonnull宏

- (nullable NSString *)method;
- (NSString * __nullable)method;
- (NSString * _Nullable)method;
// nonnull 、__nullable、_Nullable都表示返回值是不能为nil, 苹果默认是nullable

NS_ASSUME_NONNULL_BEGIN
// 代码  这里默认 nonnull 修饰
NS_ASSUME_NONNULL_END
//注:写自己的框架的时候可以注意这些细节.

不过，为了安全起见，苹果还制定了以下几条规则：

• 通过typedef 定义的类型的 nullability 特性通常依赖于上下文，即使是在Audited Regions中，也不能假定它为 nonnull；
• 对于复杂的指针类型（如 id * ）必须显式去指定是 nonnull还是 nullable。例如，指定一个指向 nullable 对象的 nonnull 指针，可以使用 __nullable id * __nonnull ；
• 我们经常使用的 NSError ** 通常是被假定为一个指向nullable NSError对象的 nullable 指针。

三、Notification

SCNetworkReachabilityGetFlags(self.networkReachability, &flags)
//这个方法 返回网络是否为链接状态  并改变状态flags,然后发送名字为下面的通知

FOUNDATION_EXPORT NSString * const AFNetworkingReachabilityDidChangeNotification;
//当网络链接状态的改变的时候发送的通知。并且反回当前的网络状态status

FOUNDATION_EXPORT NSString * const AFNetworkingReachabilityNotificationStatusItem;
// 这个是作为网络状态status的key值,保存在userInfo里面

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) };// 第二个key
        [notificationCenter postNotificationName:AFNetworkingReachabilityDidChangeNotification object:nil userInfo:userInfo];//第一个key
    });
}

• 注:我们平时的开发中 但凡设计到发通知的功能，我们应该把通知的字符串封装到一个专有的文件中，同时在文件内部按不同模块进行区分，当然必要的注释也很有必要。