簡單說,dispatch source 是一個監視特定事件的對象。當這些事件發生時,它會自動把一個 block 投入指定的 dispatch queue 執行。
那到底能監視哪些事件?GCD 10.6.0 支持的類型包括:
Mach port 發送權限狀態變化
Mach port 接收權限狀態變化
外部進程狀態變化
文件描述符可讀
文件描述符可寫
文件系統節點事件
POSIX 信號
自定義計時器
自定義事件
這份清單幾乎覆蓋了 kqueue 支持的全部事件,再加上 Mach 端口、內建計時器(省得自己拿超時參數拼一個)以及用戶自定義事件,實用價值相當高。
多數類型從名字就能猜到含義,唯獨「用戶事件」需要解釋一下:它由你自己調用 dispatch_source_merge_data 向源發送信號。
這個名字聽著奇怪,來由是 GCD 會在執行事件句柄之前,自動把多個事件「聯結」起來。你可以向 dispatch source 拼接任意次數據,如果此期間 dispatch queue 一直繁忙,GCD 只會調用句柄一次——這正是它的價值所在,而不是缺陷。
用戶事件有兩種:DISPATCH_SOURCE_TYPE_DATA_ADD 與 DISPATCH_SOURCE_TYPE_DATA_OR。這類源有一個 unsigned long 的 data 屬性,你每次把一個 unsigned long 傳給 dispatch_source_merge_data:使用 _ADD 版本時,聯結過程會把數字相加;使用 _OR 版本時則做按位或。句柄執行時,可以用 dispatch_source_get_data 讀取當前值,讀取後該值會被重置為 0。
舉個場景:一些異步任務需要更新進度條。主線程也不過是 GCD 中的一個 queue,所以可以把 GUI 更新派到主線程。但事件可能非常多,逐個刷新既頻繁又浪費,理想情況是主線程繁忙時把所有變化攢起來一次提交。
用 DATA_ADD 類型的 dispatch source 剛好合適:各任務完成時把計數加一,主線程空閒下來後一次讀出累計值,把這一整段進度一次刷上去。
dispatch_source_t source = dispatch_source_create(DISPATCH_SOURCE_TYPE_DATA_ADD, 0, 0, dispatch_get_main_queue());
dispatch_source_set_event_handler(source, ^{
[progressIndicator incrementBy:dispatch_source_get_data(source)];
});
dispatch_resume(source);
dispatch_apply([array count], globalQueue, ^(size_t index) {
// do some work on data at index
dispatch_source_merge_data(source, 1);
});
這裡有個容易摔跤的細節:dispatch source 創建後默認處於掛起狀態,必須調用 dispatch_resume 才會開始傳遞事件,否則句柄永遠不會執行。
假設進度條的 min/max 已設好,這段代碼就很完整了:數據並發處理,每段完成就把源加一;若主線程空閒且任務較慢,句柄會逐次觸發,實時刷新;若主線程繁忙或任務完成很快,事件會被聯結,進度條只在主線程空閒時一次跳到位。
有人會問:如果我不想要聯結,希望每次信號都觸發一次呢?那直接用 dispatch_async 就好。實際上,選擇 dispatch source 而非 dispatch_async 的唯一理由,就是為了獲得聯結帶來的好處。
用戶事件說完,看內建事件。下面用 GCD 讀取標準輸入:
dispatch_queue_t globalQueue = dispatch_get_global_queue(DISPATCH_QUEUE_PRIORITY_DEFAULT, 0);
dispatch_source_t stdinSource = dispatch_source_create(DISPATCH_SOURCE_TYPE_READ,
STDIN_FILENO, 0, globalQueue);
dispatch_source_set_event_handler(stdinSource, ^{
char buf[1024];
int len = read(STDIN_FILENO, buf, sizeof(buf));
if (len > 0)
NSLog(@"Got data from stdin: %.*s", len, buf);
});
dispatch_resume(stdinSource);
因為用的是全局隊列,句柄會在後台並行執行,程序其他部分照常運轉。這是標準 UNIX 事件處理方式的好處:不用自己寫 loop。若用經典的 read 調用,你還得時刻提防返回字節數少於請求量,以及 EINTR 這類干擾返回——用 GCD 則完全不必操心,只要文件描述符裡還有未讀數據,它就會再次調用你的句柄。
對標準輸入這麼做沒什麼問題,但換成其他文件描述符時,必須考慮讀寫完成後如何清理。dispatch source 處於活躍狀態期間絕不能關閉描述符:一旦關閉,而另一個線程新建的描述符恰好復用了同一個號,你的 source 就會在錯誤的時機被觸發,這種 bug 排查起來非常痛苦。
正確做法是用 dispatch_source_set_cancel_handler 傳入一個關閉描述符的 block,再調用 dispatch_source_cancel 取消源,此時 cancel handler 會被執行,描述符安全關閉。
其他類型的使用方式類似:提供一個用來標識源(mach port、文件描述符、進程 ID 等)的參數,一個 mask(多數情況用不到,只有 DISPATCH_SOURCE_TYPE_PROC 用它指定關心哪類進程事件),設置句柄,然後記得 resume。此外每種源都自帶一個 data 值,用 dispatch_source_get_data 讀取:文件描述符源會給出大致可讀/可寫的字節數,進程源會給出自上次調用以來發生的事件掩碼。具體含義可查 man page。
計時器事件稍有不同,它不使用 handle/mask 參數,而是通過 dispatch_source_set_timer 配置,該函數接受三個參數:
start:首次觸發時刻,類型為 dispatch_time_t。這是個不透明類型,需要用 dispatch_time 或 dispatch_walltime 構造,常量 DISPATCH_TIME_NOW 與 DISPATCH_TIME_FOREVER 也很常用。
interval:觸發間隔,含義直白。
leeway:容許的誤差,這個參數最有意思。所有計時器都不保證絕對精準,leeway 用來告訴系統你希望它多努力保證準點。若要求每 5 秒觸發且越準越好,傳 0;若是檢查郵件這類週期任務,每十分鐘一次即可,可以傳 60 秒,表示這麼多誤差可接受。
這麼做的意義是省電。系統如果能讓 CPU 睡久一點,每次醒來批量處理一批任務,顯然比反覆醒睡要高效。給計時器一個較大的 leeway,等於允許系統把你的任務與其他任務合併執行。
現在你已經知道如何用 dispatch source 監視文件描述符、計時器、聯結的用戶事件以及其他類似事件。由於它與 dispatch queue 完全集成,你可以自由選擇把句柄放在主線程、全局並發隊列或自定義串行隊列上執行。
下一篇會談 dispatch queue 的掛起、恢復與重定目標,以及 dispatch semaphore 和 GCD 的一次性初始化。