AFNetworking 解读

终于写完了 AFNetworking 的源码解读。这一过程耗时数天。当我回过头又重头到尾的读了一篇，又有所收获。不禁让我想起了当初上学时的种种情景。我们应该对知识进行反复的记忆和理解。下边是我总结的 AFNetworking 中能够学到的知识点。

1.枚举(enum)

使用原则：当满足一个有限的并具有统一主题的集合的时候，我们就考虑使用枚举。这在很多框架中都验证了这个原则。最重要的是能够增加程序的可读性。

示例代码：

/** * 网络类型 （需要封装为一个自己的枚举） */ typedef NS_ENUM(NSInteger, AFNetworkReachabilityStatus) { /** * 未知 */ AFNetworkReachabilityStatusUnknown = -1, /** * 无网络 */ AFNetworkReachabilityStatusNotReachable = 0, /** * WWAN 手机自带网络 */ AFNetworkReachabilityStatusReachableViaWWAN = 1, /** * WiFi */ AFNetworkReachabilityStatusReachableViaWiFi = 2, };

2.注释

我们必须知道一个事实，注释的代码是不会编译到目标文件的，因此放心大胆的注释吧。在平日里的开发中，应该经常问问自己是否把每段代码都当成写API那样对待？

曾经看过两种不同的说辞，一种是说把代码注释尽量少些，要求代码简介可读性强。另一种是说注释要详细，着重考虑他人读代码的感受。个人感觉还是写详细一点比较好，因为可能过一段时间之后，自己再去看自己当时写的代码可能就不记得了。很有可能在写这些繁琐的注释的过程中，能够想到些什么，比如如何合并掉一些没必要的方法等等。

示例代码：

/*! @header SCNetworkReachability @discussion The SCNetworkReachability API allows an application to determine the status of a system's current network configuration and the reachability of a target host. In addition, reachability can be monitored with notifications that are sent when the status has changed. "Reachability" reflects whether a data packet, sent by an application into the network stack, can leave the local computer. Note that reachability does <i>not</i> guarantee that the data packet will actually be received by the host. */ /*! @typedef SCNetworkReachabilityRef @discussion This is the handle to a network address or name. */ typedef const struct CF_BRIDGED_TYPE(id) __SCNetworkReachability * SCNetworkReachabilityRef;

3.BOOL属性的property书写规则

通常我们在定义一个BOOL属性的时候，要自定义getter方法，这样做的目的是为了增加程序的可读性。Apple中的代码也是这么写的。

示例代码：

/** Whether or not the network is currently reachable. */ @property (readonly, nonatomic, assign, getter = isReachable) BOOL reachable; // setter self.reachable = YES; // getter if (self.isReachable) {}

4.按功能区分代码

假如我们写的一个控制器中大概有500行代码，我们应该保证能够快速的找到我们需要查找的内容，这就需要把代码按照功能来分隔。

通常在.h中 我们可以使用一个自定义的特殊的注释来分隔，在.m中使用#pragma mark -来分隔。

示例代码：

///--------------------- /// @name Initialization ///--------------------- ///------------------------------ /// @name Evaluating Server Trust ///------------------------------ #pragma mark - UI ...设置UI相关 #pragma mark - Data ...处理数据 #pragma mark - Action ...点击事件

5.通知

我们都知道通知可以用来传递事件和数据，但要想用好它，也不太容易。在AFNetworking 事件和数据的传递使用的是通知和Block，按照AFNetworking对通知的使用习惯。我总结了几点：

原则：如果我们需要传递事件或数据，可采用代理和Block，同时额外增加一个通知。因为通知具有跨多个界面的优点。释放问题：在接收通知的页面，一定要记得移除监听。使用方法：在.h中 FOUNDATION_EXPORT + NSString * const +通知名 在.m中赋值。如果在别的页面用到这个通知，使用extern + NSString * const +通知名就可以了。

ps： FOUNDATION_EXPORT 和#define 都能定义常量。FOUNDATION_EXPORT 能够使用==进行判断，效率略高。而且能够隐藏定义细节(就是实现部分不在.中)

