跨平台开发 / 系统课时

让 Provider 依赖另一个 Provider

让 Provider 依赖另一个 Provider

本篇学习 Riverpod 中 Provider 之间的组合方式,通过 ref.watch 建立依赖链,让一个 Provider 根据另一个 Provider 的变化自动重新计算派生结果。

学习目标

  • 理解 Provider 之间依赖关系的表达方式。
  • 掌握在 Provider 内部使用 ref.watch 获取其他 Provider。
  • 能设计简单的派生依赖结构。

Provider 组合解决什么问题

实际应用中,一个依赖通常不会独立存在。例如用户信息需要依赖 API 仓库,格式化显示名称可能又依赖用户信息。如果每个地方都重复创建这些逻辑,代码会逐渐失去统一入口。

Riverpod 允许 Provider 读取其他 Provider,从而形成依赖链。当上游依赖发生变化时,下游 Provider 会自动失效并重新计算。

Provider 依赖链关系示意图

使用 ref.watch 建立依赖

下面示例中,用户名称 Provider 依赖用户仓库 Provider。

dart
import 'package:flutter_riverpod/flutter_riverpod.dart';

class UserRepository {
  String fetchName() {
    return 'Riverpod User';
  }
}

final userRepositoryProvider = Provider<UserRepository>((ref) {
  return UserRepository();
});

final userNameProvider = Provider<String>((ref) {
  final repository = ref.watch(userRepositoryProvider);
  return repository.fetchName();
});

void main() {
  final container = ProviderContainer();

  final name = container.read(userNameProvider);
  print(name);

  container.dispose();
}

预期输出

text
Riverpod User

ref.watch 表示当前 Provider 声明了依赖关系。Riverpod 会记录这种关系,并在依赖变化时重新执行当前 Provider。

watch 与 read 的区别

在 Provider 内部获取其他 Provider 时,通常应该使用 ref.watch,因为它能够建立响应式关系。

方法 作用 是否建立依赖
ref.watch 读取并监听变化 是
ref.read 单次读取当前值 否

如果只是执行一次动作,例如按钮点击时调用仓库方法,可以使用 ref.read。如果计算结果需要随着依赖变化自动更新,则必须使用 ref.watch。

创建派生状态

Provider 组合最常见的用途是创建派生状态。派生状态不是独立保存的数据,而是根据已有数据计算得到的结果。

例如根据用户设置生成显示文本:

dart
import 'package:flutter_riverpod/flutter_riverpod.dart';

final languageProvider = Provider<String>((ref) {
  return 'zh-CN';
});

final localeTextProvider = Provider<String>((ref) {
  final language = ref.watch(languageProvider);

  if (language == 'zh-CN') {
    return '中文模式';
  }

  return 'English Mode';
});

预期结果

text
当 languageProvider 返回 zh-CN 时,localeTextProvider 返回 中文模式。

这种方式避免保存重复状态。例如不需要同时维护 language 和 localeText 两份数据,只保存源数据即可。

设计 Provider 依赖时的注意点

Provider 组合应该保持单向依赖。底层服务可以被上层业务 Provider 使用,但基础 Provider 不应该反过来依赖页面状态,否则容易形成复杂的循环关系。

常见结构是:

  • 基础 Provider:提供服务和配置。
  • 业务 Provider:组合多个基础依赖,生成业务数据。
  • Widget:读取最终结果并展示。

当一个 Provider 只是另一个值的简单转换时,优先使用 Provider 组合,而不是复制数据或手动同步状态。这样可以让状态来源保持唯一,减少更新遗漏的问题。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

让 Provider 依赖另一个 Provider

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通