iOS 如何一步一步搭建框架

清疚 2022-07-10 04:17 382阅读 0赞

**前言**

本文参考casatwy先生的网络层架构设计从网络请求的构建到请求结果的处理为你概述如何构建一个方便易用的iOS网络层, 全文约8千字, 预计花费阅读时间20 - 30分钟.

**目录**

*  网络请求的构建
 *  网络请求的派发

1.请求的派发与取消

2.多服务器的切换

*  合理的使用请求派发器

1.协议还是配置对象?

2.简单的请求结果缓存器

3.请求结果的格式化

4.两个小玩意儿

**一、网络请求的构建**

网络请求的构建很简单, 根据一个请求需要的条件如URL, 请求方式, 请求参数, 请求头等定义请求生成的接口即可. 定义如下:

可以看到方法参数都是生成请求基本组成部分, 当然, 这里的参数比较少, 因为在我的项目中像请求超时时间都是一样的, 类似这些公用的设置我都偷懒直接写在请求配置文件里面了. 我们看看请求接口的具体实现, 以数据请求为例:

<table> 
 <tbody> 
  <tr> 
   <td> 
    <div>
      1 
    </div> 
    <div>
      2 
    </div> 
    <div>
      3 
    </div> 
    <div>
      4 
    </div> 
    <div>
      5 
    </div> 
    <div>
      6 
    </div> 
    <div>
      7 
    </div> 
    <div>
      8 
    </div> 
    <div>
      9 
    </div> 
    <div>
      10 
    </div> 
    <div>
      11 
    </div> 
    <div>
      12 
    </div></td> 
   <td> 
    <div> 
     <div> 
      <code>-&nbsp;(NSMutableURLRequest&nbsp;*)generateRequestWithUrlPath:(NSString&nbsp;*)urlPath&nbsp;useHttps:(BOOL)useHttps&nbsp;method:(NSString&nbsp;*)method&nbsp;params:(NSDictionary&nbsp;*)params&nbsp;header:(NSDictionary&nbsp;*)header&nbsp;{ </code> 
     </div> 
     <div> 
      <code>&nbsp;&nbsp;&nbsp;&nbsp;</code>&nbsp; 
     </div> 
     <div> 
      <code>&nbsp;&nbsp;&nbsp;&nbsp;</code> 
      <code>NSString&nbsp;*urlString&nbsp;=&nbsp;[self&nbsp;urlStringWithPath:urlPath&nbsp;useHttps:useHttps];</code> 
     </div> 
     <div> 
      <code>&nbsp;&nbsp;&nbsp;&nbsp;</code> 
      <code>NSMutableURLRequest&nbsp;*request&nbsp;=&nbsp;[self.requestSerialize&nbsp;requestWithMethod:method&nbsp;URLString:urlString&nbsp;parameters:params&nbsp;error:nil];</code> 
     </div> 
     <div> 
      <code>&nbsp;&nbsp;&nbsp;&nbsp;</code> 
      <code>request.timeoutInterval&nbsp;=&nbsp;RequestTimeoutInterval;</code> 
     </div> 
     <div> 
      <code>&nbsp;&nbsp;&nbsp;&nbsp;</code> 
      <code>[self&nbsp;setCookies];</code> 
      <code>//设置cookie</code> 
     </div> 
     <div> 
      <code>&nbsp;&nbsp;&nbsp;&nbsp;</code> 
      <code>[self&nbsp;setCommonRequestHeaderForRequest:request];</code> 
      <code>//&nbsp;在这里做公用请求头的设置</code> 
     </div> 
     <div> 
      <code>&nbsp;&nbsp;&nbsp;&nbsp;</code> 
      <code>[header&nbsp;enumerateKeysAndObjectsUsingBlock:^(id&nbsp;&nbsp;_Nonnull&nbsp;key,&nbsp;id&nbsp;&nbsp;_Nonnull&nbsp;value,&nbsp;BOOL&nbsp;*&nbsp;_Nonnull&nbsp;stop)&nbsp;{ </code> 
     </div> 
     <div> 
      <code>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</code> 
      <code>[request&nbsp;setValue:value&nbsp;forHTTPHeaderField:key];</code> 
     </div> 
     <div> 
      <code>&nbsp;&nbsp;&nbsp;&nbsp;</code> 
      <code>}];</code> 
     </div> 
     <div> 
      <code>&nbsp;&nbsp;&nbsp;&nbsp;</code> 
      <code>return</code>&nbsp; 
      <code>request;</code> 
     </div> 
     <div> 
      <code>}</code> 
     </div> 
    </div></td> 
  </tr> 
 </tbody> 
</table>

代码很简单, 接口根据参数调用urlStringWithPath:useHttps:通过BaseURL和URLPath拼装出完整的URL, 然后用这个URL和其他参数生成一个URLRequest, 然后调用setCommonRequestHeaderForRequest:设置公用请求, 最后返回这个URLRequest.

BaseURL来自HHService, HHService对外暴露各个环境(测试/开发/发布)下的baseURL和切换服务器的接口, 内部走工厂生成当前的服务器, 我的设置是默认连接第一个服务器且APP关闭后恢复此设置, APP运行中可根据需要调用switchService切换服务器.

HHService定义如下:

**二、网络请求的派发**

请求的派发是通过一个单例HHNetworkClient来实现的, 如果把请求比作炮弹的话, 那么这个单例就是发射炮弹的炮台, 使用炮台的人只需要告诉炮台需要发射什么样的炮弹和炮弹的打击目标便可发射了. 另外, 应该提供取消打击的功能以处理不必要的打击的情况, 那么, 根据炮台的作用.

HHNetworkClient定义如下:

<table> 
 <tbody> 
  <tr> 
   <td> 
    <div>
      1 
    </div> 
    <div>
      2 
    </div> 
    <div>
      3 
    </div> 
    <div>
      4 
    </div> 
    <div>
      5 
    </div> 
    <div>
      6 
    </div> 
    <div>
      7 
    </div> 
    <div>
      8 
    </div></td> 
   <td> 
    <div> 
     <div> 
      <code>@interface&nbsp;HHNetworkClient&nbsp;()</code> 
     </div> 
     <div>
       &nbsp; 
     </div> 
     <div> 
      <code>@property&nbsp;(strong,&nbsp;nonatomic)&nbsp;AFHTTPSessionManager&nbsp;*sessionManager;</code> 
     </div> 
     <div> 
      <code>@property&nbsp;(strong,&nbsp;nonatomic)&nbsp;NSMutableDictionary*dispathTable;</code> 
     </div> 
     <div>
       &nbsp; 
     </div> 
     <div> 
      <code>@property&nbsp;(assign,&nbsp;nonatomic)&nbsp;CGFloat&nbsp;totalTaskCount;</code> 
     </div> 
     <div> 
      <code>@property&nbsp;(assign,&nbsp;nonatomic)&nbsp;CGFloat&nbsp;errorTaskCount;</code> 
     </div> 
     <div> 
      <code>@end</code> 
     </div> 
    </div></td> 
  </tr> 
 </tbody> 
</table>

1.请求的派发与取消

外部暴露数据请求和文件上传的接口, 参数为构建请求所需的必要参数, 返回值为此次请求任务的taskIdentifier, 调用方可以通过taskIdentifier取消正在执行的请求任务.

内部声明一个dispathTable保持着此时正在执行的任务, 并在任务执行完成或者任务取消时移除任务的引用, 以数据请求为例, 具体实现如下:

代码很简单, 通过参数生成URLRequest, 然后通过AFHTTPSessionManager执行任务, 在任务执行前我们以task.taskIdentifier为key保持一下执行的任务, 然后在任务执行后我们移除这个任务, 当然, 外部也可以在必要的时候通过我们返回的task.taskIdentifier手动移除任务.

注意我们先声明一个NSMutableArray来标志taskIdentifier, 然后在任务生成后设置taskIdentifier\[0\]为task. taskIdentifier, 最后在任务完成的回调block中使用taskIdentifier\[0\]来移除这个已经完成的任务.

可能有人会有疑问为什么不直接使用task.taskIdentifier, block不是可以捕获task吗? 下面解释一下为什么这样写:

我们知道block之于函数最大的区别就在于它可以捕获自身作用域外的对象, 并在block执行的时候访问被捕获的对象, 具体的, 对于值类型对象block会生成一份此对象的拷贝, 对于引用类型对象block会生成一个此对象的引用并使该对象的引用计数+1(这里我们只描述非\_\_block修饰的情况). 那么代入到上面的代码, 我们来一步一步分析:

*  直接捕获task的写法

