有一種 Block 叫 Callback，有一種 Callback 叫 CompletionHandler
【引言】iOS10推送部分的API，大量使用了 CompletionHandler 這種命名方式，那么本文我們將對比下這種 Block 的特殊性，以便更好的理解和在自己的項目中實踐 CompletionHandler 樣式的 Blcok。
原文鏈接： 《有一種 Block 叫 Callback，有一種 Callback 叫 CompletionHandler》
正文
我們作為開發(fā)者去集成一個 Lib （也可以叫輪子、SDK、下文統(tǒng)一叫 Lib）時，我們會發(fā)現(xiàn)我們遇到的 Block， 按照功能的角度劃分，其實可以分為這幾種：
- Lib 通知開發(fā)者，Lib操作已經(jīng)完成。一般命名為 Callback
- 開發(fā)者通知 Lib，開發(fā)者的操作已經(jīng)完成。一般可以命名為 CompletionHandler。
這兩處的區(qū)別： 前者是 “Block 的執(zhí)行”，后者是 “Block 的填充”。
Callback vs CompletionHandler 命名與功能的差別，Apple 也沒有明確的編碼規(guī)范指出過，只不過如果按照“執(zhí)行與填充”的功能劃分的話，callback 與 completionHandler 的命名可以區(qū)分開來對待。同時也方便調(diào)用者理解 block 的功能。但總體來說，Apple 官方的命名中，“Block 填充“這個功能一般都會命名為 “completionHandler”，“Block 執(zhí)行”這個功能大多命名為了“callback” ，也有少部分命名為了 “completionHandler”。
比如：
NSURLSession 中，下面的函數(shù)將 “callback” 命名為了 “completionHandler”：
- (NSURLSessionDataTask *)dataTaskWithURL:(NSURL *)url completionHandler:(void (^)(NSData * _Nullable data, NSURLResponse * _Nullable response, NSError * _Nullable error))completionHandler;
我們常常見到 CompletionHandler 被用到了第一種場景，而第一種場景“Block 執(zhí)行”命名為 Callback 則更合適。
不是所有 Block 都適合叫做 CompletionHandler
一般情況下，CompletionHandler 的設(shè)計往往考慮到多線程操作，于是，你就完全可以異步操作，然后在線程結(jié)束時執(zhí)行該 CompletionHandler，下文的例子中會講述下 CompletionHandler 方式在多線程場景下的一些優(yōu)勢。
CompletionHandler + Delegate 組合
在 iOS10 中新增加的 UserNotificaitons 中大量使用了這種 Block，比如：
- (void)userNotificationCenter:(UNUserNotificationCenter *)center
didReceiveNotificationResponse:(UNNotificationResponse *)response
withCompletionHandler:(void (^)(void))completionHandler;
文檔 對 completionHandler 的注釋是這樣的：
The block to execute when you have finished processing the user’s response. You must execute this block from your method and should call it as quickly as possible. The block has no return value or parameters.
同樣在這里也有應用：
- (void)URLSession:(NSURLSession *)session task:(NSURLSessionTask *)task
didReceiveChallenge:(NSURLAuthenticationChallenge *)challenge
completionHandler:(void (^)(NSURLSessionAuthChallengeDisposition disposition, NSURLCredential * __nullable credential))completionHandler;
還有另外一個也非常普遍的例子（Delegate 方式使用URLSession 時候必不可少的 4個代理函數(shù)之一 ）
- (void)URLSession:(NSURLSession *)session dataTask:(NSURLSessionDataTask *)dataTask
didReceiveResponse:(NSURLResponse *)response
completionHandler:(void (^)(NSURLSessionResponseDisposition disposition))completionHandler;
在代理方法實現(xiàn)代碼里面，若是不執(zhí)行 completionHandler(NSURLSessionResponseAllow) 話，http請求就終止了。
CompletionHandler + Block 組合
函數(shù)中將函數(shù)作為參數(shù)或者返回值，就叫做高階函數(shù)。
按照這種定義，Block 中將 Block 作為參數(shù)，這也就是高階函數(shù)。
結(jié)合實際的應用場景來看一個例子：
如果有這樣一個需求：
拿我之前的一個 IM 項目 ChatKit-OC （開源的，下面簡稱 ChatKit）為例，當你的應用想要集成一個 IM 服務時，可能這時候，你的 APP 已經(jīng)上架了，已經(jīng)有自己的注冊、登錄等流程了。用 ChatKit 進行聊天很簡單，只需要給 ChatKit 一個 id 就夠了。聊天是正常了，但是雙方只能看到一個id，這樣體驗很不好。但是如何展示頭像、昵稱呢？于是就設(shè)計了這樣一個接口，-setFetchProfilesBlock: 。
這是上層（APP）提供用戶信息的 Block，由于 ChatKit 并不關(guān)心業(yè)務邏輯信息，比如用戶昵稱，用戶頭像等。用戶可以通過 ChatKit 單例向 ChatKit 注入一個用戶信息內(nèi)容提供 Block，通過這個用戶信息提供 Block，ChatKit 才能夠正確的進行業(yè)務邏輯數(shù)據(jù)的繪制。
示意圖如下：
具體實現(xiàn)如下：
方法定義如下：
/*!
* @brief The block to execute with the users' information for the userIds. Always execute this block at some point when fetching profiles completes on main thread. Specify users' information how you want ChatKit to show.
* @attention If you fetch users fails, you should reture nil, meanwhile, give the error reason.
*/
typedef void(^LCCKFetchProfilesCompletionHandler)(NSArray<id<LCCKUserDelegate>> *users, NSError *error);
/*!
* @brief When LeanCloudChatKit wants to fetch profiles, this block will be invoked.
* @param userIds User ids
* @param completionHandler The block to execute with the users' information for the userIds. Always execute this block at some point during your implementation of this method on main thread. Specify users' information how you want ChatKit to show.
*/
typedef void(^LCCKFetchProfilesBlock)(NSArray<NSString *> *userIds, LCCKFetchProfilesCompletionHandler completionHandler);
@property (nonatomic, copy) LCCKFetchProfilesBlock fetchProfilesBlock;
/*!
* @brief Add the ablitity to fetch profiles.
* @attention You must get peer information by peer id with a synchronous implementation.
* If implemeted, this block will be invoked automatically by LeanCloudChatKit for fetching peer profile.
*/
- (void)setFetchProfilesBlock:(LCCKFetchProfilesBlock)fetchProfilesBlock;
用法如下所示：
#warning 注意：setFetchProfilesBlock 方法必須實現(xiàn)，如果不實現(xiàn)，ChatKit將無法顯示用戶頭像、用戶昵稱。以下方法循環(huán)模擬了通過 userIds 同步查詢 users 信息的過程，這里需要替換為 App 的 API 同步查詢
[[LCChatKit sharedInstance] setFetchProfilesBlock:^(NSArray<NSString *> *userIds,
LCCKFetchProfilesCompletionHandler completionHandler) {
if (userIds.count == 0) {
NSInteger code = 0;
NSString *errorReasonText = @"User ids is nil";
NSDictionary *errorInfo = @{
@"code":@(code),
NSLocalizedDescriptionKey : errorReasonText,
};
NSError *error = [NSError errorWithDomain:NSStringFromClass([self class])
code:code
userInfo:errorInfo];
!completionHandler ?: completionHandler(nil, error);
return;
}
NSMutableArray *users = [NSMutableArray arrayWithCapacity:userIds.count];
#warning 注意：以下方法循環(huán)模擬了通過 userIds 同步查詢 users 信息的過程，這里需要替換為 App 的 API 同步查詢
[userIds enumerateObjectsUsingBlock:^(NSString *_Nonnull clientId, NSUInteger idx,
BOOL *_Nonnull stop) {
NSPredicate *predicate = [NSPredicate predicateWithFormat:@"peerId like %@", clientId];
//這里的LCCKContactProfiles，LCCKProfileKeyPeerId都為事先的宏定義，
NSArray *searchedUsers = [LCCKContactProfiles filteredArrayUsingPredicate:predicate];
if (searchedUsers.count > 0) {
NSDictionary *user = searchedUsers[0];
NSURL *avatarURL = [NSURL URLWithString:user[LCCKProfileKeyAvatarURL]];
LCCKUser *user_ = [LCCKUser userWithUserId:user[LCCKProfileKeyPeerId]
name:user[LCCKProfileKeyName]
avatarURL:avatarURL
clientId:clientId];
[users addObject:user_];
} else {
//注意：如果網(wǎng)絡(luò)請求失敗，請至少提供 ClientId！
LCCKUser *user_ = [LCCKUser userWithClientId:clientId];
[users addObject:user_];
}
}];
// 模擬網(wǎng)絡(luò)延時，3秒
// sleep(3);
#warning 重要：completionHandler 這個 Bock 必須執(zhí)行，需要在你**獲取到用戶信息結(jié)束**后，將信息傳給該Block！
!completionHandler ?: completionHandler([users copy], nil);
}];
對于以上 Fetch 方法的這種應用場景，其實用方法的返回值也可以實現(xiàn)，但是與 CompletionHandler 相比，無法自由切換線程是個弊端。
原文鏈接： 《有一種 Block 叫 Callback，有一種 Callback 叫 CompletionHandler》
Posted by 微博@iOS程序犭袁
