整洁架构数据源：插件与包依赖的处理及替换方案问询

问题解答与建议 #

1. 未来替换SharedPreferences或http是否需要重构所有数据源？ #

如果直接在数据源中依赖第三方包的具体实现（比如http.Client、SharedPreferences实例），是的，必须重构所有相关数据源。因为代码直接耦合了第三方库的API、返回类型与调用逻辑，一旦替换成其他库（比如Dio替代http、Hive替代SharedPreferences），这些细节全部变化，所有用到的地方都得修改。

2. 为何不将这些包封装为包装类以实现复用？ #

这正是整洁架构「依赖抽象而非具体实现」原则的核心应用场景，直接使用第三方包存在明显问题：

• 重复代码冗余：比如每个数据源都要写相同的请求Header、错误判断逻辑
• 耦合度过高：数据源与第三方库强绑定，后续替换成本极高
• 维护成本高：修改通用逻辑（比如全局Header）需要逐个修改所有数据源

封装包装类的核心优势：

• 复用通用逻辑：全局Header、请求拦截、错误统一处理等都集中在包装类中，所有数据源直接调用封装后的接口
• 降低耦合：数据源仅依赖自定义的抽象接口，与第三方库完全解耦
• 统一维护：修改第三方库的使用逻辑仅需修改包装类，无需改动所有数据源

3. 能否在不修改数据源类现有逻辑与数据映射的前提下更换所用插件/包？ #

完全可以，核心是通过抽象层隔离第三方库的返回类型与细节。只要数据源依赖的是自定义的抽象接口和数据模型，替换第三方库时仅需新增一个对应抽象接口的实现类，将新库的返回类型转换为自定义模型即可，数据源的业务逻辑与数据映射无需任何改动。

代码示例改造 #

第一步：定义抽象接口 #

为http客户端定义抽象层，隔离第三方库细节：

// 自定义Http响应模型，统一返回格式
class HttpResponse {
  final int statusCode;
  final String body;

  HttpResponse(this.statusCode, this.body);
}

// 自定义Http客户端抽象接口
abstract class HttpClient {
  Future<HttpResponse> get(String url, {Map<String, String>? headers});
  // 可扩展post、put等其他请求方法
}

第二步：封装第三方库实现 #

基于原生http包实现抽象接口，集中处理通用逻辑：

class HttpPackageClient implements HttpClient {
  final http.Client _client;

  HttpPackageClient(this._client);

  @override
  Future<HttpResponse> get(String url, {Map<String, String>? headers}) async {
    // 全局默认Header，避免重复编写
    final defaultHeaders = {
      'Content-Type': 'application/json',
    };
    // 合并自定义Header与默认Header
    final mergedHeaders = {...defaultHeaders, ...?headers};

    final response = await _client.get(Uri.parse(url), headers: mergedHeaders);
    return HttpResponse(response.statusCode, response.body);
  }
}

第三步：修改数据源依赖抽象接口 #

数据源不再直接依赖http.Client，而是依赖自定义的HttpClient抽象：

class NumberTriviaRemoteDataSourceImpl implements NumberTriviaRemoteDataSource {
  final HttpClient client; 

  NumberTriviaRemoteDataSourceImpl({required this.client});


  Future<NumberTriviaModel> _getTriviaFromUrl(String url) async {
    final response = await client.get(url);

    if (response.statusCode == 200) {
      return NumberTriviaModel.fromJson(json.decode(response.body));
    } else {
      throw ServerException();
    }
  }
}

第四步：替换第三方库无需修改数据源 #

如果要换成Dio库，仅需新增一个HttpClient的实现类即可：

class DioHttpClient implements HttpClient {
  final Dio _dio;

  DioHttpClient(this._dio) {
    // 全局配置Header、拦截器等
    _dio.options.headers['Content-Type'] = 'application/json';
  }

  @override
  Future<HttpResponse> get(String url, {Map<String, String>? headers}) async {
    try {
      final response = await _dio.get(url, options: Options(headers: headers));
      return HttpResponse(response.statusCode!, response.data.toString());
    } catch (e) {
      // 统一错误处理，抛出自定义异常
      throw ServerException();
    }
  }
}

此时只需在依赖注入环节，将HttpPackageClient替换为DioHttpClient，数据源的业务逻辑与数据映射完全无需改动。

内容的提问来源于stack exchange，提问作者user22969480