跨平台开发 / 系统课时
用 Provider 注入 Repository
用 Provider 注入 Repository
Repository 不应该自己到处创建网络客户端、数据库对象或缓存实例。把这些底层依赖交给 Provider 组装,可以让上层只依赖稳定的数据接口,同时保留替换实现、测试覆盖和统一管理生命周期的空间。
学习目标
- 使用 Provider 建立客户端到 Repository 的依赖关系
- 理解为什么 Repository 应通过构造函数接收底层依赖
- 能从上层读取 Repository,而不直接接触客户端实现
把依赖组装留给 Provider
假设商品数据来自一个 API 客户端。业务层真正需要的是“获取商品”这个能力,而不是知道请求地址、连接方式或客户端如何创建。因此可以把依赖拆成两层:底层 Provider 提供客户端,上层 Provider 根据它创建 Repository。

下面的示例可以直接放进已添加 flutter_riverpod 依赖的 Dart/Flutter 项目中运行。这里用内存结果代替真实 HTTP 请求,重点观察依赖如何被组装。
import 'package:flutter_riverpod/flutter_riverpod.dart';
class ApiClient {
ApiClient({required this.baseUrl});
final String baseUrl;
Future<List<String>> getProducts() async {
return ['Keyboard', 'Mouse'];
}
}
class CatalogRepository {
CatalogRepository(this._client);
final ApiClient _client;
Future<List<String>> fetchProducts() {
return _client.getProducts();
}
}
final apiClientProvider = Provider<ApiClient>((ref) {
return ApiClient(baseUrl: 'https://api.example.com');
});
final catalogRepositoryProvider = Provider<CatalogRepository>((ref) {
final client = ref.watch(apiClientProvider);
return CatalogRepository(client);
});
Future<void> main() async {
final container = ProviderContainer();
final repository = container.read(catalogRepositoryProvider);
final products = await repository.fetchProducts();
print(products);
container.dispose();
}预期输出
[Keyboard, Mouse]CatalogRepository 不调用 ApiClient() 构造函数,而是通过构造参数接收客户端。这一点很重要:Repository 只描述自己的依赖,不负责决定依赖如何创建。真正的对象组装集中在 catalogRepositoryProvider 中。
为什么使用 ref.watch
在 Repository Provider 内使用 ref.watch(apiClientProvider),表示 Repository 的实例依赖客户端 Provider。如果客户端 Provider 因为作用域覆盖或其他依赖变化而产生新值,Riverpod 可以据此重新计算 Repository。
对于应用级、不可变的客户端,这种重新计算通常很少发生;但依赖关系仍然被明确记录下来。相比在 Repository 内直接 ApiClient(),这种写法更容易测试,也更容易按开发、测试或不同环境替换实现。
向上层暴露稳定接口
UI 或 Notifier 通常只需要读取 catalogRepositoryProvider,再调用 fetchProducts()。它们不需要知道 Repository 背后使用 REST、SQLite 还是内存缓存。
这种边界使依赖方向保持简单:客户端处理底层访问,Repository 提供面向业务的数据接口,上层只消费 Repository。以后替换底层实现时,上层代码可以保持不变。
测试时也可以直接覆盖 catalogRepositoryProvider 或它依赖的 apiClientProvider,把真实外部访问替换成可控实现,而不必修改生产代码。Provider 因而不仅是“全局取对象”的工具,更承担了依赖组合点的职责。