您现在的位置: IOS教程網 >> IOS系統 >  >> iOS 程式開發 >> iOS 開發基礎

ReactiveCocoa 入門教程(下):訊號串接、執行緒、節流與非同步載圖

編輯:iOS 開發基礎

翻譯自:https://www.raywenderlich.com/62796/reactivecocoa-tutorial-pt2

ReactiveCocoa 是一個讓你在 iOS 專案中使用函數響應式(FRP)技術的框架。搭配第一部分的內容,你將學會如何用訊號(signal,代表一段事件資料流)取代傳統的動作與事件處理邏輯,並學會轉換、分離與組合這些訊號。

第二部分會更深入一些,涵蓋:

1. 另外兩種事件型別:error 與 completed

2. Throttling(節流)

3. Threading(執行緒調度)

4. Continuations(連續串接)

5. 以及更多實作技巧

Twitter Instant

本教程使用的範例專案叫 Twitter Instant,它會在你輸入關鍵字時即時更新搜尋結果。專案裡已包含 Podfile,只要執行 pod install 後重新打開 TwitterInstant.xcworkspace 即可。

先花點時間熟悉結構:這是一個簡單的 split view 應用,左側是 RWSearchFormViewController,右側是 RWSearchResultsViewController。

驗證搜尋文字

第一件事是驗證搜尋字串長度需大於兩個字元。在 RWSearchFormViewController.m 中加入:

- (BOOL)isValidSearchText:(NSString *)text {
    return text.length > 2;
}

邏輯現在很簡單,但拆分出來有兩個好處:日後規則變複雜時只需改一處;同時程式碼更具表達力,能直接說清楚「為什麼要檢查長度」。接著引入標頭並在 viewDidLoad 中加上:

[[self.searchText.rac_textSignal
    map:^id(NSString *text) {
        return [self isValidSearchText:text]
            ? [UIColor whiteColor] : [UIColor yellowColor];
    }]
    subscribeNext:^(UIColor *color) {
        self.searchText.backgroundColor = color;
    }];

這段程式碼做了三件事:取出搜尋框的訊號、用 map 把文字值轉換成顏色、在 subscribeNext 的 block 中把顏色套用到背景。執行後可以看到輸入有效時是白色、無效時是黃色。

圖中流程:rac_textSignal 發出文字變化的 next 事件,map 將文字轉為顏色,subscribeNext 把結果交給 textField 的背景色。

管線的排版慣例

撰寫 ReactiveCocoa 程式碼時,社群普遍接受的慣例是:每個 operator 各佔一行,並垂直對齊。這樣一眼就能看出管線由哪些步驟組成。另外,block 內若邏輯超過幾行,應該抽成獨立私有方法。遺憾的是 Xcode 對這種排版不太友善,可能需要自行調整。

記憶體管理

想想剛才那段程式碼:你並沒有把管線指派給任何變數或屬性,它為何不會立刻被釋放?ReactiveCocoa 的設計目標之一就是允許這種匿名寫法。為了支援它,RAC 會自行持有全域訊號:只要還有一個以上訂閱者,訊號就保持活躍;所有訂閱者都移除後,訊號才釋放。

那要如何手動取消訂閱?所有 RACSignal 的訂閱方法都會回傳一個 RACDisposable 物件,呼叫它的 dispose 即可:

RACSignal *backgroundColorSignal =
    [self.searchText.rac_textSignal map:^id(NSString *text) {
        return [self isValidSearchText:text]
            ? [UIColor whiteColor] : [UIColor yellowColor];
    }];

RACDisposable *subscription =
    [backgroundColorSignal subscribeNext:^(UIColor *color) {
        self.searchText.backgroundColor = color;
    }];

// 稍後的某個時機
[subscription dispose];

實務上很少這樣做,但要知道有這個選項。順帶一提:建立管線卻不訂閱,管線不會執行,包含任何副作用在內。

避免循環引用

ReactiveCocoa 在背後做了很多聰明事,但有個記憶體問題仍需留意。像這樣的寫法:

[[self.searchText.rac_textSignal map:^id(NSString *text) {
        return [self isValidSearchText:text]
            ? [UIColor whiteColor] : [UIColor yellowColor];
    }]
    subscribeNext:^(UIColor *color) {
        self.searchText.backgroundColor = color;
    }];

subscribeNext 的 block 使用 self 取得 textField,block 因而捕獲並持有 self,與訊號之間形成強引用迴圈。若物件生命週期等同整個應用,問題不大;但在更複雜的場景中就可能出事。

蘋果在 Working With Blocks 中建議捕獲弱引用:

__weak RWSearchFormViewController *bself = self;

