跨平台开发 / 系统课时

拆分 RemoteDataSource 职责

拆分 RemoteDataSource 职责

当页面、Repository 甚至业务服务都直接调用 Dio 时,请求路径、状态码、异常和 JSON 解析会散落在各层。把这些细节收进 RemoteDataSource 后,上层只表达“获取什么数据”,网络库则被限制在数据访问边界内。

学习目标

  • 划清 RemoteDataSource、Repository 与 Dio 的职责边界
  • 用接口隔离上层代码对 Dio 的直接依赖
  • 验证远程数据源能够集中处理请求、解析与传输异常

RemoteDataSource 应该负责什么

RemoteDataSource 面向“远程系统”而不是页面。它接收已经整理好的查询参数或 ID,发起 HTTP 请求,把响应 JSON 转成 DTO,并把 Dio 的异常限制在数据层内部。Repository 再决定是否组合缓存、转换领域对象或执行回退策略。

RemoteDataSource 分层与数据流

一个实用的边界可以这样判断:只要代码需要知道 URL、HTTP 方法、请求头、Dio 的 Response 或 DioException,它通常就应该留在 RemoteDataSource;如果代码在判断“先读缓存还是访问网络”“失败后是否使用旧数据”,则更适合放在 Repository。

用接口把 Dio 留在实现内部

下面示例可直接放进已添加 dio 依赖的 Dart/Flutter 工程。为了让结果稳定,示例使用 Dio 拦截器在进程内返回固定响应,不访问真实服务器。Dio 的 get<T> 会返回带 data 等字段的 Response<T>,这里把它限制在具体数据源实现中。 ([Dart packages][1])

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

class UserDto {
  const UserDto({required this.id, required this.name});

  final int id;
  final String name;

  factory UserDto.fromJson(Map<String, dynamic> json) {
    return UserDto(
      id: json['id'] as int,
      name: json['name'] as String,
    );
  }
}

abstract class RemoteDataSource {
  Future<UserDto> fetchUser(int id);
}

class DioRemoteDataSource implements RemoteDataSource {
  DioRemoteDataSource(this._dio);

  final Dio _dio;

  @override
  Future<UserDto> fetchUser(int id) async {
    try {
      final response =
          await _dio.get<Map<String, dynamic>>('/users/$id');
      final data = response.data;
      if (data == null) {
        throw StateError('Remote response body is empty');
      }
      return UserDto.fromJson(data);
    } on DioException catch (error) {
      throw StateError('Remote request failed: ${error.type.name}');
    }
  }
}

class UserRepository {
  UserRepository(this._remote);

  final RemoteDataSource _remote;

  Future<String> loadUserName(int id) async {
    final dto = await _remote.fetchUser(id);
    return dto.name;
  }
}

Future<void> main() async {
  final dio = Dio(BaseOptions(baseUrl: 'https://api.example.test'));

  // 在本地拦截请求,避免示例依赖外部网络。
  dio.interceptors.add(
    InterceptorsWrapper(
      onRequest: (options, handler) {
        handler.resolve(
          Response<Map<String, dynamic>>(
            requestOptions: options,
            statusCode: 200,
            data: <String, dynamic>{'id': 42, 'name': 'Ada'},
          ),
        );
      },
    ),
  );

  final repository = UserRepository(DioRemoteDataSource(dio));
  print(await repository.loadUserName(42));
}

预期输出

text
Ada

此时 UserRepository 只认识 RemoteDataSource,既不导入 Dio,也不读取状态码。以后把 Dio 换成其他 HTTP 客户端,主要修改具体数据源与依赖装配,而不是逐个改页面和 Repository。

不要把业务决策塞进远程数据源

RemoteDataSource 可以负责请求参数编码、响应 DTO 解析以及网络层异常归一化,但不宜决定“无网络时是否读取缓存”“用户是否有权限查看该数据”这类业务策略。否则它会从 HTTP 适配器膨胀成难以复用的业务服务。

同样,不要让它直接返回 Response。一旦 Repository 开始读取 statusCode、headers 或 DioException,网络库又穿透了抽象边界。更稳妥的做法是返回 DTO、分页结果等数据层类型,并用本项目自己的异常类型描述远程失败。

什么时候值得拆分

当项目只有一个临时页面和一次请求时,额外接口可能显得繁琐;但只要多个功能共享认证、错误处理、JSON 解析或测试替身,RemoteDataSource 就能明显降低耦合。判断是否拆分的核心不是文件数量,而是上层是否需要知道“这份数据具体通过 Dio 怎样拿到”。如果答案是否定的,就应该把这些细节关在远程数据源里。

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

目录与阅读设置

阅读设置

17

记录一个想法

拆分 RemoteDataSource 职责

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

登录哪都通