Flutter插件danela的使用_danela封装了网络层逻辑，提供了一个模块化、可定制、高效且直观的解决方案

###Flutter插件danela的使用_danela封装了网络层逻辑，提供了一个模块化、可定制、高效且直观的解决方案

你是否曾经在集成应用与另一个RESTful API时感到绝望？这通常意味着你需要创建新的ApiManager和ApiRepositorie，并再次调用相同的Dio或Http方法。

Danela（Dart Abstract Network Layer）封装了网络层逻辑，提供了一个模块化、可定制、高效且直观的解决方案。从样板代码和遗留问题中解脱出来，采用通用的方法。

Danela、该方法和此图像受到Moya的启发。

Flutter插件danela安装

# pubspec.yaml
dependencies:
  danela: ^1.0.0

Flutter插件danela使用

Danela操作两种数据类型。它们仅定义操作的特征。你可以将它们比作Flutter小部件，作为实际UI的蓝图。

• Requests 描述从互联网请求某些内容的动作。
• RequestMappers 描述原始响应数据如何被处理并映射到输出模型。

对于数据类型的操作，也有两个概念：

• Gateway 是一个执行请求的对象接口。
• Repository 是一个对象接口，用于缓存或存储数据网关提供给它的数据。

// 创建一个Joke API的请求
final request = const Request(
    url: 'https://official-joke-api.appspot.com/random_joke',
);

// 定义一个mapper，将Dio的Response转换为字符串
final mapper = RequestMapper<Response, String>(
    mapJson: fromJson,
    onError: fromError,
);

// 创建Dio实例
final dio = Dio();

// 现在我们定义网关
final gateway = DioGateway(
    dio: dio,
    request: request,
    mapper: mapper,
);

// 安全地获取字符串结果
print(await gateway.run());

// 现在，让我们添加缓存
final repository = DefaultRepository(gateway: gateway);

// 我们很好！默认情况下，DefaultRepository的缓存使用设置为true
print(await repository.run(useCache: true));

使用fpdart

如果你喜欢函数式编程方法，可以轻松利用Danela的简洁之美。

// 使用带有Either的mapper
final mapper = RequestMapper<Response, Either<String, Joke>>(
    mapJson: (json) => Either.of(Joke.fromJson(json)),
    onError: (e) => '$e',
);

// 像往常一样定义网关
final gateway = DioGateway(
    dio: dio,
    request: request,
    mapper: mapper,
);

// 使用TaskEither包装run
final gatewayTask = TaskEither(gateway.run);

// 或者定义一个本地扩展以将Future转换为Task
extension GatewayToTaskExt<T> on Gateway<T> {
    Task<T> get toTask => Task(run);
}

测试

Danela是可组合的，因此你可以自由实现MockGateway或MockRepository，并将它们注入你的模块作为存储库。

class MockRepository<T> implements Repository<T> {
    @override
    Future<T> run() => Future.delayed(
        const Duration(seconds: 2), 
        () => Random().nextInt(5),
    );
    
    @override
    void dispose() {}
}

联系方式

包仍在开发中，如果有任何问题或希望改进项目，请在GitHub上创建一个问题或通过Telegram联系我。

示例代码

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

String fromJson(Map<String, dynamic> json) {
  final setup = json['setup'];
  final punch = json['punchline'];
  return '$setup\n$punch';
}

String fromError(Object e) => '$e';

void main() async {
  // 创建一个Joke API的请求
  final request = const Request(
    url: 'https://official-joke-api.appspot.com/random_joke',
  );
  // 定义一个mapper，将Dio的Response转换为字符串
  final mapper = const RequestMapper<Response, String>(
    mapJson: fromJson,
    onError: fromError,
  );
  // 创建Dio实例
  final dio = Dio();
  // 现在我们定义网关
  final gateway = DioGateway(
    dio: dio,
    request: request,
    mapper: mapper,
  );
  // 安全地获取字符串结果
  print(await gateway.run());

  // 现在，让我们添加缓存
  final repository = DefaultRepository(gateway: gateway);
  // 我们很好！默认情况下，DefaultRepository的缓存使用设置为true
  print(await repository.run(useCache: true));
}