Future
Future
有三種狀態未完成
、完成帶有值
、完成帶有異常
,使用Future
可以簡化事件任務。 假如你有一個按鈕,點擊之后開始下載圖片,首先事件循環機制會處理你的點擊事件,然后開始下載圖片,當下載完成,你可以使用then
來注冊回調,然后獲取到圖片并顯示出來。
通常我們不會直接創建,網絡下載圖片會返回一個Future
,文件I/O
會返回一個Future
,那我們怎么創建一個呢?只需要關鍵字async
就表示該函數異步執行,返回類型是Future<T>
。
Future<String> getStr()async{
var str = HttpRequest.getString('www.fgyong.cn');
return str;
}
使用http
請求地址www.fgyong.cn
獲取數據,然后返回。
如何接收文本呢?
其實很簡單,只需要使用await
關鍵字即可,用來注冊then
回調。
main(List<String> args) async {
String string = await getStr();
print(string);
}
等同于:
main(List<String> args) async {
getStr().then((value) {
print(value);
});
}
官方比較推薦前者,因為前者看起來很像同步函數,少了層層嵌套,方便開發者理解代碼。
網絡下載想延遲動畫隱藏時間,可以使用Future.delayed()
。
await Future.delayed(Duration(seconds: 2), () {
hideAnimation();
});
如果已經帶有值的想異步去執行,那么可以使用Future.value()
Stream
dart:async
庫包含對許多Dart API
很重要的兩種類型:Stream
和Future
。如果Future
表示單個計算的結果,則流是一系列結果。您偵聽流以獲取有關結果(數據和錯誤)以及流關閉的通知。您還可以在收聽流時暫停播放或在流完成之前停止收聽。
如何使用Stream
流可以通過多種方式創建,后續在仔細講解,但是它們都可以以相同的方式使用:異步for
循環(通常僅稱為await for
)遍歷流的事件,如for
循環迭代遍歷。例如:
Future<int> sumStream(Stream<int> stream) async {
var sum = 0;
await for (var value in stream) {
sum += value;
}
return sum;
}
此代碼僅接收整數事件流中的每個事件,將它們相加,然后返回(和)其和。當循環主體結束時,函數將暫停,直到下一個事件到達或流完成為止。 該函數標記有async
關鍵字,在使用await for
循環時需要此關鍵字。 以下示例通過使用async *
函數生成簡單的整數流來測試前面的代碼:
import 'dart:async';
Future<int> sumStream(Stream<int> stream) async {
var sum = 0;
await for (var value in stream) {
sum += value;
}
return sum;
}
Stream<int> countStream(int to) async* {
for (int i = 1; i <= to; i++) {
yield i;
}
}
main() async {
var stream = countStream(10);
var sum = await sumStream(stream);
print(sum); // 55
}
當流中沒有更多事件時,就完成流,并通知接收事件的代碼,就像通知新事件到來一樣。使用await for
循環讀取事件時,流完成后循環停止。 在某些情況下,流完成之前會發生錯誤;可能是網絡從遠程服務器上獲取文件時發生故障,或者創建事件的代碼存在錯誤,但是有人需要了解它。 流還可以傳遞錯誤事件,就像傳遞數據事件一樣。大多數流將在出現第一個錯誤后停止,但有可能傳遞多個錯誤的流以及在發生錯誤事件后傳遞更多數據的流。在本文檔中,我們僅討論最多產生一個錯誤的流。 當使用await for
讀取流時,循環語句會引發錯誤。這也結束了循環。您可以使用try-catch
捕獲錯誤。以下示例在循環迭代器等于時引發錯誤 4:
import 'dart:async';
Future<int> sumStream(Stream<int> stream) async {
var sum = 0;
try {
await for (var value in stream) {
sum += value;
}
} catch (e) {
return -1;
}
return sum;
}
Stream<int> countStream(int to) async* {
for (int i = 1; i <= to; i++) {
if (i == 4) {
throw new Exception('Intentional exception');
} else {
yield i;
}
}
}
main() async {
var stream = countStream(10);
var sum = await sumStream(stream);
print(sum); // -1
}
兩種Stream
單一訂閱流 最常見的流包含一系列事件,這些事件是較大整體的一部分。事件必須以正確的順序傳遞,并且不能丟失任何事件。這是您在讀取文件或接收Web
請求時獲得的流。 這樣的流只能被收聽一次。稍后再次收聽可能意味著錯過了最初的事件,然后其余部分毫無意義。當您開始收聽時,數據將被提取并以塊的形式提供。 廣播流 另一種流是針對可以一次處理的單個消息的。例如,這種流可用于瀏覽器中的鼠標事件。 您可以隨時開始收聽這樣的流,并且在收聽時會觸發事件。多個收聽者可以同時收聽,并且您可以在取消上一個訂閱之后稍后再次收聽。
Stream的方法
Future<T> get first;
Future<bool> get isEmpty;
Future<T> get last;
Future<int> get length;
Future<T> get single;
Future<bool> any(bool Function(T element) test);
Future<bool> contains(Object needle);
Future<E> drain<E>([E futureValue]);
Future<T> elementAt(int index);
Future<bool> every(bool Function(T element) test);
Future<T> firstWhere(bool Function(T element) test, {T Function() orElse});
Future<S> fold<S>(S initialValue, S Function(S previous, T element) combine);
Future forEach(void Function(T element) action);
Future<String> join([String separator = ""]);
Future<T> lastWhere(bool Function(T element) test, {T Function() orElse});
Future pipe(StreamConsumer<T> streamConsumer);
Future<T> reduce(T Function(T previous, T element) combine);
Future<T> singleWhere(bool Function(T element) test, {T Function() orElse});
Future<List<T>> toList();
Future<Set<T>> toSet();
這么多方法基本都可以使用await for
來循環
Future<bool> contains(Object needle) async {
await for (var event in this) {
if (event == needle) return true;
}
return false;
}
Future forEach(void Function(T element) action) async {
await for (var event in this) {
action(event);
}
}
Future<List<T>> toList() async {
final result = <T>[];
await this.forEach(result.add);
return result;
}
Future<String> join([String separator = ""]) async =>
(await this.toList()).join(separator);
修改Stream
Stream<R> cast<R>();
Stream<S> expand<S>(Iterable<S> Function(T element) convert);
Stream<S> map<S>(S Function(T event) convert);
Stream<T> skip(int count);
Stream<T> skipWhile(bool Function(T element) test);
Stream<T> take(int count);
Stream<T> takeWhile(bool Function(T element) test);
Stream<T> where(bool Function(T event) test);
這些基本都是使用閉包過濾流的內容,當然也可以轉換內容。
監聽Stream
最后是監聽,當流改變時會觸發監聽listen()
,所有的流都可以被監聽。
StreamSubscription<T> listen(void Function(T event) onData,
{Function onError, void Function() onDone, bool cancelOnError});
創建自己的Stream
創建Stream
大概有三種,如下所示:
- 轉換
Stram
- 使用
async*
創建Stream
- 使用
StreamController
創建
轉換Stram
經常有些Stream
包含的值不是我們想要的,那么就需要我們轉換一下了,例如我們把數字轉成字符串.
Future<String> _toString() async {
var s = await _stream().map((event) => event.toString()).join('|');
return s;
}
也可以轉成數組
Future<List> _toList() async {
var s = await _stream().toList();
return s;
}
使用async*
創建Stream
創建新流的一種方法是使用異步生成器(async *)
函數。在調用該函數時創建該流,并且在偵聽該流時該函數的主體開始運行。函數返回時,流關閉。在函數返回之前,它可以使用yield
或yield *
語句在流上發出事件。
這是一個原始示例,該示例會定期發射數字:
Stream<int> timedCounter(Duration interval, [int maxCount]) async* {
int i = 0;
while (true) {
await Future.delayed(interval);
yield i++;
if (i == maxCount) break;
}
}
此函數返回一個Stream
。當收聽該流時,主體開始運行。它反復延遲請求的時間間隔,然后產生下一個數字。如果忽略count
參數,則循環上沒有停止條件,因此流永遠輸出越來越大的數字-或直到偵聽器取消其訂閱為止。 當偵聽器取消時(通過在listen()
方法返回的StreamSubscription
對象上調用cancel()
),則主體下一次到達yield
語句時,yield
將充當return
語句。執行所有封閉的finally
塊,然后函數退出。如果函數嘗試在退出前產生一個值,則該操作將失敗并充當返回值。 當函數最終退出時,由cancel()
方法返回的Future
完成。如果函數以錯誤退出,則Future
會以該錯誤結束;否則,它以null
結束。 另一個更有用的示例是一個轉換序列的函數:
Stream<T> streamFromFutures<T>(Iterable<Future<T>> futures) async* {
for (var future in futures) {
var result = await future;
yield result;
}
}
使用yield*
使用yield*
來調用其他的函數取下一個值,當不獲取的時候,則不運行。
Stream<int> _stream() async* {
if (_count < 10) {
yield _count++;
await Future.delayed(Duration(seconds: 1));
sleep(Duration(seconds: 1));
yield* _getDataFromServer();
}
}
yield*
和yield
區別是后者直接返回一個固定的值,而前者返回是的是一個函數。前者多用于分流,把一個Stream<T>
分為其他的Stream<R>
或Stream<E>
。
使用StreamController
創建stream
_streamController = StreamController();
// 監聽
_streamController.stream.listen((event) { })
/// 添加數據
_streamController.add('data');
StreamControlelr
的類圖如下所示,他們從Sink
到StreamSink
都只是到導入接口,并無直接繼承關系,在抽象類方面按照功能解耦,最終由StreamController
整合,負責添加的是StreamControlelr
,負責監聽的是Stream
,最終在當前的Zone
中執行回調Zone.runUnaryGuarded()
。Zone
類似一個沙盒環境,在APP啟動的時候創建。
原理
StreamController
中初始化,直接調用了_SyncStreamController
,具體功能全部在_SyncStreamController
(同步)或_AsyncStreamController
(異步)中實現。
factory StreamController(
{void onListen(),
void onPause(),
void onResume(),
onCancel(),
bool sync: false}) {
return sync
? new _SyncStreamController<T>(onListen, onPause, onResume, onCancel)
: new _AsyncStreamController<T>(onListen, onPause, onResume, onCancel);
}
最終在_BufferingStreamSubscription
類中,實現了
onDone
和onError
函數,他們分別在類實例化的時候注冊回調函數。
void onData(void handleData(T event)) {
handleData ??= _nullDataHandler;//默認值
_onData = _zone.registerUnaryCallback<dynamic, T>(handleData);
}
void onDone(void handleDone()) {
handleDone ??= _nullDoneHandler;
_onDone = _zone.registerCallback(handleDone);
}
那么listener
函數是在何時添加的呢?
在獲取stream
是_ControllerStream()
,最終listener
函數是_StreamImpl extends Steam
中實現的,代碼如下:
StreamSubscription<T> listen(void onData(T data),
{Function onError, void onDone(), bool cancelOnError}) {
cancelOnError = identical(true, cancelOnError);
StreamSubscription<T> subscription =
_createSubscription(onData, onError, onDone, cancelOnError);
_onListen(subscription);
return subscription;
}
/// 創建一個訂閱者
StreamSubscription<T> _createSubscription(void onData(T data),
Function onError, void onDone(), bool cancelOnError) {
return new _BufferingStreamSubscription<T>(
onData, onError, onDone, cancelOnError);
}
最終監聽是執行的_BufferingStreamSubscription
的_onData(void HandleData(T event))
,這里是使用了_zone.registerUnaryCallback
來注冊回調函數,否則在調用的時候會報錯。
void onData(void handleData(T event)) {
handleData ??= _nullDataHandler;
_onData = _zone.registerUnaryCallback<dynamic, T>(handleData);
}
在stream.add()
函數執行了_add()
,源碼如下
void _add(T data) {
assert(!_isClosed);
if (_isCanceled) return;
if (_canFire) {
_sendData(data);
} else {
_addPending(new _DelayedData<T>(data));
}
}
當狀態已關閉,直接斷言,當狀態已取消,返回操作,當可以發送數據,則執行_sendData()
函數,該函數才是最終發送數據,執行listen
操作的關鍵函數,源碼如下:
void _sendData(T data) {
assert(!_isCanceled);
assert(!_isPaused);
assert(!_inCallback);
bool wasInputPaused = _isInputPaused;
_state |= _STATE_IN_CALLBACK;//取出來第六位
_zone.runUnaryGuarded(_onData, data);
_state &= ~_STATE_IN_CALLBACK;// 舍棄第六位
_checkState(wasInputPaused);
}
通過final Zone _zone = Zone.current;
獲取當前的Zone
來執行已經注冊的回調_zone.runUnaryGuarded(_onData, data)
,執行完畢,使用_state&=~_STATE_IN_CALLBACK
來保存當前狀態,使用&=~
舍棄第6位數字,_STATE_IN_CALLBACK
值為32,那么低第六位是1,~_STATE_IN_CALLBACK
,除了第六位,剩下的都是1
,然后&=
來取出來其他的位數值保存下來。
然后在_checkState(wasInutPaused)
來確定在執行callback
中間并無狀態改變。
那么再執行完畢_sendDone()
的時候也是如此,首先判斷是否已經取消,沒取消的話,執行_onDone
回調。
void _sendDone() {
assert(!_isCanceled);
assert(!_isPaused);
assert(!_inCallback);
void sendDone() {
// If the subscription has been canceled while waiting for the cancel
// future to finish we must not report the done event.
if (!_waitsForCancel) return;
_state |= (_STATE_CANCELED | _STATE_CLOSED | _STATE_IN_CALLBACK);
_zone.runGuarded(_onDone);
_state &= ~_STATE_IN_CALLBACK;
}
_cancel();
_state |= _STATE_WAIT_FOR_CANCEL;
if (_cancelFuture != null &&
!identical(_cancelFuture, Future._nullFuture)) {
_cancelFuture.whenComplete(sendDone);
} else {
sendDone();
}
}
事件流就是在前期使用Zone
注冊,在add
的時候使用Zone
調用已經注冊好的回調,廣播是循環調用
關鍵函數:
/// 注冊回調
_zone.registerUnaryCallback<dynamic, T>(handleData)
/// 注冊不帶參數的回調
_zone.registerCallback(R callback())
/// 執行 附帶參數的回調
_zone.runUnaryGuarded(_onData, data)
更多API
可以查看官方源碼。
參考
文章匯總
<<Flutter 詳解(一、深入了解狀態管理--ScopeModel)>>
<<Flutter 詳解(二、深入了解狀態管理--Redux)>>
<<Flutter 詳解(三、深入了解狀態管理--Provider)>>
<<Flutter 詳解(四、深入了解狀態管理--BLoC)>>