Flutter网络请求插件dahttp的使用

dahttp 是一个用于Dart的HTTP包装器，它集成了日志记录功能，旨在用于REST API。以下是关于如何使用该插件的详细说明。

安装

在你的 pubspec.yaml 文件中添加以下依赖：

dependencies: 
  dahttp: ^3.3.1

然后运行 flutter pub get 来安装依赖。

示例

以下是一个完整的示例，展示了如何使用 dahttp 插件进行网络请求。

示例代码

import 'dart:convert';
import 'package:dahttp/src/http_client.dart';
import 'package:dahttp/src/http_result.dart';
import 'package:http/http.dart' as http;

// 定义一个用于获取随机狗图片的类
class GetDogCeo extends ValuedHttpClient<DogCeo> {
  // 发送GET请求并返回结果
  Future<HttpResult<DogCeo>> call() => 
      super.get('https://dog.ceo/api/breeds/image/random');

  // 将响应数据转换为DogCeo对象
  @override
  DogCeo convert(http.Response response) => DogCeo.fromJson(response.body);
}

// 定义DogCeo类
class DogCeo {
  final String? url;

  const DogCeo(this.url);

  // 从JSON字符串解析DogCeo对象
  factory DogCeo.fromJson(String json) {
    final dynamic data = jsonDecode(json);

    return DogCeo(data['message']);
  }
}

// 主函数
Future<void> main() async {
  // 创建GetDogCeo实例
  final GetDogCeo getDogCeo = GetDogCeo();
  
  // 执行网络请求并获取结果
  final HttpResult<DogCeo> result = await getDogCeo.call();

  // 检查结果的状态
  if (result.success) {
    // 请求成功
    print('Success: ${result.data.url}');
  } else if (result.error) {
    // 请求失败
    print('Error: ${result.response.statusCode}');
  } else if (result.hasException) {
    // 发生异常
    print('Exception: ${result.exception}');
  }

  // 使用回调处理不同情况
  result.handle(
    onSuccess: (DogCeo dog, http.Response response) {
      print('Success: ${dog.url}');
    },
    onError: (http.Response response) {
      print('Error: ${response.statusCode}');
    },
    onException: (dynamic exception) {
      print('Exception: $exception');
    },
  );

  // 使用链式调用处理不同情况
  result.onSuccess((DogCeo dog, http.Response response) {
    print('Success: ${dog.url}');
  }).onError((http.Response response) {
    print('Error: ${response.statusCode}');
  }).onException((dynamic exception) {
    print('Exception: $exception');
  });

  // 使用级联调用处理不同情况
  result
    ..onSuccess((DogCeo dog, http.Response response) {
      print('Success: ${dog.url}');
    })
    ..onError((http.Response response) {
      print('Error: ${response.statusCode}');
    })
    ..onException((dynamic exception) {
      print('Exception: $exception');
    });
}

解释

1. 导入必要的包：

   import 'dart:convert';
   import 'package:dahttp/src/http_client.dart';
   import 'package:dahttp/src/http_result.dart';
   import 'package:http/http.dart' as http;
   

2. 定义 GetDogCeo 类：

   class GetDogCeo extends ValuedHttpClient<DogCeo> {
     Future<HttpResult<DogCeo>> call() => 
         super.get('https://dog.ceo/api/breeds/image/random');
   
     @override
     DogCeo convert(http.Response response) => DogCeo.fromJson(response.body);
   }
   

   这个类继承自 ValuedHttpClient，并实现了 call 方法来发送GET请求。同时，它还重写了 convert 方法将响应数据转换为 DogCeo 对象。

3. 定义 DogCeo 类：

   class DogCeo {
     final String? url;
   
     const DogCeo(this.url);
   
     factory DogCeo.fromJson(String json) {
       final dynamic data = jsonDecode(json);
   
       return DogCeo(data['message']);
     }
   }
   

   这个类用于表示从API返回的数据，并且包含一个工厂构造方法用于从JSON字符串创建对象。

4. 主函数：

   Future<void> main() async {
     final GetDogCeo getDogCeo = GetDogCeo();
     final HttpResult<DogCeo> result = await getDogCeo.call();
   
     if (result.success) {
       print('Success: ${result.data.url}');
     } else if (result.error) {
       print('Error: ${result.response.statusCode}');
     } else if (result.hasException) {
       print('Exception: ${result.exception}');
     }
   
     result.handle(
       onSuccess: (DogCeo dog, http.Response response) {
         print('Success: ${dog.url}');
       },
       onError: (http.Response response) {
         print('Error: ${response.statusCode}');
       },
       onException: (dynamic exception) {
         print('Exception: $exception');
       },
     );
   }