数据层
应用的数据层，在 MVVM 术语中称为 模型 (model)，是所有应用数据的真实来源。作为真实来源，它是应用数据唯一应该更新的地方。
它负责从各种外部 API 获取数据，将数据暴露给 UI，处理需要更新数据的 UI 事件，并根据需要向这些外部 API 发送更新请求。
本指南中的数据层有两个主要组件：仓库 (repositories) 和服务 (services)。
- 仓库是应用数据的真实来源，包含与数据相关的逻辑，例如响应新用户事件更新数据或从服务轮询数据。仓库负责在支持离线功能时同步数据，管理重试逻辑和缓存数据。
- 服务是无状态的 Dart 类，与 API 进行交互，例如 HTTP 服务器和平台插件。应用所需的任何非应用代码本身创建的数据都应从服务类中获取。
定义服务
#服务类是所有架构组件中最清晰的。它是无状态的，其函数没有副作用。它的唯一工作是包装外部 API。通常每个数据源（例如客户端 HTTP 服务器或平台插件）对应一个服务类。
例如，在 Compass 应用中，有一个 APIClient 服务用于处理面向客户端服务器的 CRUD 调用。
class ApiClient {
// Some code omitted for demo purposes.
Future<Result<List<ContinentApiModel>>> getContinents() async { /* ... */ }
Future<Result<List<DestinationApiModel>>> getDestinations() async { /* ... */ }
Future<Result<List<ActivityApiModel>>> getActivityByDestination(String ref) async { /* ... */ }
Future<Result<List<BookingApiModel>>> getBookings() async { /* ... */ }
Future<Result<BookingApiModel>> getBooking(int id) async { /* ... */ }
Future<Result<BookingApiModel>> postBooking(BookingApiModel booking) async { /* ... */ }
Future<Result<void>> deleteBooking(int id) async { /* ... */ }
Future<Result<UserApiModel>> getUser() async { /* ... */ }
}服务本身是一个类，每个方法都包装不同的 API 端点并暴露异步响应对象。继续前面删除已保存预订的示例，deleteBooking 方法返回一个 Future<Result<void>>。
定义仓库
#仓库的唯一职责是管理应用数据。仓库是单一类型应用数据的真实来源，并且应该是该数据类型唯一可变的地方。仓库负责从外部源轮询新数据，处理重试逻辑，管理缓存数据，并将原始数据转换为领域模型。
你应该为应用中每种不同类型的数据设置一个单独的仓库。例如，Compass 应用有名为 UserRepository、BookingRepository、AuthRepository、DestinationRepository 等仓库。
以下示例是 Compass 应用中的 BookingRepository，它展示了仓库的基本结构。
class BookingRepositoryRemote implements BookingRepository {
BookingRepositoryRemote({
required ApiClient apiClient,
}) : _apiClient = apiClient;
final ApiClient _apiClient;
List<Destination>? _cachedDestinations;
Future<Result<void>> createBooking(Booking booking) async {...}
Future<Result<Booking>> getBooking(int id) async {...}
Future<Result<List<BookingSummary>>> getBookingsList() async {...}
Future<Result<void>> delete(int id) async {...}
}BookingRepository 将 ApiClient 服务作为输入，并使用它来获取和更新服务器上的原始数据。重要的是该服务是私有成员，这样 UI 层就不能绕过仓库直接调用服务。
通过 ApiClient 服务，仓库可以轮询用户已保存预订的更新（这些更新可能发生在服务器上），并发送 POST 请求以删除已保存的预订。
仓库转换为应用模型的原始数据可以来自多个来源和多个服务，因此仓库和服务之间存在多对多的关系。一个服务可以被任意数量的仓库使用，一个仓库也可以使用多个服务。
领域模型
#BookingRepository 输出 Booking 和 BookingSummary 对象，它们是领域模型。所有仓库都输出相应的领域模型。这些数据模型与 API 模型不同之处在于，它们只包含应用其他部分所需的数据。API 模型包含原始数据，这些数据通常需要经过过滤、组合或删除才能对应用的视图模型有用。仓库对原始数据进行提炼，并将其作为领域模型输出。
在示例应用中，领域模型通过 BookingRepository.getBooking 等方法的返回值暴露。getBooking 方法负责从 ApiClient 服务获取原始数据，并将其转换为 Booking 对象。它通过组合来自多个服务端点的数据来完成此操作。
// This method was edited for brevity.
Future<Result<Booking>> getBooking(int id) async {
try {
// Get the booking by ID from server.
final resultBooking = await _apiClient.getBooking(id);
if (resultBooking is Error<BookingApiModel>) {
return Result.error(resultBooking.error);
}
final booking = resultBooking.asOk.value;
final destination = _apiClient.getDestination(booking.destinationRef);
final activities = _apiClient.getActivitiesForBooking(
booking.activitiesRef);
return Result.ok(
Booking(
startDate: booking.startDate,
endDate: booking.endDate,
destination: destination,
activity: activities,
),
);
} on Exception catch (e) {
return Result.error(e);
}
}完成事件周期
#在本页中，你已经看到了用户如何删除已保存的预订，从一个事件开始——用户在一个 Dismissible 组件上滑动。视图模型通过将实际的数据变异委托给 BookingRepository 来处理该事件。以下代码片段显示了 BookingRepository.deleteBooking 方法。
Future<Result<void>> delete(int id) async {
try {
return _apiClient.deleteBooking(id);
} on Exception catch (e) {
return Result.error(e);
}
}仓库通过 _apiClient.deleteBooking 方法向 API 客户端发送一个 POST 请求，并返回一个 Result。HomeViewModel 消耗 Result 及其包含的数据，然后最终调用 notifyListeners，完成整个周期。
反馈
#随着本网站此部分的不断发展，我们欢迎你的反馈！