示例代码：

FOUNDATION_EXPORT NSString * const AFNetworkingReachabilityDidChangeNotification; FOUNDATION_EXPORT NSString * const AFNetworkingReachabilityNotificationStatusItem; /** * 网络环境发生改变的时候接受的通知 */ NSString * const AFNetworkingReachabilityDidChangeNotification = @"com.alamofire.networking.reachability.change"; /** * 网络环境发生变化是会发送一个通知，同时携带一组状态数据，根据这个key来去除网络status */ NSString * const AFNetworkingReachabilityNotificationStatusItem = @"AFNetworkingReachabilityNotificationStatusItem";

6.国际化的问题

我个人认为在开发一个APP之初，就应该考虑国际化的问题，不管日后会不会用到这个功能。当你有了国际化的思想之后，在对控件进行布局的时候，就会比只在一种语言下考虑的更多，这会让一个人对控件布局的视野更加宽阔。好了，这个问题就说这么多。有兴趣的朋友请自行查找相关内容。

7.私有方法

在开发中，难免会使用私有方法来协助我们达到某种目的或获取某个数据。在oc中，我看到很多人都会这样写：- (void)funName {}。个人是不赞成这样写了，除非方法内部使用了self。总之，类似于这样的方法，其实跟我们的业务并没有太大的关系。我进入一个控制器的文件中，目光应该集中在业务代码上才对。

在 AFNetworking 中，一般都会把私有方法，也可以叫函数，放到头部，你即使不看这些代码，对于整个业务的理解也不会受到影响。所以，这种写法值得推荐。可以适当的使用内联函数，提高效率.

示例代码：

/** * 把枚举的值转换成字符串 */ NSString * AFStringFromNetworkReachabilityStatus(AFNetworkReachabilityStatus status) { switch (status) { case AFNetworkReachabilityStatusNotReachable: return NSLocalizedStringFromTable(@"Not Reachable", @"AFNetworking", nil); case AFNetworkReachabilityStatusReachableViaWWAN: return NSLocalizedStringFromTable(@"Reachable via WWAN", @"AFNetworking", nil); case AFNetworkReachabilityStatusReachableViaWiFi: return NSLocalizedStringFromTable(@"Reachable via WiFi", @"AFNetworking", nil); case AFNetworkReachabilityStatusUnknown: default: return NSLocalizedStringFromTable(@"Unknown", @"AFNetworking", nil); } } - (NSString *)AFStringFromNetworkReachabilityStatus:(AFNetworkReachabilityStatus)status { switch (status) { case AFNetworkReachabilityStatusNotReachable: return NSLocalizedStringFromTable(@"Not Reachable", @"AFNetworking", nil); case AFNetworkReachabilityStatusReachableViaWWAN: return NSLocalizedStringFromTable(@"Reachable via WWAN", @"AFNetworking", nil); case AFNetworkReachabilityStatusReachableViaWiFi: return NSLocalizedStringFromTable(@"Reachable via WiFi", @"AFNetworking", nil); case AFNetworkReachabilityStatusUnknown: default: return NSLocalizedStringFromTable(@"Unknown", @"AFNetworking", nil); } }

8.SCNetworkReachabilityRef（网络监控核心实现）

SCNetworkReachabilityRef 是获取网络状态的核心对象，创建这个对象有两个方法：

SCNetworkReachabilityCreateWithNameSCNetworkReachabilityCreateWithAddress

我们看看实现网络监控的核心代码：

示例代码：

- (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); } }; SCNetworkReachabilityContext context = {0, (__bridge void *)callback, AFNetworkReachabilityRetainCallback, AFNetworkReachabilityReleaseCallback, NULL}; SCNetworkReachabilitySetCallback(self.networkReachability, AFNetworkReachabilityCallback, &context); SCNetworkReachabilityScheduleWithRunLoop(self.networkReachability, CFRunLoopGetMain(), kCFRunLoopCommonModes); dispatch_async(dispatch_get_global_queue(DISPATCH_QUEUE_PRIORITY_BACKGROUND, 0),^{ SCNetworkReachabilityFlags flags; if (SCNetworkReachabilityGetFlags(self.networkReachability, &flags)) { AFPostReachabilityStatusChange(flags, callback); } }); }