<table> 
 <tbody> 
  <tr> 
   <td> 
    <div>
      1 
    </div> 
    <div>
      2 
    </div> 
    <div>
      3 
    </div> 
    <div>
      4 
    </div> 
    <div>
      5 
    </div> 
    <div>
      6 
    </div></td> 
   <td> 
    <div> 
     <div> 
      <code>NSURLSessionDataTask&nbsp;*task&nbsp;=&nbsp;[self.sessionManager&nbsp;dataTaskWithRequest:request&nbsp;completionHandler:^(NSURLResponse&nbsp;*&nbsp;_Nonnull&nbsp;response,&nbsp;id&nbsp;&nbsp;_Nullable&nbsp;responseObject,&nbsp;NSError&nbsp;*&nbsp;_Nullable&nbsp;error)&nbsp;{ </code> 
     </div> 
     <div> 
      <code>&nbsp;&nbsp;</code> 
      <code>...略</code> 
     </div> 
     <div> 
      <code>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</code> 
      <code>[self.dispathTable&nbsp;removeObjectForKey:@(task.taskIdentifier)];</code> 
     </div> 
     <div> 
      <code>...略</code> 
     </div> 
     <div> 
      <code>&nbsp;&nbsp;&nbsp;&nbsp;</code> 
      <code>}];</code> 
     </div> 
     <div> 
      <code>[self.dispathTable&nbsp;setObject:task&nbsp;forKey:@(task.taskIdentifier)];</code> 
     </div> 
    </div></td> 
  </tr> 
 </tbody> 
</table>

我们把它拆开来看:

<table> 
 <tbody> 
  <tr> 
   <td> 
    <div>
      1 
    </div> 
    <div>
      2 
    </div> 
    <div>
      3 
    </div> 
    <div>
      4 
    </div> 
    <div>
      5 
    </div> 
    <div>
      6 
    </div> 
    <div>
      7 
    </div> 
    <div>
      8 
    </div></td> 
   <td> 
    <div> 
     <div> 
      <code>NSURLSessionDataTask&nbsp;*task;&nbsp;</code> 
     </div> 
     <div> 
      <code>NSURLSessionDataTask&nbsp;*returnTask&nbsp;=&nbsp;[self.sessionManager&nbsp;dataTaskWithRequest:request&nbsp;completionHandler:^(NSURLResponse&nbsp;*&nbsp;_Nonnull&nbsp;response,&nbsp;id&nbsp;&nbsp;_Nullable&nbsp;responseObject,&nbsp;NSError&nbsp;*&nbsp;_Nullable&nbsp;error)&nbsp;{ </code> 
     </div> 
     <div> 
      <code>&nbsp;&nbsp;</code> 
      <code>...略</code> 
     </div> 
     <div> 
      <code>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</code> 
      <code>[self.dispathTable&nbsp;removeObjectForKey:@(task.taskIdentifier)];</code> 
     </div> 
     <div> 
      <code>...略</code> 
     </div> 
     <div> 
      <code>&nbsp;&nbsp;&nbsp;&nbsp;</code> 
      <code>}];</code> 
     </div> 
     <div> 
      <code>task&nbsp;=&nbsp;&nbsp;returnTask;</code> 
     </div> 
     <div> 
      <code>[self.dispathTable&nbsp;setObject:task&nbsp;forKey:@(task.taskIdentifier)];</code> 
     </div> 
    </div></td> 
  </tr> 
 </tbody> 
</table>

可以看到returnTask是我们实际存储的任务, 而task只是一个临时变量, 此时task指向nil, 那我们生成returnTask的block此时捕获到的task也就是nil, 所以在任务完成的时候我们的task.taskIdentifier一定是0, 这样写的结果就是dispathTable只会添加不会删除(系统的taskIdentifier是从0开始依次递增的), 当然, 因为进行中的returnTask我们是做了存储的, 所以在任务未完成的时候我们还是可以做取消的.

*  如果一开始给task一个占位对象呢不让它为nil可以吗?

<table> 
 <tbody> 
  <tr> 
   <td> 
    <div>
      1 
    </div> 
    <div>
      2 
    </div> 
    <div>
      3 
    </div> 
    <div>
      4 
    </div> 
    <div>
      5 
    </div> 
    <div>
      6 
    </div> 
    <div>
      7 
    </div> 
    <div>
      8 
    </div></td> 
   <td> 
    <div> 
     <div> 
      <code>NSURLSessionDataTask&nbsp;*task&nbsp;=&nbsp;[NSObject&nbsp;</code> 
      <code>new</code> 
      <code>];&nbsp;</code> 
      <code>//1.suspend</code> 
     </div> 
     <div> 
      <code>NSURLSessionDataTask&nbsp;*returnTask&nbsp;=&nbsp;[self.sessionManager&nbsp;dataTaskWithRequest:request&nbsp;completionHandler:^(NSURLResponse&nbsp;*&nbsp;_Nonnull&nbsp;response,&nbsp;id&nbsp;&nbsp;_Nullable&nbsp;responseObject,&nbsp;NSError&nbsp;*&nbsp;_Nullable&nbsp;error)&nbsp;{ </code> 
     </div> 
     <div> 
      <code>&nbsp;&nbsp;</code> 
      <code>...略</code> 
     </div> 
     <div> 
      <code>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</code> 
      <code>[self.dispathTable&nbsp;removeObjectForKey:@(task.taskIdentifier)];</code> 
      <code>//3.completed</code> 
     </div> 
     <div> 
      <code>...略</code> 
     </div> 
     <div> 
      <code>&nbsp;&nbsp;&nbsp;&nbsp;</code> 
      <code>}];</code> 
      <code>//2.alloc</code> 
     </div> 
     <div> 
      <code>task&nbsp;=&nbsp;&nbsp;returnTask;</code> 
     </div> 
     <div> 
      <code>[self.dispathTable&nbsp;setObject:task&nbsp;forKey:@(task.taskIdentifier)];</code> 
     </div> 
    </div></td> 
  </tr> 
 </tbody> 
</table>

这样其实就是一个简单的引用变换题了, 我们来看看各个指针的指向情况:

<table> 
 <tbody> 
  <tr> 
   <td> 
    <div>
      1 
    </div> 
    <div>
      2 
    </div> 
    <div>
      3 
    </div></td> 
   <td> 
    <div> 
     <div> 
      <code>suspend:&nbsp;pTask-&gt;NSObject&nbsp;&nbsp;block.pTask-&gt;nil&nbsp;&nbsp;&nbsp;pReturnTask-&gt;nil</code> 
     </div> 
     <div> 
      <code>alloc:&nbsp;pTask-&gt;&nbsp;NSObject&nbsp;&nbsp;&nbsp;block.pTask-&gt;NSObject&nbsp;&nbsp;&nbsp;pReturnTask-&gt;returnTask</code> 
     </div> 
     <div> 
      <code>completed:&nbsp;pTask-&gt;returnTask&nbsp;block.pTask-&gt;NSObject&nbsp;pReturnTask-&gt;returnTask</code> 
     </div> 
    </div></td> 
  </tr> 
 </tbody> 
</table>

可以看到在任务执行完成时我们访问block.pTask时也不过是我们一开始的占位对象, 所以这个方案也不行, 当然, 取消任务依然可用

事实上block.pTask确实是捕获了占位对象, 只是我们在那之后没有替换block.pTask指向到returnTask, 然而block.pTask我们是访问不了的, 所以这个方案行不通.

*  如果我们的占位对象是一个容器呢?

<table> 
 <tbody> 
  <tr> 
   <td> 
    <div>
      1 
    </div> 
    <div>
      2 
    </div> 
    <div>
      3 
    </div> 
    <div>
      4 
    </div> 
    <div>
      5 
    </div> 
    <div>
      6 
    </div> 
    <div>
      7 
    </div> 
    <div>
      8 
    </div></td> 
   <td> 
    <div> 
     <div> 
      <code>NSMutableArray&nbsp;*taskIdentifier&nbsp;=&nbsp;[NSMutableArray&nbsp;arrayWithObject:@-1];</code> 
     </div> 
     <div> 
      <code>NSURLSessionDataTask&nbsp;*returnTask&nbsp;=&nbsp;[self.sessionManager&nbsp;dataTaskWithRequest:request&nbsp;completionHandler:^(NSURLResponse&nbsp;*&nbsp;_Nonnull&nbsp;response,&nbsp;id&nbsp;&nbsp;_Nullable&nbsp;responseObject,&nbsp;NSError&nbsp;*&nbsp;_Nullable&nbsp;error)&nbsp;{ </code> 
     </div> 
     <div> 
      <code>&nbsp;&nbsp;</code> 
      <code>...略</code> 
     </div> 
     <div> 
      <code>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</code> 
      <code>[self.dispathTable&nbsp;removeObjectForKey:@(taskIdentifier.firstObject)];</code> 
     </div> 
     <div> 
      <code>...略</code> 
     </div> 
     <div> 
      <code>&nbsp;&nbsp;&nbsp;&nbsp;</code> 
      <code>}];</code> 
     </div> 
     <div> 
      <code>taskIdentifier[0]&nbsp;=&nbsp;@(returnTask.taskIdentifier);</code> 
     </div> 
     <div> 
      <code>[self.dispathTable&nbsp;setObject:task&nbsp;forKey:@(task.taskIdentifier)];</code> 
     </div> 
    </div></td> 
  </tr> 
 </tbody> 
</table>

既然我们访问不了block.pTask那就访问block.pTask指向的对象嘛, 更改这个对象的内容不就相当于更改了block.pTask么, 大家照着2的思路走一下应该很容易就能想通, 我就不多说了.

**2.多服务器的切换**

关于多服务器其实我也没有实际的经验, 公司正在部署第二台服务器, 具体需求是如果访问第一台服务器总是超时或者出错, 那就切换到第二台服务器, 基于此需求我简单的实现一下:

