跨平台开发 / 系统课时
用 Provider 暴露只读依赖
用 Provider 暴露只读依赖
本篇介绍如何使用 Riverpod 的 Provider 封装仓库、配置和纯计算结果,让应用中的其他状态逻辑以只读方式安全复用这些依赖,并建立清晰的依赖边界。
学习目标
- 理解 Provider 在 Riverpod 中作为只读依赖容器的作用。
- 掌握使用 Provider 暴露对象、配置和计算结果的方法。
- 能根据业务场景判断哪些内容适合放入 Provider。
为什么需要只读 Provider
在 Flutter 应用中,很多对象并不是状态本身,而是被多个状态逻辑共同使用的依赖,例如 API 客户端、数据仓库、环境配置或格式化规则。如果这些对象直接在页面中创建,会导致依赖分散、测试困难,也容易产生生命周期管理问题。
Provider 的职责是创建并暴露一个值,但不负责保存可变业务状态。其他 Provider 或 Widget 可以读取这个值,但不能直接修改它,因此非常适合表达只读依赖。
创建一个基础 Provider
Riverpod 使用顶层声明的 Provider 描述依赖关系。下面示例创建一个只读仓库 Provider,供其他代码读取。
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();
}预期输出
user-001ProviderContainer 通常用于测试或非 Widget 环境。在 Flutter 页面中,更常见的是通过 ref.read 或 ref.watch 访问 Provider。
Provider 适合保存哪些内容
Provider 不保存会变化的业务状态,而是提供稳定依赖。常见使用场景包括:
| 类型 | 示例 | 是否适合 Provider |
|---|---|---|
| 数据仓库 | UserRepository、OrderRepository | 适合 |
| 网络客户端 | ApiClient、HttpClient 封装 | 适合 |
| 应用配置 | BaseUrl、环境参数 | 适合 |
| 计算结果 | 常量转换、规则对象 | 适合 |
| 用户输入状态 | 表单内容、计数器 | 不适合 |
如果一个对象需要随着用户操作不断变化,通常应该使用 StateProvider、NotifierProvider 等可变状态方案,而不是普通 Provider。
使用 Provider 管理配置依赖
配置类也是 Provider 的典型使用场景。例如不同环境使用不同接口地址,可以把配置集中管理。
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);
}预期结果
https://api.example.com通过这种方式,业务逻辑不需要知道配置对象如何创建,只需要声明依赖即可。
Provider 与状态 Provider 的边界
实际开发中容易混淆 Provider 和状态管理 Provider。判断标准不是对象大小,而是对象是否需要主动变化。
只读依赖通常具有以下特点:
- 创建后基本不变。
- 由应用结构决定,而不是用户操作决定。
- 被多个地方共享使用。
例如数据库连接、日志服务、仓库对象适合使用 Provider;购物车数量、登录状态、搜索关键词则应该使用可变状态管理。
合理划分 Provider,可以让 Riverpod 的依赖关系更加清晰,也方便后续通过测试替换真实实现。