上边的方法中涉及了一些 CoreFoundation 的知识，我们来看看：

SCNetworkReachabilityContext点进去，会发现这是一个结构体，一般c语言的结构体是对要保存的数据的一种描述

示例代码：

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; 第一个参数接受一个signed long 的参数第二个参数接受一个void 类型的值，相当于oc的id类型，void 可以指向任何类型的参数第三个参数 是一个函数 目的是对info做retain操作第四个参数是一个函数，目的是对info做release操作第五个参数是 一个函数，根据info获取Description字符串

设置网络监控分为下边几个步骤：

1.我们先新建上下文

SCNetworkReachabilityContext context = {0, (__bridge void *)callback, AFNetworkReachabilityRetainCallback, AFNetworkReachabilityReleaseCallback, NULL};

2.设置回调

SCNetworkReachabilitySetCallback(self.networkReachability, AFNetworkReachabilityCallback, &context);

3.加入RunLoop池

SCNetworkReachabilityScheduleWithRunLoop(self.networkReachability, CFRunLoopGetMain(), kCFRunLoopCommonModes);

9.键值依赖

注册键值依赖，这个可能大家平时用的比较少。可以了解一下。举个例子：

比如说一个类User中有两个属性

还有一个卡片的类card

我们写一个info的setter 和 getter 方法，

这么做的目的是，如果我监听info这个属性，当user中的name或者age有一个改变了，能够出发info的这个监听事件。

示例代码：

@interface User :NSObject @property (nonatomic,copy)NSString *name; @property (nonatomic,assign)NSUInteger age; @end @interface card :NSObject @property (nonatomic,copy)NSString *info; @property (nonatomic,strong)User *user; @end @implementation card - (NSString *)info { return [NSString stringWithFormat:@"%@/%lu",_user.name,(unsigned long)_user.age]; } - (void)setInfo:(NSString *)info { NSArray *array = [info componentsSeparatedByString:@"/"]; _user.name = array[0]; _user.age = [array[1] integerValue]; } + (NSSet<NSString *> *)keyPathsForValuesAffectingValueForKey:(NSString *)key { NSSet * keyPaths = [super keyPathsForValuesAffectingValueForKey:key]; NSArray * moreKeyPaths = nil; if ([key isEqualToString:@"info"]) { moreKeyPaths = [NSArray arrayWithObjects:@"user.name", @"user.age", nil]; } if (moreKeyPaths) { keyPaths = [keyPaths setByAddingObjectsFromArray:moreKeyPaths]; } return keyPaths; } @end

10.HTTP

HTTP协议用于客户端和服务器端之间的通信通过请求和相应的交换达成通信HTTP是不保存状态的协议 HTTP自身不会对请求和相应之间的通信状态进行保存。什么意思呢？就是说，当有新的请求到来的时候，HTTP就会产生新的响应，对之前的请求和响应的保温信息不做任何存储。这也是为了快速的处理事务，保持良好的可伸展性而特意设计成这样的。 请求URI定位资源 URI算是一个位置的索引，这样就能很方便的访问到互联网上的各种资源。 告知服务器意图的HTTP方法 ①GET： 直接访问URI识别的资源，也就是说根据URI来获取资源。②POST： 用来传输实体的主体。③PUT： 用来传输文件。④HEAD： 用来获取报文首部，和GET方法差不多，只是响应部分不会返回主体内容。⑤DELETE： 删除文件，和PUT恰恰相反。按照请求的URI来删除指定位置的资源。⑥OPTIONS： 询问支持的方法，用来查询针对请求URI指定的资源支持的方法。⑦TRACE： 追踪路径，返回服务器端之前的请求通信环信息。⑧CONNECT： 要求用隧道协议连接代理，要求在与代理服务器通信时建立隧道，实现用隧道协议进行TCP通信。SSL(Secure Sockets Layer)和TLS(Transport Layer Security)就是把通信内容加密后进行隧道传输的。 管线化让服务器具备了相应多个请求的能力Cookie让HTTP有迹可循

