GCD-4 Managing Dispatch Objects

本文是本人自己辛苦翻译的，请转载的朋友注明，翻译于Z.MJun的 ，感谢！<翻译不容易啊>

---

完成翻译于2016年5月18日

---

Managing Dispatch Objects管理调度对象

GCD提供了一些允许应用管理的接口。如内存管理，暂停，回复执行，定义对象，记录任务数据。调度对象必须是手动保留和手动释放，没有自动回收机制。

---

dispatch_debug

• 描述：以编程方式记录一个调度对象信息。
• 方法：void dispatch_debug( dispatch_object_t object, const char *message, ...)
• 参数：
  • object Object对象
  • message 这是Printf风格形式String。消息的内容以冒号分割
• 调试信息会记录到控制台信息里面。当对象使用dispatch_debug时候，这个信息很有用，就像使用调试工具来查看网络状态一样。

dispatch_get_context

• 描述：返回对象的默认内容
• 方法：void * dispatch_get_context( dispatch_object_t object)
• 参数：
  • object 这个参数也不能为NULL
• 对象可以在应用里关联一些用户的数据。您的应用需要适当的保留或者释放数据。

释放 dispatch_release

• 描述：释放调度对象。

• 方法：void dispatch_release( dispatch_object_t object)

• 参数：
  + object 对象会被释放，这个参数也不能为NULL

• 当所有引用被释放，这个调度对象就马上会异步的释放。这个引用计数变成0。当你的应用不再需要一个自己创建的调度对象，你需要调用这个方法来释放他，释放内存。需要注意的是，GCD不保证一个提供给客户端拥有最后或者唯一一个引用给对象。

  Important

  如果你的应用系统目标是OS X10.8及以上，或者IOS 6.0及以上，调度队列是使用ARC自动释放机制管理的，所以你不需要保留或者释放调度队列。
  为了更好地兼容已经存在的代码，这个是基础配置的。跟多细节在Dispatch Queues and Automatic Reference Counting

• 你的引用不需要保留和释放全局调度队列，如果在全局调度队列上使用这个方法是无效的

  Important

  平衡dispatch_suspend和dispatch_resume是很重要的。以至于调度对象当最后一个引用被被释放，所有的调度对象都会被完全恢复。当释放了最后的引用，调度对象的挂起状态会被解除。

恢复 dispatch_resume

• 描述：恢复一个调度对象
• 方法：void dispatch_resume( dispatch_object_t object)
• 参数：
  • object 这个对象将会被恢复，这个参数也不能为NULL
• 调用这个方法，会减少一个挂起的调度队列或者调度事件源对象的计数。知道计数大于0，这个对象才会继续挂起。当挂起的计数为0，任何调度队列或者任何调度源监控时间都会被挂起。
• 有一个例外，每个调用dispatch_resume必须平衡的使用dispatch_suspend。新的调度事件源对象返回，dispatch_source_create有一个挂起计数为1和在事件交付前必须恢复。这个方法允许你的应用完全配置调度事件源对象优先于第一个时间挂起。在其他事件里，没有定义dispatch_resume要比dispatch_suspend多，这将产生负的挂起计数。

保留 dispatch_retain

• 描述：保留一个调度对象
• 方法：void dispatch_retain( dispatch_object_t object)`
• 参数：
  • object 这个对象将会保留，这个参数也不能为NULL
• 调用这个方法，也需要调用dispatch_release。如果子多个系统使用到了这个调度对象，子系统就会使用dispatch_retain的方法来保留对象。这个对象只有当所有的子系统释放了，他才会被释放。
  值得注意的是，你的应用不需要管理（保留和释放）全局调度队列。

  Important

  如果你的应用系统目标是OS X10.8及以上，或者IOS 6.0及以上，调度队列是使用ARC自动释放机制管理的，所以你不需要保留或者释放调度队列。
  为了更好地兼容已经存在的代码，这个是基础配置的。跟多细节在Dispatch Queues and Automatic Reference Counting

dispatch_set_context

• 描述：关联一个配置信息到对象里
• 方法：void dispatch_set_context( dispatch_object_t object, void *context)
• 参数：
  • object 这个参数也不能为NULL
  • context 传给系统的内容参数，这个参数也不能为NULL
• 应用可以关联自定义内容给这个对象。你的应用必须适当的保留和释放这个数据。

dispatch_set_finalizer_f

• 描述：为调度对象设置终结器功能。
• 方法：void dispatch_set_finalizer_f( dispatch_object_t object, dispatch_function_t finalizer)
• 参数：
  • object 可修改的调度对象， 这个参数也不能为NULL
  • finalizer dispatch_function_t对象
• 当所有的引用对象被释后，调度对象就会调用这个方法。应用可以使用finalizer来释放任何关联对象的资源。

挂起 dispatch_suspend

• 描述：挂起一个调度对象。
• 方法：void dispatch_suspend( dispatch_object_t object)
• 参数：
  • object 将要挂起的对象， 这个参数也不能为NULL
• 挂起一个调度对象，应用可以临时暂挺关联这个对象的Block执行。中止任何运行中的block。调用这个方法会增加挂起计数对象。和调用dispatch_resume会减少他。当这个计数超过0，这个对象保持挂起，所以你必须合理把dispatch_suspend和dispatch_resume对应起来。
• 当对象回复，调度队列或者调度源都会继续运作。