异步编程

Dart 库中充满了返回 Future 或 Stream 对象的函数。这些函数是异步的：它们在设置一个可能耗时的操作（例如 I/O）后立即返回，而无需等待该操作完成。

async 和 await 关键字支持异步编程，让您能够编写看起来与同步代码相似的异步代码。

当您需要已完成 Future 的结果时，您有两种选择

• 使用 async 和 await，如本文和异步编程教程中所述。
• 使用 Future API，如dart:async 文档中所述。

使用 async 和 await 的代码是异步的，但它看起来很像同步代码。例如，以下代码使用 await 等待异步函数的结果

await lookUpVersion();

要使用 await，代码必须在 async 函数中——即标记为 async 的函数

Future<void> checkVersion() async {
  var version = await lookUpVersion();
  // Do something with version
}

在使用 await 的代码中，使用 try、catch 和 finally 来处理错误和清理

try {
  version = await lookUpVersion();
} catch (e) {
  // React to inability to look up the version
}

您可以在 async 函数中多次使用 await。例如，以下代码三次等待函数的结果

var entrypoint = await findEntryPoint();
var exitCode = await runExecutable(entrypoint, args);
await flushThenExit(exitCode);

在 await expression 中，expression 的值通常是 Future；如果不是，则该值会自动包装在 Future 中。此 Future 对象表示返回对象的承诺。await expression 的值是该返回的对象。await 表达式会使执行暂停，直到该对象可用。

如果在 await 时遇到编译时错误，请确保 await 位于 async 函数中。例如，要在应用的 main() 函数中使用 await，main() 的函数体必须标记为 async

void main() async {
  checkVersion();
  print('In main: version is ${await lookUpVersion()}');
}

有关使用 Future、async 和 await 的交互式介绍，请参阅异步编程教程。

async 函数是其函数体用 async 修饰符标记的函数。

将 async 关键字添加到函数会使其返回一个 Future。例如，考虑这个返回 String 的同步函数

String lookUpVersion() => '1.0.0';

如果您将其更改为 async 函数——例如，因为未来的实现将是耗时的——那么返回的值将是一个 Future

Future<String> lookUpVersion() async => '1.0.0';

请注意，函数的函数体不需要使用 Future API。如有必要，Dart 会创建 Future 对象。如果您的函数不返回有用的值，请将其返回类型设置为 Future<void>。

有关使用 Future、async 和 await 的交互式介绍，请参阅异步编程教程。

当您需要从 Stream 获取值时，您有两种选择

• 使用 async 和异步 for 循环 (await for)。
• 使用 Stream API，如dart:async 文档中所述。

异步 for 循环具有以下形式

await for (varOrType identifier in expression) {
  // Executes each time the stream emits a value.
}

表达式 的值必须是 Stream 类型。执行过程如下

1. 等待直到 Stream 发出一个值。
2. 执行 for 循环体，并将变量设置为该发出的值。
3. 重复 1 和 2，直到 Stream 关闭。

要停止监听 Stream，您可以使用 break 或 return 语句，它们会跳出 for 循环并取消订阅 Stream。

如果在实现异步 for 循环时遇到编译时错误，请确保 await for 位于 async 函数中。例如，要在应用的 main() 函数中使用异步 for 循环，main() 的函数体必须标记为 async

void main() async {
  // ...
  await for (final request in requestServer) {
    handleRequest(request);
  }
  // ...
}

有关 Dart 异步编程支持的更多信息，请查阅 dart:async 库文档。