11.HTTPS

HTTPS是一个通信安全的解决方案，可以说相对已经非常安全。为什么它会是一个很安全的协议呢？下边会做出解释。大家可以看看这篇文章，解释的很有意思 。《简单粗暴系列之HTTPS原理》.

HTTP + 加密 + 认证 + 完整性保护 = HTTPS

其实HTTPS是身披SSL外壳的HTTP，这句话怎么理解呢？

大家应该都知道HTTP是应用层的协议，但HTTPS并非是应用层的一种新协议，只是HTTP通信接口部分用SSL或TLS协议代替而已。

通常 HTTP 直接和TCP通信，当使用SSL时就不同了。要先和SSL通信，再由SSL和TCP通信。

这里再说一些关于加密的题外话：

现如今，通常加密和解密的算法都是公开的。举个例子： a b = 200，加入a是你知道的密码，b是需要被加密的数据，200 是加密后的结果。那么这里这个号就是一个很简单的加密算法。这个算法是如此简单。但是如果想要在不知道a和b其中一个的情况下进行破解也是很困难的。就算我们知道了200 然后得到a b 这个也很难。假设知道了密码a 那么b就很容易算出b = 200 / a 。

实际中的加密算法比这个要复杂的多。

介绍两种常用加密方法：

共享密钥加密

公开密钥加密

共享密钥加密就是加密和解密通用一个密钥，也称为对称加密。优点是加密解密速度快，缺点是一旦密钥泄露，别人也能解密数据。

公开密钥加密恰恰能解决共享密钥加密的困难，过程是这样的：

①发文方使用对方的公开密钥进行加密

②接受方在使用自己的私有密钥进行解密

关于公开密钥，也就是非对称加密 可以看看这篇文章 RSA算法原理

原理都是一样的，这个不同于刚才举得a和b的例子，就算知道了结果和公钥，破解出被机密的数据是非常难的。这里边主要涉及到了复杂的数学理论。

HTTPS采用混合加密机制

HTTPS采用共享密钥加密和公开密钥加密两者并用的混合加密机制。

注意黄色的部分，这个指明了，我们平时使用的一个场景。这篇文章会很长，不仅仅是为了解释HTTPS，还为了能够增加记忆，当日后想看看的时候，就能通过读这边文章想起大部分的HTTPS的知识。下边解释一些更加详细的HTTPS过程。

12.如何获取证书中的PublicKey

// 在证书中获取公钥 static id AFPublicKeyForCertificate(NSData *certificate) { id allowedPublicKey = nil; SecCertificateRef allowedCertificate; SecCertificateRef allowedCertificates[1]; CFArrayRef tempCertificates = nil; SecPolicyRef policy = nil; SecTrustRef allowedTrust = nil; SecTrustResultType result; // 1. 根据二进制的certificate生成SecCertificateRef类型的证书 // NSData *certificate 通过CoreFoundation (__bridge CFDataRef)转换成 CFDataRef // 看下边的这个方法就可以知道需要传递参数的类型 /* SecCertificateRef SecCertificateCreateWithData(CFAllocatorRef __nullable allocator, CFDataRef data) __OSX_AVAILABLE_STARTING(__MAC_10_6, __IPHONE_2_0); */ allowedCertificate = SecCertificateCreateWithData(NULL, (__bridge CFDataRef)certificate); // 2.如果allowedCertificate为空，则执行标记_out后边的代码 __Require_Quiet(allowedCertificate != NULL, _out); // 3.给allowedCertificates赋值 allowedCertificates[0] = allowedCertificate; // 4.新建CFArra： tempCertificates tempCertificates = CFArrayCreate(NULL, (const void **)allowedCertificates, 1, NULL); // 5. 新建policy为X.509 policy = SecPolicyCreateBasicX509(); // 6.创建SecTrustRef对象，如果出错就跳到_out标记处 __Require_noErr_Quiet(SecTrustCreateWithCertificates(tempCertificates, policy, &allowedTrust), _out); // 7.校验证书的过程，这个不是异步的。 __Require_noErr_Quiet(SecTrustEvaluate(allowedTrust, &result), _out); // 8.在SecTrustRef对象中取出公钥 allowedPublicKey = (__bridge_transfer id)SecTrustCopyPublicKey(allowedTrust); _out: if (allowedTrust) { CFRelease(allowedTrust); } if (policy) { CFRelease(policy); } if (tempCertificates) { CFRelease(tempCertificates); } if (allowedCertificate) { CFRelease(allowedCertificate); } return allowedPublicKey; }

