背景:
作為一個(gè)iOS開發(fā)者萨咕,你寫的每一行代碼幾乎都是在響應(yīng)某個(gè)事件,例如按鈕的點(diǎn)擊匪蝙,收到網(wǎng)絡(luò)消息敛摘,屬性的變化(通過KVO)或者用戶位置的變化(通過CoreLocation)门烂。但是這些事件都用不同的方式來處理,比如action兄淫、delegate屯远、KVO、callback等拖叙。ReactiveCocoa為事件定義了一個(gè)標(biāo)準(zhǔn)接口氓润,從而可以使用一些基本工具來更容易的連接、過濾和組合薯鳍。
如果你對上面說的還比較疑惑,那還是繼續(xù)往下看吧。
ReactiveCocoa結(jié)合了幾種編程風(fēng)格:
函數(shù)式編程(Functional Programming):使用高階函數(shù)挖滤,例如函數(shù)用其他函數(shù)作為參數(shù)崩溪。
響應(yīng)式編程(Reactive Programming):關(guān)注于數(shù)據(jù)流和變化傳播。
所以斩松,你可能聽說過ReactiveCocoa被描述為函數(shù)響應(yīng)式編程(FRP)框架伶唯。
這就是這篇教程要講的內(nèi)容。編程范式是個(gè)不錯(cuò)的主題惧盹,但是本篇教程的其余部分將會(huì)通過一個(gè)例子來實(shí)踐乳幸。
Reactive Playground
通過這篇教程,一個(gè)簡單的范例應(yīng)用Reactive Playground 钧椰,你將會(huì)了解到響應(yīng)式編程粹断。下載初始工程,然后編譯運(yùn)行一下確保你已經(jīng)把一切都設(shè)置正確了嫡霞。
Reactive Playground是一個(gè)非常簡單的應(yīng)用瓶埋,它為用戶展示了一個(gè)登錄頁。在用戶名框輸入user诊沪,在密碼框輸入password养筒,然后你就能看到有一只可愛小貓咪的歡迎頁了。
呀端姚,真是可愛啊晕粪。
現(xiàn)在可以花一些時(shí)間來看一下初始工程的代碼。很簡單渐裸,用不了多少時(shí)間巫湘。
打開RWViewController.m
看一下。你多快能找到控制登錄按鈕是否可用的條件橄仆?判斷顯示/隱藏登錄失敗label的條件是什么剩膘?在這個(gè)相對簡單的例子里,可能只用一兩分鐘就能回答這些問題盆顾。但是對于更復(fù)雜的例子怠褐,這些所花的時(shí)間可能就比較多了。
使用ReactiveCocoa您宪,可以使應(yīng)用的基本邏輯變得相當(dāng)簡潔奈懒。是時(shí)候開始啦。
添加ReactiveCocoa框架
添加ReactiveCocoa框架最簡單的方法就是用CocoaPods宪巨。如果你從沒用過CocoaPods磷杏,那還是先去看看CocoaPods簡介這篇教程吧。請至少看完教程中初始化的步驟捏卓,這樣你才能安裝框架极祸。
注意:如果不想用CocoaPods,你仍然可以使用ReactiveCocoa,具體查看Github文檔中引入ReactiveCocoa的步驟描述遥金。
譯注:我就是不喜歡用CocoaPods的那波人浴捆。所以我首先使用了Github上提供的方法,但是在第二步執(zhí)行bootstrap時(shí)提示缺少xctool稿械,我就果斷放棄了选泻,還是乖乖用CocoaPods吧。
具體怎么使用CocoaPods安裝就不詳細(xì)講解了美莫。
開動(dòng)
就像在介紹中提到的页眯,RAC為應(yīng)用中發(fā)生的不同事件流提供了一個(gè)標(biāo)準(zhǔn)接口。在ReactiveCocoa術(shù)語中這個(gè)叫做信號(signal)厢呵,由RACSignal
類表示窝撵。
打開應(yīng)用的初始view controller,RWViewController.m
述吸,引入ReactiveCocoa
的頭文件忿族。
#import <ReactiveCocoa/ReactiveCocoa.h>
不要替換已有的代碼,將下面的代碼添加到viewDidLoad方法的最后:
[self.usernameTextField.rac_textSignal subscribeNext:^(id x) {
NSLog(@"%@", x);
}];
編譯運(yùn)行蝌矛,在用戶名輸入框中輸幾個(gè)字道批。注意console的輸出應(yīng)該和下面的類似。
2013-12-24 14:48:50.359 RWReactivePlayground[9193:a0b] i
2013-12-24 14:48:50.436 RWReactivePlayground[9193:a0b] is
2013-12-24 14:48:50.541 RWReactivePlayground[9193:a0b] is
2013-12-24 14:48:50.695 RWReactivePlayground[9193:a0b] is t
2013-12-24 14:48:50.831 RWReactivePlayground[9193:a0b] is th
2013-12-24 14:48:50.878 RWReactivePlayground[9193:a0b] is thi
2013-12-24 14:48:50.901 RWReactivePlayground[9193:a0b] is this
2013-12-24 14:48:51.009 RWReactivePlayground[9193:a0b] is this
2013-12-24 14:48:51.142 RWReactivePlayground[9193:a0b] is this m
2013-12-24 14:48:51.236 RWReactivePlayground[9193:a0b] is this ma
2013-12-24 14:48:51.335 RWReactivePlayground[9193:a0b] is this mag
2013-12-24 14:48:51.439 RWReactivePlayground[9193:a0b] is this magi
2013-12-24 14:48:51.535 RWReactivePlayground[9193:a0b] is this magic
2013-12-24 14:48:51.774 RWReactivePlayground[9193:a0b] is this magic?
可以看到每次改變文本框中的文字入撒,block中的代碼都會(huì)執(zhí)行隆豹。沒有target-action,沒有delegate茅逮,只有signal和block璃赡。令人激動(dòng)不是嗎?
ReactiveCocoa signal(RACSignal
)發(fā)送事件流給它的subscriber献雅。目前總共有三種類型的事件:next
碉考、error
、completed
挺身。一個(gè)signal在因error終止或者完成前侯谁,可以發(fā)送任意數(shù)量的next事件。在本教程的第一部分章钾,我們將會(huì)關(guān)注next
事件墙贱。在第二部分,將會(huì)學(xué)習(xí)error
和completed
事件贱傀。
RACSignal有很多方法可以來訂閱不同的事件類型惨撇。每個(gè)方法都需要至少一個(gè)block,當(dāng)事件發(fā)生時(shí)就會(huì)執(zhí)行block中的邏輯府寒。在上面的例子中可以看到每次next事件發(fā)生時(shí)魁衙,subscribeNext:
方法提供的block都會(huì)執(zhí)行报腔。
ReactiveCocoa框架使用category來為很多基本UIKit控件添加signal。這樣你就能給控件添加訂閱了纺棺,text field的rac_textSignal
就是這么來的榄笙。
原理就說這么多邪狞,是時(shí)候開始讓ReactiveCocoa干活了祷蝌。
ReactiveCocoa有很多操作來控制事件流。假設(shè)你只關(guān)心超過3個(gè)字符長度的用戶名帆卓,那么你可以使用filter
操作來實(shí)現(xiàn)這個(gè)目的巨朦。把之前加在viewDidLoad
中的代碼更新成下面的:
[[self.usernameTextField.rac_textSignal
filter:^BOOL(id value) {
NSString *text = value;
return text.length > 3;
}]
subscribeNext:^(id x) {
NSLog(@"%@", x);
}];
編譯運(yùn)行,在text field只能怪輸入幾個(gè)字剑令,你會(huì)發(fā)現(xiàn)只有當(dāng)輸入超過3個(gè)字符時(shí)才會(huì)有l(wèi)og糊啡。
2013-12-26 08:17:51.335 RWReactivePlayground[9654:a0b] is t
2013-12-26 08:17:51.478 RWReactivePlayground[9654:a0b] is th
2013-12-26 08:17:51.526 RWReactivePlayground[9654:a0b] is thi
2013-12-26 08:17:51.548 RWReactivePlayground[9654:a0b] is this
2013-12-26 08:17:51.676 RWReactivePlayground[9654:a0b] is this
2013-12-26 08:17:51.798 RWReactivePlayground[9654:a0b] is this m
2013-12-26 08:17:51.926 RWReactivePlayground[9654:a0b] is this ma
2013-12-26 08:17:51.987 RWReactivePlayground[9654:a0b] is this mag
2013-12-26 08:17:52.141 RWReactivePlayground[9654:a0b] is this magi
2013-12-26 08:17:52.229 RWReactivePlayground[9654:a0b] is this magic
2013-12-26 08:17:52.486 RWReactivePlayground[9654:a0b] is this magic?
剛才所創(chuàng)建的只是一個(gè)很簡單的管道。這就是響應(yīng)式編程的本質(zhì)吁津,根據(jù)數(shù)據(jù)流來表達(dá)應(yīng)用的功能棚蓄。
用圖形來表達(dá)就是下面這樣的:
從上面的圖中可以看到,
rac_textSignal
是起始事件碍脏。然后數(shù)據(jù)通過一個(gè)filter
梭依,如果這個(gè)事件包含一個(gè)長度超過3的字符串,那么該事件就可以通過典尾。管道的最后一步就是subscribeNext:
役拴,block在這里打印出事件的值。
filter
操作的輸出也是RACSignal
钾埂,這點(diǎn)先放到一邊河闰。你可以像下面那樣調(diào)整一下代碼來展示每一步的操作。
RACSignal *usernameSourceSignal =
self.usernameTextField.rac_textSignal;
RACSignal *filteredUsername = [usernameSourceSignal
filter:^BOOL(id value) {
NSString *text = value;
return text.length > 3;
}];
[filteredUsername subscribeNext:^(id x) {
NSLog(@"%@", x);
}];
RACSignal的每個(gè)操作都會(huì)返回一個(gè)RACsignal褥紫,這在術(shù)語上叫做連貫接口(fluent interface)姜性。這個(gè)功能可以讓你直接構(gòu)建管道裁眯,而不用每一步都使用本地變量布讹。
注意:ReactiveCocoa大量使用block疚俱。如果你是block新手券躁,你可能想看看Apple官方的block編程指南争群。如果你熟悉block哄褒,但是覺得block的語法有些奇怪和難記藏否,你可能會(huì)想看看這個(gè)有趣又實(shí)用的網(wǎng)頁f????gblocksyntax.com鞭衩。
類型轉(zhuǎn)換
如果你之前把代碼分成了多個(gè)步驟门驾,現(xiàn)在再把它改回來吧射赛。。奶是。楣责。竣灌。。秆麸。初嘹。
[[self.usernameTextField.rac_textSignal
filter:^BOOL(id value) {
NSString *text = value; // implicit cast
return text.length > 3;
}]
subscribeNext:^(id x) {
NSLog(@"%@", x);
}];
在上面的代碼中,注釋部分標(biāo)記了將id隱式轉(zhuǎn)換為NSString
沮趣,這看起來不是很好看屯烦。幸運(yùn)的是,傳入block的值肯定是個(gè)NSString
房铭,所以你可以直接修改參數(shù)類型驻龟,把代碼更新成下面的這樣的:
[[self.usernameTextField.rac_textSignal
filter:^BOOL(NSString *text) {
return text.length > 3;
}]
subscribeNext:^(id x) {
NSLog(@"%@", x);
}];
編譯運(yùn)行,確保沒什么問題缸匪。
什么是事件呢翁狐?
到目前為止,本篇教程已經(jīng)描述了不同的事件類型凌蔬,但是還沒有說明這些事件的結(jié)構(gòu)露懒。有意思的是(?)砂心,事件可以包括任何事情懈词。
下面來展示一下,在管道中添加另一個(gè)操作计贰。把添加在viewDidLoad
中的代碼更新成下面的:
[[[self.usernameTextField.rac_textSignal
map:^id(NSString *text) {
return @(text.length);
}]
filter:^BOOL(NSNumber *length) {
return [length integerValue] > 3;
}]
subscribeNext:^(id x) {
NSLog(@"%@", x);
}];
編譯運(yùn)行钦睡,你會(huì)發(fā)現(xiàn)log輸出變成了文本的長度而不是內(nèi)容。
2013-12-26 12:06:54.566 RWReactivePlayground[10079:a0b] 4
2013-12-26 12:06:54.725 RWReactivePlayground[10079:a0b] 5
2013-12-26 12:06:54.853 RWReactivePlayground[10079:a0b] 6
2013-12-26 12:06:55.061 RWReactivePlayground[10079:a0b] 7
2013-12-26 12:06:55.197 RWReactivePlayground[10079:a0b] 8
2013-12-26 12:06:55.300 RWReactivePlayground[10079:a0b] 9
2013-12-26 12:06:55.462 RWReactivePlayground[10079:a0b] 10
2013-12-26 12:06:55.558 RWReactivePlayground[10079:a0b] 11
2013-12-26 12:06:55.646 RWReactivePlayground[10079:a0b] 12
新加的map
操作通過block改變了事件的數(shù)據(jù)躁倒。map
從上一個(gè)``next**事件接收數(shù)據(jù)荞怒,通過執(zhí)行block把返回值傳給下一個(gè)**
next**事件。在上面的代碼中秧秉,
map以**
NSString**為輸入褐桌,取字符串的長度,返回一個(gè)**
NSNumber`象迎。
來看下面的圖片:
能看到map
操作之后的步驟收到的都是NSNumber
實(shí)例荧嵌。你可以使用map
操作來把接收的數(shù)據(jù)轉(zhuǎn)換成想要的類型,只要它是個(gè)對象砾淌。
注意:在上面的例子中
text.length
返回一個(gè)NSUInteger
啦撮,是一個(gè)基本類型。為了將它作為事件的內(nèi)容汪厨,NSUInteger
必須被封裝赃春。幸運(yùn)的是Objective-C literal syntax提供了一種簡單的方法來封裝——@ (text.length)
。
現(xiàn)在差不多是時(shí)候用所學(xué)的內(nèi)容來更新一下ReactivePlayground應(yīng)用了劫乱。你可以把之前的添加代碼都刪除了织中。锥涕。。狭吼。层坠。。
創(chuàng)建有效狀態(tài)信號
首先要做的就是創(chuàng)建一些信號刁笙,來表示用戶名和密碼輸入框中的輸入內(nèi)容是否有效破花。把下面的代碼添加到RWViewController.m
中viewDidLoad
的最后面:
RACSignal *validUsernameSignal =
[self.usernameTextField.rac_textSignal
map:^id(NSString *text) {
return @([self isValidUsername:text]);
}];
RACSignal *validPasswordSignal =
[self.passwordTextField.rac_textSignal
map:^id(NSString *text) {
return @([self isValidPassword:text]);
}];
可以看到,上面的代碼對每個(gè)輸入框的rac_textSignal
應(yīng)用了一個(gè)map
轉(zhuǎn)換采盒。輸出是一個(gè)用NSNumber
封裝的布爾值旧乞。
下一步是轉(zhuǎn)換這些信號,從而能為輸入框設(shè)置不同的背景顏色磅氨。基本上就是嫡纠,你訂閱這些信號烦租,然后用接收到的值來更新輸入框的背景顏色。下面有一種方法:
[[validPasswordSignal
map:^id(NSNumber *passwordValid) {
return [passwordValid boolValue] ? [UIColor clearColor] : [UIColor yellowColor];
}]
subscribeNext:^(UIColor *color) {
self.passwordTextField.backgroundColor = color;
}];
(不要使用這段代碼除盏,下面有一種更好的寫法2娉鳌)
從概念上來說,就是把之前信號的輸出應(yīng)用到輸入框的backgroundColor
屬性上者蠕。但是上面的用法不是很好窃祝。
幸運(yùn)的是,ReactiveCocoa提供了一個(gè)宏來更好的完成上面的事情踱侣。把下面的代碼直接加到viewDidLoad
中兩個(gè)信號的代碼后面:
RAC(self.passwordTextField, backgroundColor) =
[validPasswordSignal
map:^id(NSNumber *passwordValid) {
return [passwordValid boolValue] ? [UIColor clearColor] : [UIColor yellowColor];
}];
RAC(self.usernameTextField, backgroundColor) =
[validUsernameSignal
map:^id(NSNumber *passwordValid) {
return [passwordValid boolValue] ? [UIColor clearColor] : [UIColor yellowColor];
}];
RAC宏允許直接把信號的輸出應(yīng)用到對象的屬性上粪小。RAC宏有兩個(gè)參數(shù),第一個(gè)是需要設(shè)置屬性值的對象抡句,第二個(gè)是屬性名探膊。每次信號產(chǎn)生一個(gè)next
事件,傳遞過來的值都會(huì)應(yīng)用到該屬性上待榔。
你不覺得這種方法很好嗎逞壁?
在編譯運(yùn)行之前,找到updateUIState
方法锐锣,把頭兩行刪掉腌闯。
self.usernameTextField.backgroundColor = self.usernameIsValid ? [UIColor clearColor] : [UIColor yellowColor];
self.passwordTextField.backgroundColor = self.passwordIsValid ? [UIColor clearColor] : [UIColor yellowColor];
這樣就把不相關(guān)的代碼刪掉了。
編譯運(yùn)行雕憔,可以發(fā)現(xiàn)當(dāng)輸入內(nèi)容無效時(shí)姿骏,輸入框看起來高亮了,有效時(shí)又透明了橘茉。
現(xiàn)在的邏輯用圖形來表示就是下面這樣的工腋。能看到有兩條簡單的管道姨丈,兩個(gè)文本信號,經(jīng)過一個(gè)map轉(zhuǎn)為表示是否有效的布爾值擅腰,再經(jīng)過一個(gè)map轉(zhuǎn)為UIColor
蟋恬,而這個(gè)UIColor已經(jīng)和輸入框的背景顏色綁定了。
你是否好奇為什么要?jiǎng)?chuàng)建兩個(gè)分開的validPasswordSignal
和validUsernameSignal
呢趁冈,而不是每個(gè)輸入框一個(gè)單獨(dú)的管道呢歼争?(?)稍安勿躁渗勘,答案就在下面沐绒。
原文:Are you wondering why you created separate validPasswordSignal and validUsernameSignal signals, as opposed to a single fluent pipeline for each text field? Patience dear reader, the method behind this madness will become clear shortly!
聚合信號
目前在應(yīng)用中,登錄按鈕只有當(dāng)用戶名和密碼輸入框的輸入都有效時(shí)才工作⊥梗現(xiàn)在要把這里改成響應(yīng)式的乔遮。
現(xiàn)在的代碼中已經(jīng)有可以產(chǎn)生用戶名和密碼輸入框是否有效的信號了——validUsernameSignal
和validPasswordSignal
了。現(xiàn)在需要做的就是聚合這兩個(gè)信號來決定登錄按鈕是否可用取刃。
把下面的代碼添加到viewDidLoad
的末尾:
RACSignal *signUpActiveSignal =
[RACSignal combineLatest:@[validUsernameSignal, validPasswordSignal]
reduce:^id(NSNumber *usernameValid, NSNumber *passwordValid) {
return @([usernameValid boolValue] && [passwordValid boolValue]);
}];
上面的代碼使用combineLatest:reduce:
方法把validUsernameSignal
和validPasswordSignal
產(chǎn)生的最新的值聚合在一起蹋肮,并生成一個(gè)新的信號。每次這兩個(gè)源信號的任何一個(gè)產(chǎn)生新值時(shí)璧疗,reduce block
都會(huì)執(zhí)行坯辩,block的返回值會(huì)發(fā)給下一個(gè)信號。
注意:RACsignal的這個(gè)方法可以聚合任意數(shù)量的信號崩侠,reduce block的參數(shù)和每個(gè)源信號相關(guān)漆魔。ReactiveCocoa有一個(gè)工具類RACBlockTrampoline,它在內(nèi)部處理reduce block的可變參數(shù)却音。實(shí)際上在ReactiveCocoa的實(shí)現(xiàn)中有很多隱藏的技巧改抡,值得你去看看。
現(xiàn)在已經(jīng)有了合適的信號僧家,把下面的代碼添加到viewDidLoad
的末尾雀摘。這會(huì)把信號和按鈕的enabled
屬性綁定。
[signUpActiveSignal subscribeNext:^(NSNumber *signupActive) {
self.signInButton.enabled = [signupActive boolValue];
}];
在運(yùn)行之前八拱,把以前的舊實(shí)現(xiàn)刪掉阵赠。把下面這兩個(gè)屬性刪掉。
@property (nonatomic) BOOL passwordIsValid;
@property (nonatomic) BOOL usernameIsValid;
把viewDidLoad
中的這些也刪掉:
// handle text changes for both text fields
[self.usernameTextField addTarget:self
action:@selector(usernameTextFieldChanged)
forControlEvents:UIControlEventEditingChanged];
[self.passwordTextField addTarget:self
action:@selector(passwordTextFieldChanged)
forControlEvents:UIControlEventEditingChanged];
同樣把updateUIState
肌稻、usernameTextFieldChanged
和passwordTextFieldChanged
方法刪掉清蚀。
最后確保把viewDidLoad
中updateUIState
的調(diào)用刪掉。
編譯運(yùn)行爹谭,看看登錄按鈕枷邪。當(dāng)用戶名和密碼輸入有效時(shí),按鈕就是可用的诺凡,和以前一樣东揣。
現(xiàn)在應(yīng)用的邏輯就是下面這樣的:
上圖展示了一些重要的概念践惑,你可以使用ReactiveCocoa來完成一些重量級的任務(wù)。
- 分割——信號可以有很多
subscriber
嘶卧,也就是作為很多后續(xù)步驟的源尔觉。注意上圖中那個(gè)用來表示用戶名和密碼有效性的布爾信號,它被分割成多個(gè)芥吟,用于不同的地方侦铜。
- 聚合——多個(gè)信號可以聚合成一個(gè)新的信號,在上面的例子中钟鸵,兩個(gè)布爾信號聚合成了一個(gè)钉稍。實(shí)際上你可以聚合并產(chǎn)生任何類型的信號。
這些改動(dòng)的結(jié)果就是棺耍,代碼中沒有用來表示兩個(gè)輸入框有效狀態(tài)的私有屬性了贡未。這就是用響應(yīng)式編程的一個(gè)關(guān)鍵區(qū)別,你不需要使用實(shí)例變量來追蹤瞬時(shí)狀態(tài)烈掠。
響應(yīng)式的登錄
應(yīng)用目前使用上面圖中展示的響應(yīng)式管道來管理輸入框和按鈕的狀態(tài)羞秤。但是按鈕按下的處理用的還是action,所以下一步就是把剩下的邏輯都替換成響應(yīng)式的左敌。
在storyboard中,登錄按鈕的Touch Up Inside
事件和RWViewController.m
中的signInButtonTouched
方法是綁定的俐镐。下面會(huì)用響應(yīng)的方法替換矫限,所以首先要做的就是斷開當(dāng)前的storyboard action。
打開Main.storyboard佩抹,找到登錄按鈕叼风,按住ctrl鍵單擊,打開outlet/action連接框棍苹,然后點(diǎn)擊x來斷開連接无宿。如果你找不到的話,下圖中紅色箭頭指示的就是刪除按鈕枢里。
你已經(jīng)知道了ReactiveCocoa框架是如何給基本UIKit控件添加屬性和方法的了孽鸡。目前你已經(jīng)使用了rac_textSignal
,它會(huì)在文本發(fā)生變化時(shí)產(chǎn)生信號栏豺。為了處理按鈕的事件彬碱,現(xiàn)在需要用到ReactiveCocoa為UIKit添加的另一個(gè)方法,rac_signalForControlEvents
奥洼。
現(xiàn)在回到RWViewController.m
巷疼,把下面的代碼添加到viewDidLoad
的末尾:
[[self.signInButton
rac_signalForControlEvents:UIControlEventTouchUpInside]
subscribeNext:^(id x) {
NSLog(@"button clicked");
}];
上面的代碼從按鈕的UIControlEventTouchUpInside
事件創(chuàng)建了一個(gè)信號,然后添加了一個(gè)訂閱灵奖,在每次事件發(fā)生時(shí)都會(huì)輸出log嚼沿。
編譯運(yùn)行估盘,確保的確有l(wèi)og輸出。按鈕只在用戶名和密碼框輸入有效時(shí)可用骡尽,所以在點(diǎn)擊按鈕前需要在兩個(gè)文本框中輸入一些內(nèi)容遣妥。
可以看到Xcode控制臺(tái)的輸出和下面的類似:
2013-12-28 08:05:10.816 RWReactivePlayground[18203:a0b] button clicked
2013-12-28 08:05:11.675 RWReactivePlayground[18203:a0b] button clicked
2013-12-28 08:05:12.605 RWReactivePlayground[18203:a0b] button clicked
2013-12-28 08:05:12.766 RWReactivePlayground[18203:a0b] button clicked
2013-12-28 08:05:12.917 RWReactivePlayground[18203:a0b] button clicked
現(xiàn)在按鈕有了點(diǎn)擊事件的信號,下一步就是把它和登錄流程連接起來爆阶。那么問題就來了燥透,打開RWDummySignInService.h
,看一下接口:
typedef void (^RWSignInResponse)(BOOL);
@interface RWDummySignInService : NSObject
- (void)signInWithUsername:(NSString *)username
password:(NSString *)password
complete:(RWSignInResponse)completeBlock;
@end
這個(gè)service有3個(gè)參數(shù)辨图,用戶名班套、密碼和一個(gè)完成回調(diào)block。這個(gè)block會(huì)在登錄成功或失敗時(shí)執(zhí)行故河。你可以在按鈕點(diǎn)擊事件的subscribeNext:
blcok里直接調(diào)用這個(gè)方法吱韭,但是為什么你要這么做?
注意:本教程為了簡便使用了一個(gè)假的service鱼的,所以它不依賴任何外部API理盆。但你現(xiàn)在的確遇到了一個(gè)問題,如何使用這些不是用信號表示的API呢凑阶?
創(chuàng)建信號
幸運(yùn)的是猿规,把已有的異步API用信號的方式來表示相當(dāng)簡單。首先把RWViewController.m中的signInButtonTouched:刪掉宙橱。你會(huì)用響應(yīng)式的的方法來替換這段邏輯姨俩。
還是在RWViewController.m
中,添加下面的方法:
-(RACSignal *)signInSignal {
return [RACSignal createSignal:^RACDisposable *(id<RACSubscriber> subscriber) {
[self.signInService
signInWithUsername:self.usernameTextField.text
password:self.passwordTextField.text
complete:^(BOOL success) {
[subscriber sendNext:@(success)];
[subscriber sendCompleted];
}];
return nil;
}];
}
上面的方法創(chuàng)建了一個(gè)信號师郑,使用用戶名和密碼登錄』房現(xiàn)在分解來看一下。
上面的代碼使用RACSignal
的createSignal:
方法來創(chuàng)建信號宝冕。方法的入?yún)⑹且粋€(gè)block张遭,這個(gè)block描述了這個(gè)信號。當(dāng)這個(gè)信號有subscriber時(shí)地梨,block里的代碼就會(huì)執(zhí)行菊卷。
block的入?yún)⑹且粋€(gè)subscriber
實(shí)例,它遵循RACSubscribe
r協(xié)議湿刽,協(xié)議里有一些方法來產(chǎn)生事件的烁,你可以發(fā)送任意數(shù)量的next
事件,或者用error\complete
事件來終止诈闺。本例中渴庆,信號發(fā)送了一個(gè)next
事件來表示登錄是否成功,隨后是一個(gè)complete
事件。
這個(gè)block的返回值是一個(gè)RACDisposable
對象襟雷,它允許你在一個(gè)訂閱被取消時(shí)執(zhí)行一些清理工作刃滓。當(dāng)前的信號不需要執(zhí)行清理操作,所以返回nil就可以了耸弄。
可以看到咧虎,把一個(gè)異步API用信號封裝是多簡單!
現(xiàn)在就來使用這個(gè)新的信號计呈。把之前添加在viewDidLoad
中的代碼更新成下面這樣的:
[[[self.signInButton
rac_signalForControlEvents:UIControlEventTouchUpInside]
map:^id(id x) {
return [self signInSignal];
}]
subscribeNext:^(id x) {
NSLog(@"Sign in result: %@", x);
}];
上面的代碼使用map
方法砰诵,把按鈕點(diǎn)擊信號轉(zhuǎn)換成了登錄信號。subscriber輸出log捌显。
編譯運(yùn)行茁彭,點(diǎn)擊登錄按鈕,查看Xcode的控制臺(tái)扶歪,等等理肺,輸出的這是個(gè)什么鬼?
2014-01-08 21:00:25.919 RWReactivePlayground[33818:a0b] Sign in result:
<RACDynamicSignal: 0xa068a00> name: +createSignal:
沒錯(cuò)善镰,你已經(jīng)給subscribeNext:的block傳入了一個(gè)信號妹萨,但傳入的不是登錄結(jié)果的信號。
下圖展示了到底發(fā)生了什么:
當(dāng)點(diǎn)擊按鈕時(shí)炫欺,
rac_signalForControlEvents
發(fā)送了一個(gè)next事件(事件的data是UIButton)乎完。map
操作創(chuàng)建并返回了登錄信號,這意味著后續(xù)步驟都會(huì)收到一個(gè)RACSignal
品洛。這就是你在subscribeNext:
這步看到的囱怕。
上面問題的解決方法,有時(shí)候叫做信號中的信號毫别,換句話說就是一個(gè)外部信號里面還有一個(gè)內(nèi)部信號。你可以在外部信號的subscribeNext:
block里訂閱內(nèi)部信號典格。不過這樣嵌套太混亂啦岛宦,還好ReactiveCocoa已經(jīng)解決了這個(gè)問題。
信號中的信號
解決的方法很簡單耍缴,只需要把map
操作改成flattenMap
就可以了:
[[[self.signInButton
rac_signalForControlEvents:UIControlEventTouchUpInside]
flattenMap:^id(id x) {
return [self signInSignal];
}]
subscribeNext:^(id x) {
NSLog(@"Sign in result: %@", x);
}];
這個(gè)操作把按鈕點(diǎn)擊事件轉(zhuǎn)換為登錄信號砾肺,同時(shí)還從內(nèi)部信號發(fā)送事件到外部信號。
編譯運(yùn)行防嗡,注意控制臺(tái)变汪,現(xiàn)在應(yīng)該輸出登錄是否成功了。
2013-12-28 18:20:08.156 RWReactivePlayground[22993:a0b] Sign in result: 0
2013-12-28 18:25:50.927 RWReactivePlayground[22993:a0b] Sign in result: 1
還不錯(cuò)蚁趁。
現(xiàn)在已經(jīng)完成了大部分的內(nèi)容裙盾,最后就是在subscribeNext步驟里添加登錄成功后跳轉(zhuǎn)的邏輯。把代碼更新成下面的:
[[[self.signInButton
rac_signalForControlEvents:UIControlEventTouchUpInside]
flattenMap:^id(id x) {
return [self signInSignal];
}]
subscribeNext:^(NSNumber *signedIn) {
BOOL success = [signedIn boolValue];
self.signInFailureText.hidden = success;
if (success) {
[self performSegueWithIdentifier:@"signInSuccess" sender:self];
}
}];
subscribeNext:
block從登錄信號中取得結(jié)果,相應(yīng)地更新signInFailureText
是否可見番官。如果登錄成功執(zhí)行導(dǎo)航跳轉(zhuǎn)庐完。
編譯運(yùn)行,應(yīng)該就能再看到可愛的小貓啦徘熔!喵~
你注意到這個(gè)應(yīng)用現(xiàn)在有一些用戶體驗(yàn)上的小問題了嗎门躯?當(dāng)?shù)卿泂ervice正在校驗(yàn)用戶名和密碼時(shí),登錄按鈕應(yīng)該是不可點(diǎn)擊的酷师。這會(huì)防止用戶多次執(zhí)行登錄操作讶凉。還有,如果登錄失敗了山孔,用戶再次嘗試登錄時(shí)懂讯,應(yīng)該隱藏錯(cuò)誤信息。
這個(gè)邏輯應(yīng)該怎么添加呢饱须?改變按鈕的可用狀態(tài)并不是轉(zhuǎn)換(map)域醇、過濾(filter)或者其他已經(jīng)學(xué)過的概念。其實(shí)這個(gè)就叫做“副作用”蓉媳,換句話說就是在一個(gè)next事件發(fā)生時(shí)執(zhí)行的邏輯譬挚,而該邏輯并不改變事件本身。
添加附加操作(Adding ****side-effects)
把代碼更新成下面的:
[[[[self.signInButton
rac_signalForControlEvents:UIControlEventTouchUpInside]
doNext:^(id x) {
self.signInButton.enabled = NO;
self.signInFailureText.hidden = YES;
}]
flattenMap:^id(id x) {
return [self signInSignal];
}]
subscribeNext:^(NSNumber *signedIn) {
self.signInButton.enabled = YES;
BOOL success = [signedIn boolValue];
self.signInFailureText.hidden = success;
if (success) {
[self performSegueWithIdentifier:@"signInSuccess" sender:self];
}
}];
你可以看到doNext:
是直接跟在按鈕點(diǎn)擊事件的后面酪呻。而且doNext:
block并沒有返回值减宣。因?yàn)樗歉郊硬僮鳎⒉桓淖兪录旧怼?/p>
上面的doNext:
block把按鈕置為不可點(diǎn)擊玩荠,隱藏登錄失敗提示漆腌。然后在subscribeNext:
block里重新把按鈕置為可點(diǎn)擊,并根據(jù)登錄結(jié)果來決定是否顯示失敗提示阶冈。
之前的管道圖就更新成下面這樣的:
編譯運(yùn)行闷尿,確保登錄按鈕的可點(diǎn)擊狀態(tài)和預(yù)期的一樣。
現(xiàn)在所有的工作都已經(jīng)完成了女坑,這個(gè)應(yīng)用已經(jīng)是響應(yīng)式的啦填具。
如果你中途哪里出了問題,可以下載最終的工程(依賴庫都有)匆骗,或者在Github上找到這份代碼劳景,教程中的每一次編譯運(yùn)行都有對應(yīng)的commit。
注意:在異步操作執(zhí)行的過程中禁用按鈕是一個(gè)常見的問題碉就,ReactiveCocoa也能很好的解決盟广。
RACCommand
就包含這個(gè)概念,它有一個(gè)enabled
信號瓮钥,能讓你把按鈕的enabled屬性和信號綁定起來筋量。你也許想試試這個(gè)類烹吵。
總結(jié)
希望本教程為你今后在自己的應(yīng)用中使用ReactiveCocoa打下了一個(gè)好的基礎(chǔ)。你可能需要一些練習(xí)來熟悉這些概念毛甲,但就像是語言或者編程年叮,一旦你夯實(shí)基礎(chǔ),用起來也就很簡單了玻募。ReactiveCocoa的核心就是信號只损,而它不過就是事件流。還能再更簡單點(diǎn)嗎七咧?
在使用ReactiveCocoa后跃惫,我發(fā)現(xiàn)了一個(gè)有趣的事情,那就是你可以用很多種不同的方法來解決同一個(gè)問題艾栋。你可以用教程中的例子試試爆存,調(diào)整一下信號,改改信號的分割和聚合蝗砾。
ReactiveCocoa的主旨是讓你的代碼更簡潔易懂先较,這值得多想想。我個(gè)人認(rèn)為悼粮,如果邏輯可以用清晰的管道闲勺、流式語法來表示,那就很好理解這個(gè)應(yīng)用到底干了什么了扣猫。