<table> 
 <tbody> 
  <tr> 
   <td> 
    <div>
      1 
    </div> 
    <div>
      2 
    </div> 
    <div>
      3 
    </div> 
    <div>
      4 
    </div> 
    <div>
      5 
    </div> 
    <div>
      6 
    </div> 
    <div>
      7 
    </div> 
    <div>
      8 
    </div></td> 
   <td> 
    <div> 
     <div> 
      <code>-&nbsp;(NSNumber&nbsp;*)dispatchTask:(NSURLSessionDataTask&nbsp;*)task&nbsp;{ </code> 
     </div> 
     <div> 
      <code>&nbsp;&nbsp;&nbsp;&nbsp;</code> 
      <code>...略</code> 
     </div> 
     <div> 
      <code>&nbsp;&nbsp;&nbsp;&nbsp;</code> 
      <code>dispatch_semaphore_wait(lock,&nbsp;DISPATCH_TIME_FOREVER);</code> 
     </div> 
     <div> 
      <code>&nbsp;&nbsp;&nbsp;&nbsp;</code> 
      <code>self.totalTaskCount&nbsp;+=&nbsp;1;</code> 
     </div> 
     <div> 
      <code>&nbsp;&nbsp;&nbsp;&nbsp;</code> 
      <code>[self.dispathTable&nbsp;setObject:task&nbsp;forKey:@(task.taskIdentifier)];</code> 
     </div> 
     <div> 
      <code>&nbsp;&nbsp;&nbsp;&nbsp;</code> 
      <code>dispatch_semaphore_signal(lock);</code> 
     </div> 
     <div> 
      <code>&nbsp;&nbsp;&nbsp;&nbsp;</code> 
      <code>...略</code> 
     </div> 
     <div> 
      <code>}</code> 
     </div> 
    </div></td> 
  </tr> 
 </tbody> 
</table>

<table> 
 <tbody> 
  <tr> 
   <td> 
    <div>
      1 
    </div> 
    <div>
      2 
    </div> 
    <div>
      3 
    </div> 
    <div>
      4 
    </div> 
    <div>
      5 
    </div> 
    <div>
      6 
    </div> 
    <div>
      7 
    </div> 
    <div>
      8 
    </div> 
    <div>
      9 
    </div> 
    <div>
      10 
    </div> 
    <div>
      11 
    </div></td> 
   <td> 
    <div> 
     <div> 
      <code>-&nbsp;(NSURLSessionDataTask&nbsp;*)dataTaskWithUrlPath:(NSString&nbsp;*)urlPath&nbsp;useHttps:(BOOL)useHttps&nbsp;requestType:(HHNetworkRequestType)requestType&nbsp;params:(NSDictionary&nbsp;*)params&nbsp;header:(NSDictionary&nbsp;*)header&nbsp;completionHandler:(void&nbsp;(^)(NSURLResponse&nbsp;*,&nbsp;id,&nbsp;NSError&nbsp;*))completionHandler&nbsp;{ </code> 
     </div> 
     <div> 
      <code>&nbsp;&nbsp;</code>&nbsp; 
     </div> 
     <div> 
      <code>&nbsp;&nbsp;&nbsp;&nbsp;</code> 
      <code>NSString&nbsp;*method&nbsp;=&nbsp;(requestType&nbsp;==&nbsp;HHNetworkRequestTypeGet&nbsp;?&nbsp;@</code> 
      <code>"GET"</code>&nbsp; 
      <code>:&nbsp;@</code> 
      <code>"POST"</code> 
      <code>);</code> 
     </div> 
     <div> 
      <code>&nbsp;&nbsp;&nbsp;&nbsp;</code> 
      <code>...略</code> 
     </div> 
     <div> 
      <code>&nbsp;&nbsp;&nbsp;&nbsp;</code> 
      <code>NSURLSessionDataTask&nbsp;*task&nbsp;=&nbsp;[self.sessionManager&nbsp;dataTaskWithRequest:request&nbsp;completionHandler:^(NSURLResponse&nbsp;*&nbsp;_Nonnull&nbsp;response,&nbsp;id&nbsp;&nbsp;_Nullable&nbsp;responseObject,&nbsp;NSError&nbsp;*&nbsp;_Nullable&nbsp;error)&nbsp;{ </code> 
     </div> 
     <div> 
      <code>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</code> 
      <code>...略</code> 
     </div> 
     <div> 
      <code>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</code> 
      <code>[self&nbsp;checkSeriveWithTaskError:error];</code> 
     </div> 
     <div> 
      <code>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</code> 
      <code>...略</code> 
     </div> 
     <div> 
      <code>&nbsp;&nbsp;&nbsp;&nbsp;</code> 
      <code>}];</code> 
     </div> 
     <div> 
      <code>&nbsp;&nbsp;&nbsp;&nbsp;</code> 
      <code>...略</code> 
     </div> 
     <div> 
      <code>}</code> 
     </div> 
    </div></td> 
  </tr> 
 </tbody> 
</table>

<table> 
 <tbody> 
  <tr> 
   <td> 
    <div>
      1 
    </div> 
    <div>
      2 
    </div> 
    <div>
      3 
    </div> 
    <div>
      4 
    </div> 
    <div>
      5 
    </div> 
    <div>
      6 
    </div> 
    <div>
      7 
    </div></td> 
   <td> 
    <div> 
     <div> 
      <code>-&nbsp;(void)didReceivedSwitchSeriveNotification:(NSNotification&nbsp;*)notif&nbsp;{ </code> 
     </div> 
     <div> 
      <code>&nbsp;&nbsp;&nbsp;</code>&nbsp; 
     </div> 
     <div> 
      <code>&nbsp;&nbsp;&nbsp;&nbsp;</code> 
      <code>dispatch_semaphore_wait(lock,&nbsp;DISPATCH_TIME_FOREVER);</code> 
     </div> 
     <div> 
      <code>&nbsp;&nbsp;&nbsp;&nbsp;</code> 
      <code>self.totalTaskCount&nbsp;=&nbsp;self.errorTaskCount&nbsp;=&nbsp;0;</code> 
     </div> 
     <div> 
      <code>&nbsp;&nbsp;&nbsp;&nbsp;</code> 
      <code>dispatch_semaphore_signal(lock);</code> 
     </div> 
     <div> 
      <code>&nbsp;&nbsp;&nbsp;&nbsp;</code> 
      <code>[[HHURLRequestGenerator&nbsp;sharedInstance]&nbsp;switchToService:[notif.userInfo[@</code> 
      <code>"service"</code> 
      <code>]&nbsp;integerValue]];</code> 
     </div> 
     <div> 
      <code>}</code> 
     </div> 
    </div></td> 
  </tr> 
 </tbody> 
</table>

假设认为APP在此次使用过程中网络任务的错误率达到10%那就应该切换一下服务器, 我们在任务派发前将任务总数+1, 然后在任务结束后判断任务是否成功, 失败的话将任务失败总数+1再判断是否到达最大错误率, 进而切换到另一台服务器.

另外还有一种情况是大部分服务器都挂了, 后台直接走APNS推送可用的服务器序号过来, 就不用挨个挨个切换了.

**三、合理的使用请求派发器**

OK, 炮弹有了, 炮台也就绪了, 接下来看看如何使用这个炮台.

HHAPIManager对外提供数据请求和取消的接口, 内部调用HHNetworkClient进行实际的请求操作.

**1.协议还是配置对象?**

HHAPIManager的接口我们并没有像之前一样提供多个参数, 而是将多个参数组合为一个配置对象, 下面说一下为什么这样做:

*  为什么多个参数的接口方式不好?

一个APP中调用的API通常都是数以百计甚至千计, 如果有一天需要对已成型的所有的API都追加一个参数, 此时的改动之多, 足使男程序员沉默, 女程序员流泪.

举个例子: APP1.0已经上线, 1.1版本总监突然要求对数据请求加上缓存, 操作请求不用加缓存, 如果是参数接口的形式一般就是这样写:

<table> 
 <tbody> 
  <tr> 
   <td> 
    <div>
      1 
    </div> 
    <div>
      2 
    </div> 
    <div>
      3 
    </div> 
    <div>
      4 
    </div> 
    <div>
      5 
    </div> 
    <div>
      6 
    </div> 
    <div>
      7 
    </div> 
    <div>
      8 
    </div> 
    <div>
      9 
    </div> 
    <div>
      10 
    </div> 
    <div>
      11 
    </div> 
    <div>
      12 
    </div> 
    <div>
      13 
    </div></td> 
   <td> 
    <div> 
     <div> 
      <code>//老接口</code> 
     </div> 
     <div> 
      <code>-&nbsp;(NSNumber&nbsp;*)dispatchTaskWithUrlPath:(NSString&nbsp;*)urlPath</code> 
     </div> 
     <div> 
      <code>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</code> 
      <code>useHttps:(BOOL)useHttps</code> 
     </div> 
     <div> 
      <code>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</code> 
      <code>method:(NSString&nbsp;*)method</code> 
     </div> 
     <div> 
      <code>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</code> 
      <code>params:(NSDictionary&nbsp;*)params</code> 
     </div> 
     <div> 
      <code>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</code> 
      <code>header:(NSDictionary&nbsp;*)header;</code> 
     </div> 
     <div> 
      <code>//新接口</code> 
     </div> 
     <div> 
      <code>-&nbsp;(NSNumber&nbsp;*)dispatchTaskWithUrlPath:(NSString&nbsp;*)urlPath</code> 
     </div> 
     <div> 
      <code>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</code> 
      <code>useHttps:(BOOL)useHttps</code> 
     </div> 
     <div> 
      <code>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</code> 
      <code>method:(NSString&nbsp;*)method</code> 
     </div> 
     <div> 
      <code>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</code> 
      <code>params:(NSDictionary&nbsp;*)params</code> 
     </div> 
     <div> 
      <code>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</code> 
      <code>header:(NSDictionary&nbsp;*)header</code> 
     </div> 
     <div> 
      <code>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</code> 
      <code>shouldCache:(BOOL)shouldCache;</code> 
     </div> 
    </div></td> 
  </tr> 
 </tbody> 