在二进制的文件中获取公钥的过程是这样

① NSData *certificate -> CFDataRef -> (SecCertificateCreateWithData) -> SecCertificateRef allowedCertificate②判断SecCertificateRef allowedCertificate 是不是空，如果为空，直接跳转到后边的代码③allowedCertificate 保存在allowedCertificates数组中④allowedCertificates -> (CFArrayCreate) -> SecCertificateRef allowedCertificates[1]⑤根据函数SecPolicyCreateBasicX509() -> SecPolicyRef policy⑥SecTrustCreateWithCertificates(tempCertificates, policy, &allowedTrust) -> 生成SecTrustRef allowedTrust⑦SecTrustEvaluate(allowedTrust, &result) 校验证书⑧(__bridge_transfer id)SecTrustCopyPublicKey(allowedTrust) -> 得到公钥id allowedPublicKey

这个过程我们平时也不怎么用，了解下就行了，真需要的时候知道去哪里找资料就行了。

这里边值得学习的地方是：

Require_Quiet 和 Require_noErr_Quiet 这两个宏定义。

我们看看他们内部是怎么定义的

可以看出这个宏的用途是：当条件返回false时，执行标记以后的代码

可以看出这个宏的用途是：当条件抛出异常时，执行标记以后的代码

这样就有很多使用场景了。当必须要对条件进行判断的时候，我们有下边几种方案了

#ifdef 这个是编译特性

if else 代码层次的判断

__Require_XXX 宏

_out 就是一个标记，这段代码__Require_Quiet 到_out之间的代码不会执行

13.URL编码

关于什么叫URI编码和为什么要编码，请看我转载的这篇文章url 编码（percentcode 百分号编码）

根据RFC 3986的规定：URL百分比编码的保留字段分为：

':' '#' '[' ']' '@' '?' '/''!' '$' '&' ''' '(' ')' '*' '+' ',' ';' '='

在对查询字段百分比编码时，'?'和'/'可以不用编码，其他的都要进行编码。我记得在使用支付宝支付时，在对数据进行URL编码时要求编码'/'.

NSString * AFPercentEscapedStringFromString(NSString *string) { static NSString * const kAFCharactersGeneralDelimitersToEncode = @":#[]@"; // does not include "?" or "/" due to RFC 3986 - Section 3.4 static NSString * const kAFCharactersSubDelimitersToEncode = @"!$&'()*+,;="; // '?'和'/'在query查询允许不被转译，因此!$&'()*+,;=和:#[]@都要被转译，也就是在URLQueryAllowedCharacterSet中删除掉这些字符 NSMutableCharacterSet * allowedCharacterSet = [[NSCharacterSet URLQueryAllowedCharacterSet] mutableCopy]; [allowedCharacterSet removeCharactersInString:[kAFCharactersGeneralDelimitersToEncode stringByAppendingString:kAFCharactersSubDelimitersToEncode]]; // FIXME: https://github.com/AFNetworking/AFNetworking/pull/3028 // return [string stringByAddingPercentEncodingWithAllowedCharacters:allowedCharacterSet]; static NSUInteger const batchSize = 50; NSUInteger index = 0; NSMutableString *escaped = @"".mutableCopy; while (index < string.length) { //http://www.jianshu.com/p/eb03e20f7b1c #pragma GCC diagnostic push #pragma GCC diagnostic ignored "-Wgnu" NSUInteger length = MIN(string.length - index, batchSize); #pragma GCC diagnostic pop NSRange range = NSMakeRange(index, length); // To avoid breaking up character sequences such as