跨平台开发 / 系统课时

用 Provider 暴露只读依赖

用 Provider 暴露只读依赖

本篇介绍如何使用 Riverpod 的 Provider 封装仓库、配置和纯计算结果,让应用中的其他状态逻辑以只读方式安全复用这些依赖,并建立清晰的依赖边界。

学习目标

  • 理解 Provider 在 Riverpod 中作为只读依赖容器的作用。
  • 掌握使用 Provider 暴露对象、配置和计算结果的方法。
  • 能根据业务场景判断哪些内容适合放入 Provider。

为什么需要只读 Provider

在 Flutter 应用中,很多对象并不是状态本身,而是被多个状态逻辑共同使用的依赖,例如 API 客户端、数据仓库、环境配置或格式化规则。如果这些对象直接在页面中创建,会导致依赖分散、测试困难,也容易产生生命周期管理问题。

Provider 的职责是创建并暴露一个值,但不负责保存可变业务状态。其他 Provider 或 Widget 可以读取这个值,但不能直接修改它,因此非常适合表达只读依赖。

创建一个基础 Provider

Riverpod 使用顶层声明的 Provider 描述依赖关系。下面示例创建一个只读仓库 Provider,供其他代码读取。

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

class UserRepository {
  String findUserName(String id) {
    return 'user-$id';
  }
}

// Provider 负责创建并共享只读仓库实例。
final userRepositoryProvider = Provider<UserRepository>((ref) {
  return UserRepository();
});

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

  final repository = container.read(userRepositoryProvider);
  print(repository.findUserName('001'));

  container.dispose();
}

预期输出

text
user-001

ProviderContainer 通常用于测试或非 Widget 环境。在 Flutter 页面中,更常见的是通过 ref.read 或 ref.watch 访问 Provider。

Provider 适合保存哪些内容

Provider 不保存会变化的业务状态,而是提供稳定依赖。常见使用场景包括:

类型 示例 是否适合 Provider
数据仓库 UserRepository、OrderRepository 适合
网络客户端 ApiClient、HttpClient 封装 适合
应用配置 BaseUrl、环境参数 适合
计算结果 常量转换、规则对象 适合
用户输入状态 表单内容、计数器 不适合

如果一个对象需要随着用户操作不断变化,通常应该使用 StateProvider、NotifierProvider 等可变状态方案,而不是普通 Provider。

使用 Provider 管理配置依赖

配置类也是 Provider 的典型使用场景。例如不同环境使用不同接口地址,可以把配置集中管理。

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

class AppConfig {
  final String apiUrl;

  const AppConfig(this.apiUrl);
}

final appConfigProvider = Provider<AppConfig>((ref) {
  return const AppConfig('https://api.example.com');
});

void printApiUrl(ProviderContainer container) {
  final config = container.read(appConfigProvider);
  print(config.apiUrl);
}

预期结果

text
https://api.example.com

通过这种方式,业务逻辑不需要知道配置对象如何创建,只需要声明依赖即可。

Provider 与状态 Provider 的边界

实际开发中容易混淆 Provider 和状态管理 Provider。判断标准不是对象大小,而是对象是否需要主动变化。

只读依赖通常具有以下特点:

  • 创建后基本不变。
  • 由应用结构决定,而不是用户操作决定。
  • 被多个地方共享使用。

例如数据库连接、日志服务、仓库对象适合使用 Provider;购物车数量、登录状态、搜索关键词则应该使用可变状态管理。

合理划分 Provider,可以让 Riverpod 的依赖关系更加清晰,也方便后续通过测试替换真实实现。

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

目录与阅读设置

阅读设置

17

记录一个想法

用 Provider 暴露只读依赖

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

登录哪都通