</table>

然后原来的老接口全都调用新接口shouldCache默认传NO, 不需要缓存的API不用做改动, 而需要缓存的API都得改调用新接口然后shouldCache传YES.

这样能暂时解决问题, 工作量也会小一些, 然后过了两天总监过来说, 为什么没有对API区分缓存时间? 还有, 我们又有新需求了. 呵呵!

*  使用协议提升拓展性

<table> 
 <tbody> 
  <tr> 
   <td> 
    <div>
      1 
    </div> 
    <div>
      2 
    </div> 
    <div>
      3 
    </div> 
    <div>
      4 
    </div> 
    <div>
      5 
    </div> 
    <div>
      6 
    </div> 
    <div>
      7 
    </div> 
    <div>
      8 
    </div> 
    <div>
      9 
    </div> 
    <div>
      10 
    </div> 
    <div>
      11 
    </div> 
    <div>
      12 
    </div> 
    <div>
      13 
    </div></td> 
   <td> 
    <div> 
     <div> 
      <code>@protocol&nbsp;HHAPIManager</code> 
     </div> 
     <div>
       &nbsp; 
     </div> 
     <div> 
      <code>@required</code> 
     </div> 
     <div> 
      <code>-&nbsp;(BOOL)useHttps;</code> 
     </div> 
     <div> 
      <code>-&nbsp;(NSString&nbsp;*)urlPath;</code> 
     </div> 
     <div> 
      <code>-&nbsp;(NSDictionary&nbsp;*)parameters;</code> 
     </div> 
     <div> 
      <code>-&nbsp;(OTSNetworkRequestType)requestType;</code> 
     </div> 
     <div>
       &nbsp; 
     </div> 
     <div> 
      <code>@optional</code> 
     </div> 
     <div> 
      <code>-&nbsp;(BOOL)checkParametersIsValid;</code> 
     </div> 
     <div> 
      <code>-&nbsp;(NSTimeInterval)cacheValidTimeInterval;</code> 
     </div> 
     <div> 
      <code>-&nbsp;(NSArray*)uploadContents;</code> 
     </div> 
     <div> 
      <code>@end</code> 
     </div> 
    </div></td> 
  </tr> 
 </tbody> 
</table>

<table> 
 <tbody> 
  <tr> 
   <td> 
    <div>
      1 
    </div> 
    <div>
      2 
    </div> 
    <div>
      3 
    </div> 
    <div>
      4 
    </div> 
    <div>
      5 
    </div></td> 
   <td> 
    <div> 
     <div> 
      <code>@interface&nbsp;HHAPIManager&nbsp;:&nbsp;NSObject</code> 
     </div> 
     <div> 
      <code>...略</code> 
     </div> 
     <div> 
      <code>-&nbsp;(NSNumber&nbsp;*)dispatchTaskWithCompletionHandler:(OTSNetworkTaskCompletionHander)completionHandler;</code> 
     </div> 
     <div> 
      <code>...略</code> 
     </div> 
     <div> 
      <code>@end</code> 
     </div> 
    </div></td> 
  </tr> 
 </tbody> 
</table>

其实最初的设计是走协议的, HHAPIManager遵守这个协议, 内部给上默认参数, dispatchTaskWithCompletionHandler:会去挨个获取这些参数, 各个子类自行实现自己自定义的部分, 这样以后就算有任何拓展, 只需要在协议里面加个方法基类给上默认值, 有需要的子类API重写一下就行了.

*  替换协议为配置对象

<table> 
 <tbody> 
  <tr> 
   <td> 
    <div>
      1 
    </div> 
    <div>
      2 
    </div> 
    <div>
      3 
    </div></td> 
   <td> 
    <div> 
     <div> 
      <code>-&nbsp;(NSURLSessionDataTask&nbsp;*)dataTaskWithConfiguration:(HHDataAPIConfiguration&nbsp;*)config&nbsp;completionHandler:(HHNetworkTaskCompletionHander)completionHandler;</code> 
     </div> 
     <div> 
      <code>-&nbsp;(NSNumber&nbsp;*)dispatchDataTaskWithConfiguration:(HHDataAPIConfiguration&nbsp;*)config&nbsp;completionHandler:(HHNetworkTaskCompletionHander)completionHandler;</code> 
     </div> 
     <div> 
      <code>-&nbsp;(NSNumber&nbsp;*)dispatchUploadTaskWithConfiguration:(HHUploadAPIConfiguration&nbsp;*)config&nbsp;progressHandler:(HHNetworkTaskProgressHandler)progressHandler&nbsp;completionHandler:(HHNetworkTaskCompletionHander)completionHandler;</code> 
     </div> 
    </div></td> 
  </tr> 
 </tbody> 
</table>

协议的方案其实很好, 也是我想要的设计. 但是协议是针对类而言的, 这意味着今后的每添加一个API就需要新建一个HHAPIManager的子类, 很容易就有了几百个API类文件, 维护起来很麻烦, 找起来很麻烦(以上是同事要求替换协议的理由, 我仍然支持协议, 但是他们人多). 所以将协议替换为配置对象, 然后API以模块功能划分, 每个模块一个类文件给出多个API接口 ,内部每个API搭上合适的配置对象, 这样一来只需要十几个类文件.

总之, 考虑到配置对象既可以实现单个API单个类的设计, 也可以满足同事的需求, 协议被换成了配置对象.

另外, 所有的block参数都不写在配置对象里, 而是直接在接口处声明, 看着别扭写着方便(block做参数和做属性哪个写起来简单大家都懂的).

**2.简单的请求结果缓存器**

上面简单提到了请求缓存, 其实我们是没有做缓存的, 因为我司HTTP的API现在基本上都被废弃了, 全是走TCP, 然而TCP的缓存又是另一个故事了.但是还是简单实现一下吧:

简单定义一个HHCache对象, 存放缓存数据, 缓存时间, 缓存时效, 然后HHNetworkCacheManager单例对象内部用NSCache存储缓存对象, 因为NSCache自带线程安全特效, 连锁都不用.

在任务发起之前我们检查一下是否有可用缓存, 有可用缓存直接返回, 没有就走网络, 网络任务成功后存一下请求数据即可.

**3.请求结果的格式化**

网络任务完成后带回的数据以什么样的形式返回给调用方, 分两种情况: 任务成功和任务失败.这里我们定义一下任务成功和失败, 成功表示网络请求成功且带回了可用数据, 失败表示未获取到可用数据.

举个例子: 获取一个话题列表, 用户希望看到的看到是一排排彩色头像, 如果你调用API拿不到这一堆数据那对于用户来说就是失败的. 那么没拿到数据可能是网络出错了, 或者网络没有问题只是用户没有关注过任何话题, 那么相应的展示网络错误提示或者推荐话题提示.

任务成功的话很简单, 直接做相应JSON解析正常返回就行, 如果某个XXXAPI有特殊需求那就新加一个XXXAPIConfig继承APIConfig基类, 在里面添加属性或者方法描述一下你有什么特殊需求, XXXAPI负责格式好返回就行了(所以还是一个API一个类好, 干净).

任务失败的话就麻烦一点, 我希望任何API都能友好的返回错误提示, 具体的, 如果有错误发生了, 那么返回给调用方的error.code一定是可读的枚举而不是301之类的需要比对文档的错误码(必须), error.domain通常就是错误提示语(可选), 这就要求程序员写每个API时都定义好错误枚举(所以还是一个API一个类好, 干净)和相应的错误提示.大概是这样子:

通用的错误枚举和提示语定义在一个.h中, 以后有新增通用描述都在这里添加, 便于管理. HHAPIManager基类会先格式好某些通用错误, 然后各个子类定义自己特有的错误枚举(不可和通用描述冲突)和错误描述, 像这样:

