跨平台开发 / 系统课时

用 Provider 注入 Repository

用 Provider 注入 Repository

Repository 不应该自己到处创建网络客户端、数据库对象或缓存实例。把这些底层依赖交给 Provider 组装,可以让上层只依赖稳定的数据接口,同时保留替换实现、测试覆盖和统一管理生命周期的空间。

学习目标

  • 使用 Provider 建立客户端到 Repository 的依赖关系
  • 理解为什么 Repository 应通过构造函数接收底层依赖
  • 能从上层读取 Repository,而不直接接触客户端实现

把依赖组装留给 Provider

假设商品数据来自一个 API 客户端。业务层真正需要的是“获取商品”这个能力,而不是知道请求地址、连接方式或客户端如何创建。因此可以把依赖拆成两层:底层 Provider 提供客户端,上层 Provider 根据它创建 Repository。

ApiClient、Repository 与上层消费者的依赖注入关系

下面的示例可以直接放进已添加 flutter_riverpod 依赖的 Dart/Flutter 项目中运行。这里用内存结果代替真实 HTTP 请求,重点观察依赖如何被组装。

dart
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();
}

预期输出

text
[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 因而不仅是“全局取对象”的工具,更承担了依赖组合点的职责。

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

目录与阅读设置

阅读设置

17

记录一个想法

用 Provider 注入 Repository

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

登录哪都通