likes
comments
collection
share

[译][官方文档] Flutter/Dart 状态管理库 Riverpod - 概要 - 饿汉式 provider

作者站长头像
站长
· 阅读数 9

!!!译文为作者本人人肉翻译~转载请注明出处!!!


原文链接:Eager initialization of providers | Riverpod

pub:riverpod | Dart Package (flutter-io.cn)

译时版本: 2.4.9



饿汉式 provider

所有的 provider 默认都是初始化为懒汉式。这意味着 provider 只会在第一次被读取时初始化。这对于只在应用的特定部分使用的 provider 是有用的。

不幸的是,由于 Dart 的机制(为了 tree shaking)无法将一个 provider 标记为需要饿汉式初始化。尽管如此,一个解决方案是在应用的根节点上强制读取想要饿汉式初始化的 provider 。

一个推荐的方式是紧接在 ProviderScope 之后放置一个消费者,在消费者中 "watch" (监控) provider :

void main() {
  runApp(ProviderScope(child: MyApp()));
}

class MyApp extends StatelessWidget {
  @override
  Widget build(BuildContext context) {
    return const _EagerInitialization(
      // TODO: 在这里渲染 APP
      child: MaterialApp(),
    );
  }
}

class _EagerInitialization extends ConsumerWidget {
  const _EagerInitialization({required this.child});
  final Widget child;

  @override
  Widget build(BuildContext context, WidgetRef ref) {
    // 通过监控它们实现饿汉式初始化 provider 。
    // 使用 "watch" ,provider 会保持存活而且不会被清除。
    ref.watch(myProvider);
    return child;
  }
}

注意

可以考虑在 "MyApp" 或一个公开组件中放置初始化的消费者。 这可以让测试使用相同的行为,通过从 main 中移除业务逻辑。

常见问题

provider 改变时不会重新构建整个应用吗?

不,不会是这种情况。在上面给的例子中,消费者是在独立的组件中负责饿汉式的初始化,这不会做其他任何处理,只会返回一个 child

关键的部分是它返回一个 child ,而不是初始化 MaterialApp 本身。这意味着如果 _EagerInitialization 进行了重新构建,child 变量也不会再改变。 只要组件没有发生改变,Flutter 就不会重新构建它。

因此,只有其它组件也监听了同一个 provider , _EagerInitialization 才会重新构建。

使用这种方式,如何处理加载中和错误状态?

可以正常地像在 Consumer 中一样处理加载中/错误状态。 _EagerInitialization 会检查 provider 是否处于“加载中”的状态,如果是“加载中”状态的话,会返回 CircularProgressIndicator 而不是 child

class _EagerInitialization extends ConsumerWidget {
  const _EagerInitialization({required this.child});
  final Widget child;

  @override
  Widget build(BuildContext context, WidgetRef ref) {
    final result = ref.watch(myProvider);

    // 处理错误状态和加载中状态
    if (result.isLoading) {
      return const CircularProgressIndicator();
    } else if (result.hasError) {
      return const Text('Oopsy!');
    }

    return child;
  }
}

已经处理了加载中/错误状态,但是其它消费者还是会接收 AsyncValue (异步值)!是否有无需在每个组件中都处理加载中/错误状态的方法?

如果想要 provider 暴露 AsyncValue (异步值),可以让组件使用 AsyncValue.requireValue

这会读取数据而无需进行模式匹配。万一有 BUG ,会抛出带有明确信息的异常。

// 饿汉式初始化的 provider 。
@riverpod
Future<String> example(ExampleRef ref) async => 'Hello world';

class MyConsumer extends ConsumerWidget {
  @override
  Widget build(BuildContext context, WidgetRef ref) {
    final result = ref.watch(exampleProvider);

    /// 如果 provider 正确地被饿汉式初始化,之后就可以直接用 "requireValue" 读取数据。
    return Text(result.requireValue);
  }
}

注意

尽管可以在这些场景(依赖作用域)下有这些不暴露加载中/错误状态的方式,通常也不建议这么做。 创建两个 provider 和使用覆写带来的复杂性不值得这么麻烦去做。


转载自:https://juejin.cn/post/7307658030896201767
评论
请登录