<table> 
 <tbody> 
  <tr> 
   <td> 
    <div>
      1 
    </div> 
    <div>
      2 
    </div> 
    <div>
      3 
    </div> 
    <div>
      4 
    </div> 
    <div>
      5 
    </div> 
    <div>
      6 
    </div> 
    <div>
      7 
    </div> 
    <div>
      8 
    </div> 
    <div>
      9 
    </div> 
    <div>
      10 
    </div> 
    <div>
      11 
    </div> 
    <div>
      12 
    </div></td> 
   <td> 
    <div> 
     <div> 
      <code>//HHTopicAPIManager.h</code> 
     </div> 
     <div> 
      <code>typedef&nbsp;enum&nbsp;:&nbsp;NSUInteger&nbsp;{ </code> 
     </div> 
     <div> 
      <code>&nbsp;&nbsp;&nbsp;&nbsp;</code> 
      <code>HHUserInfoTaskErrorNotExistUserId&nbsp;=&nbsp;1001,</code> 
      <code>//用户不存在</code> 
     </div> 
     <div> 
      <code>&nbsp;&nbsp;&nbsp;&nbsp;</code> 
      <code>HHUserInfoTaskError1,</code> 
      <code>//瞎写的,&nbsp;意思到就行</code> 
     </div> 
     <div> 
      <code>&nbsp;&nbsp;&nbsp;&nbsp;</code> 
      <code>HHUserInfoTaskError2</code> 
     </div> 
     <div> 
      <code>}&nbsp;HHUserInfoTaskError;</code> 
     </div> 
     <div>
       &nbsp; 
     </div> 
     <div> 
      <code>typedef&nbsp;enum&nbsp;:&nbsp;NSUInteger&nbsp;{ </code> 
     </div> 
     <div> 
      <code>&nbsp;&nbsp;&nbsp;&nbsp;</code> 
      <code>HHUserFriendListTaskError0&nbsp;=&nbsp;1001,</code> 
     </div> 
     <div> 
      <code>&nbsp;&nbsp;&nbsp;&nbsp;</code> 
      <code>HHUserFriendListTaskError1,</code> 
     </div> 
     <div> 
      <code>&nbsp;&nbsp;&nbsp;&nbsp;</code> 
      <code>HHUserFriendListTaskError2,</code> 
     </div> 
     <div> 
      <code>}&nbsp;HHTopicListTaskError;</code> 
     </div> 
    </div></td> 
  </tr> 
 </tbody> 
</table>

然后调用方一般情况下只需要这样:

<table> 
 <tbody> 
  <tr> 
   <td> 
    <div>
      1 
    </div> 
    <div>
      2 
    </div> 
    <div>
      3 
    </div></td> 
   <td> 
    <div> 
     <div> 
      <code>[[HHTopicAPIManager&nbsp;</code> 
      <code>new</code> 
      <code>]&nbsp;fetchUserInfoWithUserId:123&nbsp;completionHandler:^(NSError&nbsp;*error,&nbsp;id&nbsp;result)&nbsp;{ </code> 
     </div> 
     <div> 
      <code>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</code> 
      <code>error&nbsp;?&nbsp;[self&nbsp;showToastWithText:error.domain]&nbsp;:&nbsp;[self&nbsp;reloadTableViewWithNames:result];</code> 
     </div> 
     <div> 
      <code>&nbsp;&nbsp;&nbsp;&nbsp;</code> 
      <code>}];</code> 
     </div> 
    </div></td> 
  </tr> 
 </tbody> 
</table>

当然, 情况复杂的话只能这样, 代码多一点, 但是有枚举读起来也不麻烦:

这里多扯两句, 请求的回调我是以(error, id)的形式返回的, 而不是像AFN那样分别给出successBlock和failBlock. 其实我本身是很支持AFN的做法的, 区分成功和错误强行让两种业务的代码出现在两个不同的部分, 这很好, 不同的业务处理就该在不同函数/方法里面. 但是实际开发中有很多成功和失败都会执行的操作, 典型的例子就是HUD, 两个block的话我需要在两个地方都加上\[HUD hide\], 这样的代码写的多了就会很烦, 而我又懒, 所以就成功失败都在一个回调返回了.

但是! 你也应该区分不同的业务写出两个不同方法(像上面那样做), 至于公用的部分就只写一次就够了.像这样:

<table> 
 <tbody> 
  <tr> 
   <td> 
    <div>
      1 
    </div> 
    <div>
      2 
    </div> 
    <div>
      3 
    </div> 
    <div>
      4 
    </div> 
    <div>
      5 
    </div></td> 
   <td> 
    <div> 
     <div> 
      <code>[hud&nbsp;show:YES];</code> 
     </div> 
     <div> 
      <code>[[HHTopicAPIManager&nbsp;</code> 
      <code>new</code> 
      <code>]&nbsp;fetchUserInfoWithUserId:123&nbsp;completionHandler:^(NSError&nbsp;*error,&nbsp;id&nbsp;result)&nbsp;{ </code> 
     </div> 
     <div> 
      <code>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</code> 
      <code>[hud&nbsp;hide:YES];</code> 
     </div> 
     <div> 
      <code>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</code> 
      <code>error&nbsp;?&nbsp;[self&nbsp;showToastWithText:error.domain]&nbsp;:&nbsp;[self&nbsp;reloadTableViewWithNames:result];</code> 
     </div> 
     <div> 
      <code>&nbsp;&nbsp;&nbsp;&nbsp;</code> 
      <code>}];</code> 
     </div> 
    </div></td> 
  </tr> 
 </tbody> 
</table>

再说一句, 即使你比我还懒, 不声明两个方法那也应该将较短的逻辑写在前面, 较长的写在后面, 易读, 像这样:

**4.两个小玩意儿**

文章到这基本上这个网络层该说的都说的差不多了, 各位可以根据自己的需求改动改动就能用了, 最后简单介绍下两个和它相关的小玩意儿就结尾吧:

*  HHNetworkTaskGroup

