FutureProvider

FutureProvider 与 Provider 类似，但用在异步代码中。

FutureProvider 一般用于：

执行和缓存异步操作 (比如网络请求)
能很好地处理异步操作中的错误/加载中的状态
将多个异步的值组合为另一个异步的值

FutureProvider 与 ref.watch 结合使用有很多好处。这种组合允许在某些变量改变时自动重新获取一些数据，确保我们总是拥有最新的值。

信息

FutureProvider 不提供给用户交互后直接修改计算结果的方法。它被设计用来解决简单的用例。对于更高级的场景请考虑使用 StateNotifierProvider 。

用法示例：读取配置文件

FutureProvider 可以是一种通过读取JSON文件创建的 Configuration 对象的便捷方法。

在provider内部使用的async/await语法创建配置。再加上使用Flutter的资产系统，举个例子：

@riverpod
Future<Configuration> fetchConfiguration(FetchConfigurationRef ref) async {
  final content = json.decode(
    await rootBundle.loadString('assets/configurations.json'),
  ) as Map<String, Object?>;

  return Configuration.fromJson(content);
}

接着，UI可以像这样监听配置：

Widget build(BuildContext context, WidgetRef ref) {
  final config = ref.watch(fetchConfigurationProvider);

  return config.when(
    loading: () => const CircularProgressIndicator(),
    error: (err, stack) => Text('Error: $err'),
    data: (config) {
      return Text(config.host);
    },
  );
}

这将在 Future 完成时自动重新构建UI。同时，如果多个widget需要配置，Flutter资产将只载入一次。

如你所见，在widget中监听 FutureProvider 会返回一个 AsyncValue ，它允许你处理错误/加载中的状态。

用法示例：读取配置文件​

用法示例：读取配置文件