[[self.searchText.rac_textSignal map:^id(NSString *text) {
        return [self isValidSearchText:text]
            ? [UIColor whiteColor] : [UIColor yellowColor];
    }]
    subscribeNext:^(UIColor *color) {
        bself.searchText.backgroundColor = color;
    }];

這樣可行,但寫起來不太優雅。ReactiveCocoa 提供了更簡潔的宏,先引入:

#import "RACEXTScope.h"

然後改寫成:

@weakify(self)
[[self.searchText.rac_textSignal map:^id(NSString *text) {
        return [self isValidSearchText:text]
            ? [UIColor whiteColor] : [UIColor yellowColor];
    }]
    subscribeNext:^(UIColor *color) {
        @strongify(self)
        self.searchText.backgroundColor = color;
    }];

@weakify 會建立一個弱引用的影子變數,@strongify 則在 block 內還原成強引用。兩者來自 Extended Objective-C 的宏定義,並隨 ReactiveCocoa 一起提供,有興趣可直接翻 RACEXTScope.h 看實作。

最後提醒:在 block 中直接使用實例變數(ivar)同樣會讓 block 捕獲 self 的強引用,記得開啟編譯器警告來抓這類問題。

請求 Twitter 授權

要在 Twitter Instant 中搜尋推文,會用到 Social Framework 與 Accounts Framework。實作前先在模擬器「設定」裡登入你的 Twitter 帳號。

接著在 RWSearchFormViewController.m 中引入相關標頭,並定義錯誤型別:

typedef NS_ENUM(NSInteger, RWTwitterInstantError) {
    RWTwitterInstantErrorAccessDenied,
    RWTwitterInstantErrorNoTwitterAccounts,
    RWTwitterInstantErrorInvalidResponse
};

static NSString * const RWTwitterInstantDomain = @"TwitterInstant";

在介面中宣告兩個屬性:

@property (strong, nonatomic) ACAccountStore *accountStore;
@property (strong, nonatomic) ACAccountType *twitterAccountType;

ACAccountStore 用來存取裝置上的社群帳號,ACAccountType 代表特定類型的帳戶。接著在 viewDidLoad 中初始化:

self.accountStore = [[ACAccountStore alloc] init];
self.twitterAccountType =
    [self.accountStore accountTypeWithAccountTypeIdentifier:ACAccountTypeIdentifierTwitter];

然後實作授權訊號:

- (RACSignal *)requestAccessToTwitterSignal {
    // 1. 先定義使用者拒絕時的錯誤
    NSError *accessError = [NSError errorWithDomain:RWTwitterInstantDomain
                                              code:RWTwitterInstantErrorAccessDenied
                                          userInfo:nil];

    // 2. 建立訊號
    @weakify(self)
    return [RACSignal createSignal:^RACDisposable *(id subscriber) {
        // 3. 請求 Twitter 授權
        @strongify(self)
        [self.accountStore requestAccessToAccountsWithType:self.twitterAccountType
                                                  options:nil
                                               completion:^(BOOL granted, NSError *error) {
            // 4. 處理結果
            if (!granted) {
                [subscriber sendError:accessError];
            } else {
                [subscriber sendNext:nil];
                [subscriber sendCompleted];
            }
        }];
        return nil;
    }];
}

這個方法依次做了:定義拒絕授權的錯誤、用 createSignal 建立 RACSignal 實例、透過 accountStore 請求授權(此時系統會跳出提示框)、並在使用者回應後送出對應事件。

回想第一部分:一個訊號能發出三種事件——next、completed、error。一旦訊號生命週期結束,就不會再送出任何事件。

在 viewDidLoad 中訂閱它:

[[self requestAccessToTwitterSignal]
    subscribeNext:^(id x) {
        NSLog(@"Access granted");
    }
    error:^(NSError *error) {
        NSLog(@"An error occurred: %@", error);
    }];

執行後會看到授權提示框,按下允許會印出 Access granted,否則走 error 分支。Accounts Framework 會記住你的選擇,若要重複測試,需要對模擬器執行 Reset Contents and Settings。

串接訊號

使用者授權之後,程式要開始監聽搜尋框的變化。也就是說,需要等「請求授權」的訊號送出 completed,再去訂閱 textField 的訊號。這種連續串接是常見問題,而 ReactiveCocoa 處理得非常優雅:

[[[self requestAccessToTwitterSignal]
    then:^RACSignal *{
        @strongify(self)
        return self.searchText.rac_textSignal;
    }]
    subscribeNext:^(id x) {
        NSLog(@"%@", x);
    }
    error:^(NSError *error) {
        NSLog(@"An error occurred: %@", error);
    }];

