Completer<T> 类 抽象 接口

一种产生Future对象并在以后通过值或错误来完成它们的方法。

大多数情况下，创建Future最简单的方法是使用Future构造函数之一来捕获单一异步计算的结果

Future(() { doSomething(); return result; });

或者，如果Future代表一系列异步计算的结果，可以使用Future.then或在Future上类似的功能进行链式调用

Future doStuff(){
  return someAsyncOperation().then((result) {
    return someOtherAsyncOperation(result);
  });
}

如果您确实需要从头开始创建Future - 例如，当您正在将基于回调的API转换为基于Future的API时 - 您可以使用Completer如下所示

class AsyncOperation {
  final Completer _completer = new Completer();

  Future<T> doOperation() {
    _startOperation();
    return _completer.future; // Send future object back to client.
  }

  // Something calls this when the value is ready.
  void _finishOperation(T result) {
    _completer.complete(result);
  }

  // If something goes wrong, call this.
  void _errorHappened(error) {
    _completer.completeError(error);
  }
}