XMPPFramework 這個開源庫裡有個 GCDMulticastDelegate 類別,它最大的價值是允許一個物件掛上多個 delegate。過去用 Objective-C 寫專案時用起來非常順手,換到純 Swift 專案後想沿用,中間需要多繞幾步,這裡把完整流程記錄下來。
把 GCDMulticastDelegate 引入工程,並在 bridging header 中加入:
#import "GCDMulticastDelegate.h"
建立一個 Swift 檔案作為代理協定宣告:
@objc protocol MyDelegate {
optional func test()
}
關鍵點有兩個:協定必須標記 @objc,且方法一定要宣告為 optional,因為 GCDMulticastDelegate 是透過 Objective-C runtime 的消息轉發機制來派發呼叫的。
新增一個名為 MyMulticastDelegate 的 Swift 檔案:
import UIKit
class MyMulticastDelegate: GCDMulticastDelegate, MyDelegate {
}
這個類別同時繼承了 GCDMulticastDelegate,並遵循自訂的 MyDelegate 協定,因此既能享受多重代理能力,又能保有型別上的可讀性。
先宣告一個實例變數,並在初始化階段完成實例化:
var multiDelegate: MyMulticastDelegate
multiDelegate = MyMulticastDelegate()
接著包裝兩個便於外部呼叫的方法,用來註冊與移除監聽者:
func addMultiDelegate(delegate: MyDelegate, delegateQueue: DispatchQueue) {
multiDelegate?.addDelegate(delegate, delegateQueue: delegateQueue)
}
func removeMultiDelegate(delegate: MyDelegate) {
multiDelegate?.removeDelegate(delegate)
}
真正要發送訊息時這樣呼叫:
if let tempMultiDelegate: MyDelegate = self.multiDelegate {
tempMultiDelegate.test!()
}
這裡有個很容易踩到的細節:呼叫時後面必須加驚嘆號 !,目的是強制觸發 GCDMulticastDelegate 內部的 forwardInvocation。如果寫成問號 ?,訊息不會被正確轉發,監聽者就會收不到通知。
需要接收 test() 的物件,把自己作為參數傳入 addMultiDelegate 方法完成註冊即可,記得在合適的時機(例如 deinit)呼叫 removeMultiDelegate 解除綁定,避免殘留的強引用。