<table> 
 <tbody> 
  <tr> 
   <td> 
    <div>
      1 
    </div> 
    <div>
      2 
    </div> 
    <div>
      3 
    </div> 
    <div>
      4 
    </div> 
    <div>
      5 
    </div> 
    <div>
      6 
    </div> 
    <div>
      7 
    </div> 
    <div>
      8 
    </div> 
    <div>
      9 
    </div> 
    <div>
      10 
    </div> 
    <div>
      11 
    </div> 
    <div>
      12 
    </div> 
    <div>
      13 
    </div> 
    <div>
      14 
    </div> 
    <div>
      15 
    </div> 
    <div>
      16 
    </div> 
    <div>
      17 
    </div> 
    <div>
      18 
    </div> 
    <div>
      19 
    </div> 
    <div>
      20 
    </div> 
    <div>
      21 
    </div> 
    <div>
      22 
    </div> 
    <div>
      23 
    </div> 
    <div>
      24 
    </div> 
    <div>
      25 
    </div> 
    <div>
      26 
    </div> 
    <div>
      27 
    </div> 
    <div>
      28 
    </div> 
    <div>
      29 
    </div> 
    <div>
      30 
    </div> 
    <div>
      31 
    </div> 
    <div>
      32 
    </div> 
    <div>
      33 
    </div> 
    <div>
      34 
    </div> 
    <div>
      35 
    </div> 
    <div>
      36 
    </div> 
    <div>
      37 
    </div> 
    <div>
      38 
    </div> 
    <div>
      39 
    </div> 
    <div>
      40 
    </div> 
    <div>
      41 
    </div> 
    <div>
      42 
    </div> 
    <div>
      43 
    </div> 
    <div>
      44 
    </div> 
    <div>
      45 
    </div> 
    <div>
      46 
    </div> 
    <div>
      47 
    </div> 
    <div>
      48 
    </div> 
    <div>
      49 
    </div> 
    <div>
      50 
    </div> 
    <div>
      51 
    </div> 
    <div>
      52 
    </div> 
    <div>
      53 
    </div> 
    <div>
      54 
    </div> 
    <div>
      55 
    </div> 
    <div>
      56 
    </div> 
    <div>
      57 
    </div> 
    <div>
      58 
    </div> 
    <div>
      59 
    </div> 
    <div>
      60 
    </div> 
    <div>
      61 
    </div> 
    <div>
      62 
    </div> 
    <div>
      63 
    </div> 
    <div>
      64 
    </div> 
    <div>
      65 
    </div> 
    <div>
      66 
    </div> 
    <div>
      67 
    </div> 
    <div>
      68 
    </div> 
    <div>
      69 
    </div> 
    <div>
      70 
    </div> 
    <div>
      71 
    </div> 
    <div>
      72 
    </div> 
    <div>
      73 
    </div> 
    <div>
      74 
    </div> 
    <div>
      75 
    </div> 
    <div>
      76 
    </div> 
    <div>
      77 
    </div> 
    <div>
      78 
    </div> 
    <div>
      79 
    </div> 
    <div>
      80 
    </div> 
    <div>
      81 
    </div> 
    <div>
      82 
    </div> 
    <div>
      83 
    </div> 
    <div>
      84 
    </div> 
    <div>
      85 
    </div> 
    <div>
      86 
    </div> 
    <div>
      87 
    </div> 
    <div>
      88 
    </div> 
    <div>
      89 
    </div> 
    <div>
      90 
    </div> 
    <div>
      91 
    </div> 
    <div>
      92 
    </div> 
    <div>
      93 
    </div> 
    <div>
      94 
    </div> 
    <div>
      95 
    </div> 
    <div>
      96 
    </div> 
    <div>
      97 
    </div> 
    <div>
      98 
    </div> 
    <div>
      99 
    </div> 
    <div>
      100 
    </div></td> 
   <td> 
    <div> 
     <div> 
      <code>@interface&nbsp;HHNetworkTaskGroup&nbsp;()</code> 
     </div> 
     <div>
       &nbsp; 
     </div> 
     <div> 
      <code>@property&nbsp;(copy,&nbsp;nonatomic)&nbsp;void(^notifHandler)(void);</code> 
     </div> 
     <div> 
      <code>@property&nbsp;(assign,&nbsp;nonatomic)&nbsp;NSInteger&nbsp;signal;</code> 
     </div> 
     <div> 
      <code>@property&nbsp;(strong,&nbsp;nonatomic)&nbsp;NSMutableSet&nbsp;*tasks;</code> 
     </div> 
     <div> 
      <code>@property&nbsp;(strong,&nbsp;nonatomic)&nbsp;dispatch_semaphore_t&nbsp;lock;</code> 
     </div> 
     <div>
       &nbsp; 
     </div> 
     <div> 
      <code>@property&nbsp;(strong,&nbsp;nonatomic)&nbsp;id&nbsp;keeper;</code> 
     </div> 
     <div>
       &nbsp; 
     </div> 
     <div> 
      <code>@end</code> 
     </div> 
     <div>
       &nbsp; 
     </div> 
     <div> 
      <code>@implementation&nbsp;HHNetworkTaskGroup</code> 
     </div> 
     <div>
       &nbsp; 
     </div> 
     <div> 
      <code>//-&nbsp;(void)addTaskWithMessgeType:(HHSocketMessageType)type&nbsp;message:(PBGeneratedMessage&nbsp;*)message&nbsp;completionHandler:(HHNetworkCompletionHandler)completionHandler&nbsp;{ </code> 
     </div> 
     <div> 
      <code>//&nbsp;&nbsp;&nbsp;&nbsp;</code> 
     </div> 
     <div> 
      <code>//&nbsp;&nbsp;&nbsp;&nbsp;HHSocketTask&nbsp;*task&nbsp;=&nbsp;[[HHSocketManager&nbsp;sharedManager]&nbsp;taskWithMessgeType:type&nbsp;message:message&nbsp;completionHandler:completionHandler];</code> 
     </div> 
     <div> 
      <code>//&nbsp;&nbsp;&nbsp;&nbsp;[self&nbsp;addTask:task];</code> 
     </div> 
     <div> 
      <code>//}</code> 
     </div> 
     <div>
       &nbsp; 
     </div> 
     <div> 
      <code>-&nbsp;(void)addTask:(id)task&nbsp;{ </code> 
     </div> 
     <div> 
      <code>&nbsp;&nbsp;&nbsp;&nbsp;</code>&nbsp; 
     </div> 
     <div> 
      <code>&nbsp;&nbsp;&nbsp;&nbsp;</code> 
      <code>if</code>&nbsp; 
      <code>([task&nbsp;respondsToSelector:@selector(cancel)]&nbsp;&amp;&amp;</code> 
     </div> 
     <div> 
      <code>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</code> 
      <code>[task&nbsp;respondsToSelector:@selector(resume)]&nbsp;&amp;&amp;</code> 
     </div> 
     <div> 
      <code>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</code> 
      <code>![self.tasks&nbsp;containsObject:task])&nbsp;{ </code> 
     </div> 
     <div> 
      <code>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</code>&nbsp; 
     </div> 
     <div> 
      <code>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</code> 
      <code>[self.tasks&nbsp;addObject:task];</code> 
     </div> 
     <div> 
      <code>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</code> 
      <code>[(id)task&nbsp;addObserver:self&nbsp;forKeyPath:NSStringFromSelector(@selector(state))&nbsp;options:NSKeyValueObservingOptionOld&nbsp;|&nbsp;NSKeyValueObservingOptionNew&nbsp;context:nil];</code> 
     </div> 
     <div> 
      <code>&nbsp;&nbsp;&nbsp;&nbsp;</code> 
      <code>}</code> 
     </div> 
     <div> 
      <code>}</code> 
     </div> 
     <div>
       &nbsp; 
     </div> 
     <div> 
      <code>-&nbsp;(void)dispatchWithNotifHandler:(void&nbsp;(^)(void))notifHandler&nbsp;{ </code> 
     </div> 
     <div> 
      <code>&nbsp;&nbsp;&nbsp;&nbsp;</code>&nbsp; 
     </div> 
     <div> 
      <code>&nbsp;&nbsp;&nbsp;&nbsp;</code> 
      <code>if</code>&nbsp; 
      <code>(self.tasks.count&nbsp;==&nbsp;0)&nbsp;{ </code> 
     </div> 
     <div> 
      <code>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</code>&nbsp; 
     </div> 
     <div> 
      <code>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</code> 
      <code>dispatch_async(dispatch_get_main_queue(),&nbsp;^{ </code> 
     </div> 
     <div> 
      <code>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</code> 
      <code>notifHandler&nbsp;?&nbsp;notifHandler()&nbsp;:&nbsp;nil;</code> 
     </div> 
     <div> 
      <code>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</code> 
      <code>});</code> 
     </div> 
     <div> 
      <code>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</code> 
      <code>return</code> 
      <code>;</code> 
     </div> 
     <div> 
      <code>&nbsp;&nbsp;&nbsp;&nbsp;</code> 
      <code>}</code> 
     </div> 
     <div> 
      <code>&nbsp;&nbsp;&nbsp;&nbsp;</code>&nbsp; 
     </div> 
     <div> 
      <code>&nbsp;&nbsp;&nbsp;&nbsp;</code> 
      <code>self.lock&nbsp;=&nbsp;dispatch_semaphore_create(1);</code> 
     </div> 
     <div> 
      <code>&nbsp;&nbsp;&nbsp;&nbsp;</code> 
      <code>self.keeper&nbsp;=&nbsp;self;</code> 
     </div> 
     <div> 
      <code>&nbsp;&nbsp;&nbsp;&nbsp;</code> 
      <code>self.signal&nbsp;=&nbsp;self.tasks.count;</code> 
     </div> 
     <div> 
      <code>&nbsp;&nbsp;&nbsp;&nbsp;</code> 
      <code>self.notifHandler&nbsp;=&nbsp;notifHandler;</code> 
     </div> 
     <div> 
      <code>&nbsp;&nbsp;&nbsp;&nbsp;</code> 
      <code>for</code>&nbsp; 
      <code>(idtask&nbsp;</code> 
      <code>in</code>&nbsp; 
      <code>self.tasks.allObjects)&nbsp;{ </code> 
     </div> 
     <div> 
      <code>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</code> 
      <code>[task&nbsp;resume];</code> 
     </div> 
     <div> 
      <code>&nbsp;&nbsp;&nbsp;&nbsp;</code> 
      <code>}</code> 
     </div> 
     <div> 
      <code>}</code> 
     </div> 
     <div>
       &nbsp; 
     </div> 
     <div> 
      <code>-&nbsp;(void)cancel&nbsp;{ </code> 
     </div> 
     <div> 
      <code>&nbsp;&nbsp;&nbsp;&nbsp;</code>&nbsp; 
     </div> 
     <div> 
      <code>&nbsp;&nbsp;&nbsp;&nbsp;</code> 
      <code>for</code>&nbsp; 
      <code>(idtask&nbsp;</code> 
      <code>in</code>&nbsp; 
      <code>self.tasks.allObjects)&nbsp;{ </code> 
     </div> 
     <div> 
      <code>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</code>&nbsp; 
     </div> 
     <div> 
      <code>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</code> 
      <code>if</code>&nbsp; 
      <code>([(id)task&nbsp;state]&nbsp;&lt;&nbsp;NSURLSessionTaskStateCanceling)&nbsp;{ </code> 
     </div> 
     <div> 
      <code>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</code>&nbsp; 
     </div> 
     <div> 
      <code>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</code> 
      <code>[(id)task&nbsp;removeObserver:self&nbsp;forKeyPath:NSStringFromSelector(@selector(state))];</code> 
     </div> 
     <div> 
      <code>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</code> 
      <code>[task&nbsp;cancel];</code> 
     </div> 
     <div> 
      <code>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</code> 
      <code>}</code> 
     </div> 
     <div> 
      <code>&nbsp;&nbsp;&nbsp;&nbsp;</code> 
      <code>}</code> 
     </div> 
     <div> 
      <code>&nbsp;&nbsp;&nbsp;&nbsp;</code> 
      <code>[self.tasks&nbsp;removeAllObjects];</code> 
     </div> 
     <div> 
      <code>&nbsp;&nbsp;&nbsp;&nbsp;</code> 
      <code>self.keeper&nbsp;=&nbsp;nil;</code> 
     </div> 
     <div> 
      <code>}</code> 
     </div> 
     <div>
       &nbsp; 
     </div> 
     <div> 
      <code>#pragma&nbsp;mark&nbsp;-&nbsp;KVO</code> 
     </div> 
     <div>
       &nbsp; 
     </div> 
     <div> 
      <code>-&nbsp;(void)observeValueForKeyPath:(NSString&nbsp;*)keyPath&nbsp;ofObject:(id)object&nbsp;change:(NSDictionary*)change&nbsp;context:(void&nbsp;*)context&nbsp;{ </code> 
     </div> 
     <div> 
      <code>&nbsp;&nbsp;&nbsp;&nbsp;</code> 
      <code>if</code>&nbsp; 
      <code>([keyPath&nbsp;isEqualToString:NSStringFromSelector(@selector(state))])&nbsp;{ </code> 
     </div> 
     <div> 
      <code>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</code>&nbsp; 
     </div> 
     <div> 
      <code>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</code> 
      <code>NSURLSessionTaskState&nbsp;oldState&nbsp;=&nbsp;[change[NSKeyValueChangeOldKey]&nbsp;integerValue];</code> 
     </div> 
     <div> 
      <code>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</code> 
      <code>NSURLSessionTaskState&nbsp;newState&nbsp;=&nbsp;[change[NSKeyValueChangeNewKey]&nbsp;integerValue];</code> 
     </div> 
     <div> 
      <code>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</code> 
      <code>if</code>&nbsp; 
      <code>(oldState&nbsp;!=&nbsp;newState&nbsp;&amp;&amp;&nbsp;newState&nbsp;&gt;=&nbsp;NSURLSessionTaskStateCanceling)&nbsp;{ </code> 
     </div> 
     <div> 
      <code>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</code> 
      <code>[object&nbsp;removeObserver:self&nbsp;forKeyPath:NSStringFromSelector(@selector(state))];</code> 
     </div> 
     <div> 
      <code>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</code>&nbsp; 
     </div> 
     <div> 
      <code>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</code> 
      <code>dispatch_semaphore_wait(self.lock,&nbsp;DISPATCH_TIME_FOREVER);</code> 
     </div> 
     <div> 
      <code>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</code> 
      <code>self.signal--;</code> 
     </div> 
     <div> 
      <code>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</code> 
      <code>dispatch_semaphore_signal(self.lock);</code> 
     </div> 
     <div>
       &nbsp; 
     </div> 
     <div> 
      <code>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</code> 
      <code>if</code>&nbsp; 
      <code>(self.signal&nbsp;==&nbsp;0)&nbsp;{ </code> 
     </div> 
     <div> 
      <code>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</code>&nbsp; 
     </div> 
     <div> 
      <code>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</code> 
      <code>dispatch_after(dispatch_time(DISPATCH_TIME_NOW,&nbsp;(int64_t)(0.1&nbsp;*&nbsp;NSEC_PER_SEC)),&nbsp;dispatch_get_main_queue(),&nbsp;^{ </code> 
     </div> 
     <div> 
      <code>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</code>&nbsp; 
     </div> 
     <div> 
      <code>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</code> 
      <code>self.notifHandler&nbsp;?&nbsp;self.notifHandler()&nbsp;:&nbsp;nil;</code> 
     </div> 
     <div> 
      <code>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</code> 
      <code>[self.tasks&nbsp;removeAllObjects];</code> 
     </div> 
     <div> 
      <code>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</code> 
      <code>self.keeper&nbsp;=&nbsp;nil;</code> 
     </div> 
     <div> 
      <code>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</code> 
      <code>});</code> 
     </div> 
     <div> 
      <code>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</code> 
      <code>}</code> 
     </div> 
     <div> 
      <code>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</code> 
      <code>}</code> 
     </div> 
     <div> 
      <code>&nbsp;&nbsp;&nbsp;&nbsp;</code> 
      <code>}</code> 
     </div> 
     <div> 
      <code>}</code> 
     </div> 
     <div>
       &nbsp; 
     </div> 
     <div> 
      <code>#pragma&nbsp;mark&nbsp;-&nbsp;Getter</code> 
     </div> 
     <div>
       &nbsp; 
     </div> 
     <div> 
      <code>-&nbsp;(NSMutableSet&nbsp;*)tasks&nbsp;{ </code> 
     </div> 
     <div> 
      <code>&nbsp;&nbsp;&nbsp;&nbsp;</code> 
      <code>if</code>&nbsp; 
      <code>(!_tasks)&nbsp;{ </code> 
     </div> 
     <div> 
      <code>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</code> 
      <code>_tasks&nbsp;=&nbsp;[NSMutableSet&nbsp;set];</code> 
     </div> 
     <div> 
      <code>&nbsp;&nbsp;&nbsp;&nbsp;</code> 
      <code>}</code> 
     </div> 
     <div> 
      <code>&nbsp;&nbsp;&nbsp;&nbsp;</code> 
      <code>return</code>&nbsp; 
      <code>_tasks;</code> 
     </div> 
     <div> 
      <code>}</code> 
     </div> 
     <div>
       &nbsp; 
     </div> 
     <div> 
      <code>@end</code> 
     </div> 
    </div></td> 
  </tr> 
 </tbody> 
