usr/include/dispatch

博文一部分摘自：Parse分析，以下简称博文1(LeanCloud工程师针对Parse使用GCD的分析)
博文一部分摘自：GCD入门，以下简称博文2
建议先了解一下：BSD基础知识

在`Dispatch/source.h`中是这样描述Dispatch Source####

The dispatch framework provides a suite of Interfaces for monitoring low-level system objects (file descriptions , Mach Ports , signals , VFS nodes , etc.) 
for activity and automatically submitting event handler blocks to dispatch queues when such activity occurs.

The suite of interfaces is known as the Dispatch Source API

abstract:
Dispatch Source are used to automatically submit event handler blocks to dispatch queues in response to external events.

简单来说####

Dispatch Source 是用来监听某些类型事件的对象，当这些事件发生时，Dispatch Source 自动把事件block放入到Dispatch queue的执行例程中。

Dispatch Source 监听的底层事件####

下面是GCD 10.6.0 版本支持的事件：

Mach port send right state changes.
Mach port receive right state changes.
External process state changes.
File descriptor ready for read.
File descriptor ready for write.
File system node event.
POSIX signal.
Custom timer.
Custom event.

这些事件支持所有kqueue支持的事件、mach端口、内建计时器支持(这样我们就不用使用timeout参数来创建自己的计时器)和用户事件。

如果对这些知识点不了解，可以看我对知识点的整理 - 知识点资料 3 ~ 6

一、 Custom event

博文1中说Dispatch Source比使用dispatch_async的优势在于利用合并。

合并：在任一thread调用它的一个函数dispatch_source_merge_data后，会执行Dispatch Source事先定义好的event handler（博主1认为是block）。

博文以总结说，联结的这个过程就称为 - Custom event(用户事件)。是dispatch source支持处理的一种事件。简单说，这种事件是由你调用dispatch_source_merge_data函数来向自己发送信号。

1.1 Dispatch Source 的使用步骤详情介绍点 - 这里###

创建一个 Dispatch Source
创建 Dispatch Source 的事件句柄
处理 Dispatch Source 的resume() 和 suspend() 操作。
向 Dispatch Source 发送事件。

1.1.1 创建一个 Dispatch Source

    dispatch_source_create(<#dispatch_source_type_t type#>,
                           <#uintptr_t handle#>,
                           <#unsigned long mask#>,
                           <#dispatch_queue_t queue#>);
    /** 参数1
     *  dispatch_source_type_t type
     *  需要监听的事件类型
     */
    /** 参数2
     *  uintptr_t handle 
     *  理解为 id、索引或句柄。假如要监听process，需要传入process的pId.
     */
    /** 参数3
     *  unsigned long mask
     *  根据参数2，理解为description、provide或detail description，让source知道具体要监听什么。
     */
    /** 参数4
     *  dispatch_queue_t queue
     *  当监听事件发生，将event_handle_block添加到这个queue来执行。
     */

dispatch_source_type_t type

    DISPATCH_SOURCE_TYPE_DATA_ADD;   //*> custom event, 自己定义事件，自己触发事件
    DISPATCH_SOURCE_TYPE_DATA_OR;    //*> custom event, 自己定义事件，自己触发事件
    DISPATCH_SOURCE_TYPE_MACH_SEND;  //*> Mach 相关‘发送’事件
    DISPATCH_SOURCE_TYPE_MACH_RECV;  //*> Mach 相关‘接收’事件
    DISPATCH_SOURCE_TYPE_READ;       //*> I/O 操作，对文件、socket操作的‘读’响应
    DISPATCH_SOURCE_TYPE_WRITE;      //*> I/O 操作，对文件、socket操纵的‘写’响应
    DISPATCH_SOURCE_TYPE_VNODE;      //*> 文件状态监听，文件被删除、移动、重命名
    DISPATCH_SOURCE_TYPE_PROC;       //*> 进程监听，如，进程的退出、创建1或多个进程、进程收到Unix信号
    DISPATCH_SOURCE_TYPE_TIMER;      //*> 定时响应
    DISPATCH_SOURCE_TYPE_SIGNAL;     //*> 接收Unix信号时的响应

创建一个dispatch_source_t source

dispatch_source_t customSourceMonitor = dispatch_source_create(DISPATCH_SOURCE_TYPE_DATA_ADD, 0, 0, dispatch_get_main_queue());

1.1.2 创建Dispatch_source_t 的event_handler_block###

    /**
     *  如果dispatch_source的监听类型:
     *  1.DISPATCH_SOURCE_TYPE_DATA_ADD
     *  2.DISPATCH_SOURCE_TYPE_DATA_OR
     *  这是Custom Event，自定定义Handler_Block，自己去触发Handler_Block
     */
    dispatch_source_set_event_handler(customSourceMonitor, ^{
       
        // TODO
        
    });

1.1.3 处理 Dispatch_source_t 的suspend 、 resume 操作。

初始化创建的Dispatch Source 默认是suspend。需要resume

    dispatch_resume(customSourceMonitor);
    dispatch_suspend(customSourceMonitor);

1.14 向 Dispatch_Source_t 发送事件

（下文2.1 详解）
resume Dispatch_Source_t 之后，可以通过 dispatch_source_merge_data 向 Dispatch_Source 发送event。

当dispatch_source_merge_data触发了handler_event 之后，dispatch_source_get_data(Dispatch_source_t source)就会自动清空成‘0’。

1.15 Custom Event 演示代码

    dispatch_source_t customSourceMonitor = dispatch_source_create(DISPATCH_SOURCE_TYPE_DATA_ADD, 0, 0, dispatch_get_main_queue());
    dispatch_resume(customSourceMonitor);
    
    __block int sum = 0;
    dispatch_source_set_event_handler(customSourceMonitor, ^{
       
        // ?TODO
        sum += dispatch_source_get_data(customSourceMonitor);
        NSLog(@"- %d",sum);
        
    });
    //4950
    dispatch_queue_t queue = dispatch_get_global_queue(DISPATCH_QUEUE_PRIORITY_DEFAULT, 0);
    for (NSUInteger i = 0; i < 1000; i ++) {
        dispatch_async(queue, ^{
            dispatch_source_merge_data(customSourceMonitor, i);
            
            usleep(20000); // 注释效果不同
        });
    }

二、如何使用Dispatch Source 达到 NSOperationQueue 的功能

2.1 Dispatch Source 如何通过merge的方式确保在高负载下正常工作

1.14 中通过调用dispatch_source_merge_data后所触发dispatch_source_set_event_handler的根据merge特性调用的频率会大大减少，有时候只调用一次handler。

为什么Dispatch Source 能通过 merge 方式确保在高负载下正常运行呢？

在同一时间，只有一个处理block的实例被分配，如果这个handler_block还没有执行完毕，另一个事件就发生了，事件会以指定的方式 (ADD 或 OR) 进行积累。

Dispatch Source 能通过merge事件确保在高负载下正常工作。当handler_event被执行的时，可以通过dispatch_source_get_data() 来获取计算后累加的数据。然后这个dispatch_source_get_data() 会被重置为‘0’。

2.2 Dispatch Source 与 Dispatch Queue 两者在线程执行上的关系

答：没有关系