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);
  }
}