</table>

看名字应该就知道这个是和dispatch\_group\_notif差不多的东西, 不过是派发的对象不是dispatch\_block\_t而是id. 代码很简单, 说说思路就行了.

*  keeper

系统大部分带有Block的API都有一个特性就是只需要生成不需要持有, 也不用担心Block持有我们的对象而造成循环引用, 例如:dispatch\_async, dataTaskWithURL:completionHandler:等等, 其实具体的实现就是先循环引用再破除循环引用, 比如dispatch\_async的queue和block会循环引用, 这样在block执行期间双方都不会释放, 然后等到block执行完成后再将queue.block置nil破除循环引用, block没了, 那它捕获的queue和其他对象计数都能-1,也就都能正常释放了.代码里面的keeper就是来制造这个循环引用的.

*  signal和tasks

signal其实就是tasks.count, 为什么我们不直接在task完成后直接tasks.remove然后判断tasks.count == 0而是要间接给一个signal来做这事儿?

原因很简单: forin过程中是不能改变容器对象的. 当我们forin派发task的时候, task是异步执行的, 有可能在task执行完成触发KVO的时候我们的forin还在遍历, 此时直接remove就会crash. 如果不用forin, 而是用while或者for(;;)就会漏发. 所以就声明一个signal来做计数了. 另外addObserve和removeObserve必须成对出现, 控制好就行.

*  dispatch\_after

在所有任务执行完成后并没有马上执行notif(), 而是等待0.1秒以后再执行notif(), 这是因为task.state的设置会在task.completionHandler之前执行, 所以我们需要等一下, 确认completionHandler执行后在走我们的notif().

*  如何使用

<table> 
 <tbody> 
  <tr> 
   <td> 
    <div>
      1 
    </div> 
    <div>
      2 
    </div> 
    <div>
      3 
    </div> 
    <div>
      4 
    </div> 
    <div>
      5 
    </div> 
    <div>
      6 
    </div> 
    <div>
      7 
    </div> 
    <div>
      8 
    </div> 
    <div>
      9 
    </div> 
    <div>
      10 
    </div> 
    <div>
      11 
    </div> 
    <div>
      12 
    </div> 
    <div>
      13 
    </div></td> 
   <td> 
    <div> 
     <div> 
      <code>&nbsp;&nbsp;&nbsp;&nbsp;</code> 
      <code>HHNetworkTaskGroup&nbsp;*group&nbsp;=&nbsp;[HHNetworkTaskGroup&nbsp;</code> 
      <code>new</code> 
      <code>];</code> 
     </div> 
     <div> 
      <code>&nbsp;&nbsp;&nbsp;&nbsp;</code> 
      <code>HHTopicAPIManager&nbsp;*manager&nbsp;=&nbsp;[HHTopicAPIManager&nbsp;</code> 
      <code>new</code> 
      <code>];</code> 
     </div> 
     <div> 
      <code>&nbsp;&nbsp;&nbsp;&nbsp;</code> 
      <code>for</code>&nbsp; 
      <code>(int&nbsp;i&nbsp;=&nbsp;1;&nbsp;i&nbsp;&lt;&nbsp;6;&nbsp;i++)&nbsp;{ </code> 
     </div> 
     <div> 
      <code>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</code>&nbsp; 
     </div> 
     <div> 
      <code>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</code> 
      <code>NSURLSessionDataTask&nbsp;*task&nbsp;=&nbsp;[manager&nbsp;topicListDataTaskWithPage:i&nbsp;pageSize:20&nbsp;completionHandler:^(NSError&nbsp;*error,&nbsp;id&nbsp;result)&nbsp;{ </code> 
     </div> 
     <div> 
      <code>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</code> 
      <code>//...completionHandler...&nbsp;i</code> 
     </div> 
     <div> 
      <code>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</code> 
      <code>}];</code> 
     </div> 
     <div> 
      <code>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</code>&nbsp; 
     </div> 
     <div> 
      <code>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</code> 
      <code>[group&nbsp;addTask:(id)task];</code> 
     </div> 
     <div> 
      <code>&nbsp;&nbsp;&nbsp;&nbsp;</code> 
      <code>}</code> 
     </div> 
     <div> 
      <code>&nbsp;&nbsp;&nbsp;&nbsp;</code> 
      <code>[group&nbsp;dispatchWithNotifHandler:^{ </code> 
     </div> 
     <div> 
      <code>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</code> 
      <code>//notifHandler</code> 
     </div> 
     <div> 
      <code>&nbsp;&nbsp;&nbsp;&nbsp;</code> 
      <code>}];</code> 
     </div> 
    </div></td> 
  </tr> 
 </tbody> 
</table>

强调一下, 绝对不应该直接调用HHNetworkClient或者HHAPIManger的dataTaskxxx…这些通用接口来生成task, 应该在该task所属的API暴露接口生成task, 简单说就是不要跨层访问. 每个API的参数甚至签名规则都是不一样的, API的调用方应该只提供生成task的相应参数而不应该也不需要知道这些参数具体的拼装逻辑.

*  HHNetworkAPIRecorder

