跨平台开发 / 系统课时
拆分 RemoteDataSource 职责
拆分 RemoteDataSource 职责
当页面、Repository 甚至业务服务都直接调用 Dio 时,请求路径、状态码、异常和 JSON 解析会散落在各层。把这些细节收进 RemoteDataSource 后,上层只表达“获取什么数据”,网络库则被限制在数据访问边界内。
学习目标
- 划清 RemoteDataSource、Repository 与 Dio 的职责边界
- 用接口隔离上层代码对 Dio 的直接依赖
- 验证远程数据源能够集中处理请求、解析与传输异常
RemoteDataSource 应该负责什么
RemoteDataSource 面向“远程系统”而不是页面。它接收已经整理好的查询参数或 ID,发起 HTTP 请求,把响应 JSON 转成 DTO,并把 Dio 的异常限制在数据层内部。Repository 再决定是否组合缓存、转换领域对象或执行回退策略。

一个实用的边界可以这样判断:只要代码需要知道 URL、HTTP 方法、请求头、Dio 的 Response 或 DioException,它通常就应该留在 RemoteDataSource;如果代码在判断“先读缓存还是访问网络”“失败后是否使用旧数据”,则更适合放在 Repository。
用接口把 Dio 留在实现内部
下面示例可直接放进已添加 dio 依赖的 Dart/Flutter 工程。为了让结果稳定,示例使用 Dio 拦截器在进程内返回固定响应,不访问真实服务器。Dio 的 get<T> 会返回带 data 等字段的 Response<T>,这里把它限制在具体数据源实现中。 ([Dart packages][1])
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));
}预期输出
Ada此时 UserRepository 只认识 RemoteDataSource,既不导入 Dio,也不读取状态码。以后把 Dio 换成其他 HTTP 客户端,主要修改具体数据源与依赖装配,而不是逐个改页面和 Repository。
不要把业务决策塞进远程数据源
RemoteDataSource 可以负责请求参数编码、响应 DTO 解析以及网络层异常归一化,但不宜决定“无网络时是否读取缓存”“用户是否有权限查看该数据”这类业务策略。否则它会从 HTTP 适配器膨胀成难以复用的业务服务。
同样,不要让它直接返回 Response。一旦 Repository 开始读取 statusCode、headers 或 DioException,网络库又穿透了抽象边界。更稳妥的做法是返回 DTO、分页结果等数据层类型,并用本项目自己的异常类型描述远程失败。
什么时候值得拆分
当项目只有一个临时页面和一次请求时,额外接口可能显得繁琐;但只要多个功能共享认证、错误处理、JSON 解析或测试替身,RemoteDataSource 就能明显降低耦合。判断是否拆分的核心不是文件数量,而是上层是否需要知道“这份数据具体通过 Dio 怎样拿到”。如果答案是否定的,就应该把这些细节关在远程数据源里。