then 會等待 completed 事件,然後由自己的 block 回傳下一個訊號,等於把控制權從一個訊號交棒給下一個。error 事件也會往下傳遞,因此最後的 error block 仍能接到最初的授權錯誤。

再加一個 filter 過濾掉長度不足的輸入:

[[[[self requestAccessToTwitterSignal]
    then:^RACSignal *{
        @strongify(self)
        return self.searchText.rac_textSignal;
    }]
    filter:^BOOL(NSString *text) {
        @strongify(self)
        return [self isValidSearchText:text];
    }]
    subscribeNext:^(id x) {
        NSLog(@"%@", x);
    }
    error:^(NSError *error) {
        NSLog(@"An error occurred: %@", error);
    }];

此時只有三個字元以上的輸入才會被印出來。

從圖上可以看到管線如何從 requestAccessToTwitterSignal 출出發,轉換到 rac_textSignal,next 事件通過 filter 後抵達訂閱 block,而任何階段發生的 error 都會被同一個 error block 接到。

搜尋 Twitter

Social Framework 可以存取 Twitter 搜尋 API,但它本身不會回報「何時該搜尋」,所以下一步是把 API 請求包裝成訊號。先建立請求:

- (SLRequest *)requestforTwitterSearchWithText:(NSString *)text {
    NSURL *url = [NSURL URLWithString:@"https://api.twitter.com/1.1/search/tweets.json"];
    NSDictionary *params = @{@"q": text};
    SLRequest *request = [SLRequest requestForServiceType:SLServiceTypeTwitter
                                           requestMethod:SLRequestMethodGET
                                                     URL:url
                                              parameters:params];
    return request;
}

接著建立以該請求為基礎的訊號:

- (RACSignal *)signalForSearchWithText:(NSString *)text {
    // 1. 定義錯誤
    NSError *noAccountsError = [NSError errorWithDomain:RWTwitterInstantDomain
                                                  code:RWTwitterInstantErrorNoTwitterAccounts
                                              userInfo:nil];
    NSError *invalidResponseError = [NSError errorWithDomain:RWTwitterInstantDomain
                                                      code:RWTwitterInstantErrorInvalidResponse
                                                  userInfo:nil];

    // 2. 建立訊號
    @weakify(self)
    return [RACSignal createSignal:^RACDisposable *(id subscriber) {
        @strongify(self);

        // 3. 建立請求
        SLRequest *request = [self requestforTwitterSearchWithText:text];

        // 4. 提供一個 Twitter 帳號
        NSArray *twitterAccounts = [self.accountStore
            accountsWithAccountType:self.twitterAccountType];
        if (twitterAccounts.count == 0) {
            [subscriber sendError:noAccountsError];
        } else {
            [request setAccount:[twitterAccounts lastObject]];

            // 5. 送出請求
            [request performRequestWithHandler:^(NSData *responseData,
                                                 NSHTTPURLResponse *urlResponse,
                                                 NSError *error) {
                if (urlResponse.statusCode == 200) {
                    // 6. 成功則解析回應
                    NSDictionary *timelineData = [NSJSONSerialization
                        JSONObjectWithData:responseData
                        options:NSJSONReadingAllowFragments error:nil];
                    [subscriber sendNext:timelineData];
                    [subscriber sendCompleted];
                } else {
                    // 7. 失敗則送出錯誤
                    [subscriber sendError:invalidResponseError];
                }
            }];
        }
        return nil;
    }];
}

把它接進管線:

[[[[[self requestAccessToTwitterSignal]
    then:^RACSignal *{
        @strongify(self)
        return self.searchText.rac_textSignal;
    }]
    filter:^BOOL(NSString *text) {
        @strongify(self)
        return [self isValidSearchText:text];
    }]
    flattenMap:^RACStream *(NSString *text) {
        @strongify(self)
        return [self signalForSearchWithText:text];
    }]
    subscribeNext:^(id x) {
        NSLog(@"%@", x);
    }
    error:^(NSError *error) {
        NSLog(@"An error occurred: %@", error);
    }];

Threading

你現在應該迫不及待想把 JSON 塞進 UI,但先別急,得先確認它在哪條執行緒上。在 subscribeNext 中加中斷點,看 Xcode 左側的執行緒資訊,你會發現它並不在主線程,而載入圖片必須在主線程進行。加上 deliverOn: 即可:

[[[[[[self requestAccessToTwitterSignal]
    then:^RACSignal *{
        @strongify(self)
        return self.searchText.rac_textSignal;
    }]
    filter:^BOOL(NSString *text) {
        @strongify(self)
        return [self isValidSearchText:text];
    }]
    flattenMap:^RACStream *(NSString *text) {
        @strongify(self)
        return [self signalForSearchWithText:text];
    }]
    deliverOn:[RACScheduler mainThreadScheduler]]
    subscribeNext:^(id x) {
        NSLog(@"%@", x);
    }
    error:^(NSError *error) {
        NSLog(@"An error occurred: %@", error);
    }];

再次執行確認已回到主線程,這時更新 UI 就安全了。

更新 UI

這裡會用到另一個庫 LinqToObjectiveC,安裝方式與 ReactiveCocoa 相同。先在 RWSearchFormViewController 中引入:

#import "RWTweet.h"
#import "NSArray+LinqExtensions.h"

然後把輸出 JSON 的地方改成:

[[[[[[self requestAccessToTwitterSignal]
    then:^RACSignal *{
        @strongify(self)
        return self.searchText.rac_textSignal;
    }]
    filter:^BOOL(NSString *text) {
        @strongify(self)
        return [self isValidSearchText:text];
    }]
    flattenMap:^RACStream *(NSString *text) {
        @strongify(self)
        return [self signalForSearchWithText:text];
    }]
    deliverOn:[RACScheduler mainThreadScheduler]]
    subscribeNext:^(NSDictionary *jsonSearchResult) {
        NSArray *statuses = jsonSearchResult[@"statuses"];
        NSArray *tweets = [statuses linq_select:^id(id tweet) {
            return [RWTweet tweetWithStatus:tweet];
        }];
        [self.resultsViewController displayTweets:tweets];
    }
    error:^(NSError *error) {
        NSLog(@"An error occurred: %@", error);
    }];

LinqToObjectiveC 的作用就是把 JSON 轉成 model,執行後右側詳情頁就能載入資料。

非同步載入圖片

內容出來了,只差頭像。在 RWSearchResultsViewController.m 中加入:

- (RACSignal *)signalForLoadingImage:(NSString *)imageUrl {
    RACScheduler *scheduler = [RACScheduler
        schedulerWithPriority:RACSchedulerPriorityBackground];

    return [[RACSignal createSignal:^RACDisposable *(id subscriber) {
        NSData *data = [NSData dataWithContentsOfURL:[NSURL URLWithString:imageUrl]];
        UIImage *image = [UIImage imageWithData:data];
        [subscriber sendNext:image];
        [subscriber sendCompleted];
        return nil;
    }] subscribeOn:scheduler];
}

這個模式你應該已經很熟了。接著在 tableView:cellForRowAtIndexPath: 中使用:

cell.twitterAvatarView.image = nil;
[[[self signalForLoadingImage:tweet.profileImageUrl]
    deliverOn:[RACScheduler mainThreadScheduler]]
    subscribeNext:^(UIImage *image) {
        cell.twitterAvatarView.image = image;
    }];

Throttling(節流)

你可能注意到一個問題:每敲一個字就立刻發一次請求,一秒內可能刷新好幾次結果,體驗很差。合理的做法是等輸入停止一段時間(例如 0.5 秒)後再搜尋,而 ReactiveCocoa 讓這件事變得極簡單:

[[[[[[[self requestAccessToTwitterSignal]
    then:^RACSignal *{
        @strongify(self)
        return self.searchText.rac_textSignal;
    }]
    filter:^BOOL(NSString *text) {
        @strongify(self)
        return [self isValidSearchText:text];
    }]
    throttle:0.5]
    flattenMap:^RACStream *(NSString *text) {
        @strongify(self)
        return [self signalForSearchWithText:text];
    }]
    deliverOn:[RACScheduler mainThreadScheduler]]
    subscribeNext:^(NSDictionary *jsonSearchResult) {
        NSArray *statuses = jsonSearchResult[@"statuses"];
        NSArray *tweets = [statuses linq_select:^id(id tweet) {
            return [RWTweet tweetWithStatus:tweet];
        }];
        [self.resultsViewController displayTweets:tweets];
    }
    error:^(NSError *error) {
        NSLog(@"An error occurred: %@", error);
    }];

throttle 只會在時間窗內保留最後一個值往下游送出,改完執行就順了。

Wrap Up

到這裡,你應該能體會 ReactiveCocoa 的優雅之處:授權、監聽輸入、過濾、請求、執行緒切換、節流,全都能用一條可讀的管線串起來。最後補充一點:ReactiveCocoa 讓 MVVM 在 iOS 上真正變得可行。

  1. 上一篇文章:
  2. 下一篇文章:
蘋果刷機越獄教程| IOS教程問題解答| IOS技巧綜合| IOS7技巧| IOS8教程
Copyright © IOS教程網 All Rights Reserved