<table> 
 <tbody> 
  <tr> 
   <td> 
    <div>
      1 
    </div> 
    <div>
      2 
    </div> 
    <div>
      3 
    </div> 
    <div>
      4 
    </div> 
    <div>
      5 
    </div> 
    <div>
      6 
    </div> 
    <div>
      7 
    </div> 
    <div>
      8 
    </div> 
    <div>
      9 
    </div> 
    <div>
      10 
    </div> 
    <div>
      11 
    </div> 
    <div>
      12 
    </div></td> 
   <td> 
    <div> 
     <div> 
      <code>@interface&nbsp;HHNetworkAPIRecorder&nbsp;:&nbsp;NSObject</code> 
     </div> 
     <div>
       &nbsp; 
     </div> 
     <div> 
      <code>@property&nbsp;(strong,&nbsp;nonatomic)&nbsp;id&nbsp;rawValue;</code> 
     </div> 
     <div> 
      <code>@property&nbsp;(assign,&nbsp;nonatomic)&nbsp;int&nbsp;pageSize;</code> 
     </div> 
     <div> 
      <code>@property&nbsp;(assign,&nbsp;nonatomic)&nbsp;int&nbsp;currentPage;</code> 
     </div> 
     <div> 
      <code>@property&nbsp;(assign,&nbsp;nonatomic)&nbsp;NSInteger&nbsp;itemsCount;</code> 
     </div> 
     <div> 
      <code>@property&nbsp;(assign,&nbsp;nonatomic)&nbsp;NSInteger&nbsp;lastRequestTime;</code> 
     </div> 
     <div>
       &nbsp; 
     </div> 
     <div> 
      <code>-&nbsp;(void)reset;</code> 
     </div> 
     <div> 
      <code>-&nbsp;(BOOL)hasMoreData;</code> 
     </div> 
     <div> 
      <code>-&nbsp;(NSInteger)maxPage;</code> 
     </div> 
     <div> 
      <code>@end</code> 
     </div> 
    </div></td> 
  </tr> 
 </tbody> 
</table>

日常请求中有很多接口涉及到分页, 然而毫无疑问分页的逻辑在每个页面都是一模一样的, 但是却需要每个调用页面都保持一下currentPage然后调用逻辑都写一次, 其实直接在API内部实现一下分页的逻辑, 然后对外暴露第一页和下一页的接口就不用声明currentPage和重复这些无聊的逻辑了. 像这样:

<table> 
 <tbody> 
  <tr> 
   <td> 
    <div>
      1 
    </div> 
    <div>
      2 
    </div> 
    <div>
      3 
    </div> 
    <div>
      4 
    </div></td> 
   <td> 
    <div> 
     <div> 
      <code>//XXXAPI.h</code> 
     </div> 
     <div> 
      <code>-&nbsp;(NSNumber&nbsp;*)refreshTopicListWithCompletionHandler:(HHNetworkTaskCompletionHander)completionHandler;</code> 
      <code>//第一页</code> 
     </div> 
     <div> 
      <code>-&nbsp;(NSNumber&nbsp;*)loadmoreTopicListWithCompletionHandler:(HHNetworkTaskCompletionHander)completionHandler;</code> 
      <code>//当前页的下一页</code> 
     </div> 
     <div> 
      <code>-&nbsp;(NSNumber&nbsp;*)fetchTopicListWithPage:(NSInteger)page&nbsp;completionHandler:(HHNetworkTaskCompletionHander)completionHandler;</code> 
      <code>//指定页(一般外部用不到,&nbsp;看情况暴露)</code> 
     </div> 
    </div></td> 
  </tr> 
 </tbody> 
</table>

<table> 
 <tbody> 
  <tr> 
   <td> 
    <div>
      1 
    </div> 
    <div>
      2 
    </div> 
    <div>
      3 
    </div> 
    <div>
      4 
    </div> 
    <div>
      5 
    </div> 
    <div>
      6 
    </div> 
    <div>
      7 
    </div> 
    <div>
      8 
    </div> 
    <div>
      9 
    </div> 
    <div>
      10 
    </div> 
    <div>
      11 
    </div> 
    <div>
      12 
    </div></td> 
   <td> 
    <div> 
     <div> 
      <code>//XXXAPI.m</code> 
     </div> 
     <div> 
      <code>-&nbsp;(NSNumber&nbsp;*)refreshTopicListWithCompletionHandler:(HHNetworkTaskCompletionHander)completionHandler&nbsp;{ </code> 
     </div> 
     <div> 
      <code>&nbsp;&nbsp;&nbsp;</code>&nbsp; 
     </div> 
     <div> 
      <code>&nbsp;&nbsp;&nbsp;&nbsp;</code> 
      <code>[self.topicListAPIRecorder&nbsp;reset];</code> 
     </div> 
     <div> 
      <code>&nbsp;&nbsp;&nbsp;&nbsp;</code> 
      <code>return</code>&nbsp; 
      <code>[self&nbsp;fetchTopicListWithPage:self.topicListAPIRecorder.currentPage&nbsp;completionHandler:completionHandler];</code> 
     </div> 
     <div> 
      <code>}</code> 
     </div> 
     <div>
       &nbsp; 
     </div> 
     <div> 
      <code>-&nbsp;(NSNumber&nbsp;*)loadmoreTopicListWithCompletionHandler:(HHNetworkTaskCompletionHander)completionHandler&nbsp;{ </code> 
     </div> 
     <div> 
      <code>&nbsp;&nbsp;&nbsp;</code>&nbsp; 
     </div> 
     <div> 
      <code>&nbsp;&nbsp;&nbsp;&nbsp;</code> 
      <code>self.topicListAPIRecorder.currentPage++;</code> 
     </div> 
     <div> 
      <code>&nbsp;&nbsp;&nbsp;&nbsp;</code> 
      <code>return</code>&nbsp; 
      <code>[self&nbsp;fetchTopicListWithPage:self.topicListAPIRecorder.currentPage&nbsp;completionHandler:completionHandler];</code> 
     </div> 
     <div> 
      <code>}</code> 
     </div> 
    </div></td> 
  </tr> 
 </tbody> 
</table>

<table> 
 <tbody> 
  <tr> 
   <td> 
    <div>
      1 
    </div> 
    <div>
      2 
    </div> 
    <div>
      3 
    </div> 
    <div>
      4 
    </div> 
    <div>
      5 
    </div> 
    <div>
      6 
    </div> 
    <div>
      7 
    </div> 
    <div>
      8 
    </div> 
    <div>
      9 
    </div> 
    <div>
      10 
    </div> 
    <div>
      11 
    </div> 
    <div>
      12 
    </div> 
    <div>
      13 
    </div></td> 
   <td> 
    <div> 
     <div> 
      <code>//SomeViewController</code> 
     </div> 
     <div> 
      <code>self.topicAPIManager&nbsp;=&nbsp;[HHTopicAPIManager&nbsp;</code> 
      <code>new</code> 
      <code>];</code> 
     </div> 
     <div> 
      <code>...</code> 
     </div> 
     <div> 
      <code>self.tableView.header&nbsp;=&nbsp;[MJRefreshNormalHeader&nbsp;headerWithRefreshingBlock:^{ </code> 
      <code>//下拉刷新</code> 
     </div> 
     <div> 
      <code>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</code> 
      <code>[weakSelf.topicAPIManager&nbsp;refreshTopicListWithCompletionHandler:^(NSError&nbsp;*error,&nbsp;id&nbsp;result)&nbsp;{ </code> 
     </div> 
     <div> 
      <code>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</code> 
      <code>...</code> 
     </div> 
     <div> 
      <code>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</code> 
      <code>}];</code> 
     </div> 
     <div> 
      <code>&nbsp;&nbsp;&nbsp;&nbsp;</code> 
      <code>}];</code> 
     </div> 
     <div> 
      <code>self.tableView.footer&nbsp;=&nbsp;[MJRefreshAutoNormalFooter&nbsp;footerWithRefreshingBlock:^{ </code> 
      <code>//上拉加载</code> 
     </div> 
     <div> 
      <code>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</code> 
      <code>[weakSelf.topicAPIManager&nbsp;loadmoreTopicListWithCompletionHandler:^(NSError&nbsp;*error,&nbsp;id&nbsp;result)&nbsp;{ </code> 
     </div> 
     <div> 
      <code>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</code> 
      <code>...</code> 
     </div> 
     <div> 
      <code>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</code> 
      <code>}];</code> 
     </div> 
     <div> 
      <code>&nbsp;&nbsp;&nbsp;&nbsp;</code> 
      <code>}];</code> 
     </div> 
    </div></td> 
  </tr> 
 </tbody> 
</table>

**总结**

HHURLRequestGenerator: 网络请求的生成器, 公用的请求头, cookie都在此设置.

HHNetworkClient: 网络请求的派发器, 这里会记录每一个服役中的请求, 并在必要的时候切换服务器.

HHAPIManager: 网络请求派发器的调用者, 这里对请求的结果做相应的数据格式化后返回给API调用方, 提供请求模块的拓展性支持, 并提供合理的Task供TaskGroup派发.

本文附带的demo地址：[https://github.com/HeiHuaBaiHua/TAFNetworking][https_github.com_HeiHuaBaiHua_TAFNetworking]

</div>

[https_github.com_HeiHuaBaiHua_TAFNetworking]: https://github.com/HeiHuaBaiHua/TAFNetworking