Flutter网络请求插件logecom_dio的使用

logecom_dio 是一个基于 dio 的 Flutter 网络请求插件，它提供了更简洁的 API 和更好的日志记录功能。以下是如何使用 logecom_dio 进行网络请求的基本步骤：

1. 添加依赖

首先，在 pubspec.yaml 文件中添加 logecom_dio 依赖：

dependencies:
  flutter:
    sdk: flutter
  logecom_dio: ^版本号

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

2. 初始化 LogecomDio

在你的 Flutter 应用中初始化 LogecomDio：

import 'package:logecom_dio/logecom_dio.dart';

void main() {
  LogecomDio.initialize(
    baseUrl: 'https://api.example.com',
    enableLogging: true, // 是否启用日志记录
  );
  runApp(MyApp());
}

3. 发送 GET 请求

使用 LogecomDio 发送 GET 请求：

import 'package:logecom_dio/logecom_dio.dart';

Future<void> fetchData() async {
  try {
    final response = await LogecomDio.instance.get('/endpoint');
    print('Response data: ${response.data}');
  } catch (e) {
    print('Error: $e');
  }
}

4. 发送 POST 请求

使用 LogecomDio 发送 POST 请求：

import 'package:logecom_dio/logecom_dio.dart';

Future<void> postData() async {
  try {
    final response = await LogecomDio.instance.post(
      '/endpoint',
      data: {
        'key1': 'value1',
        'key2': 'value2',
      },
    );
    print('Response data: ${response.data}');
  } catch (e) {
    print('Error: $e');
  }
}

5. 处理请求头

你可以通过 options 参数来设置请求头：

import 'package:logecom_dio/logecom_dio.dart';

Future<void> fetchDataWithHeaders() async {
  try {
    final response = await LogecomDio.instance.get(
      '/endpoint',
      options: Options(headers: {
        'Authorization': 'Bearer your_token_here',
      }),
    );
    print('Response data: ${response.data}');
  } catch (e) {
    print('Error: $e');
  }
}

6. 处理错误

LogecomDio 会自动捕获并记录错误。你可以通过 try-catch 块来处理错误：

import 'package:logecom_dio/logecom_dio.dart';

Future<void> fetchDataWithErrorHandling() async {
  try {
    final response = await LogecomDio.instance.get('/endpoint');
    print('Response data: ${response.data}');
  } on DioError catch (e) {
    print('DioError: ${e.message}');
  } catch (e) {
    print('Error: $e');
  }
}

7. 日志记录

LogecomDio 提供了详细的日志记录功能，你可以在控制台中查看请求和响应的详细信息。日志记录可以通过 enableLogging 参数来启用或禁用。

8. 其他功能

LogecomDio 还支持其他功能，如文件上传、下载、拦截器等。你可以参考 dio 的文档来使用这些功能。

9. 示例代码

以下是一个完整的示例代码：

import 'package:flutter/material.dart';
import 'package:logecom_dio/logecom_dio.dart';

void main() {
  LogecomDio.initialize(
    baseUrl: 'https://api.example.com',
    enableLogging: true,
  );
  runApp(MyApp());
}

class MyApp extends StatelessWidget {
  [@override](/user/override)
  Widget build(BuildContext context) {
    return MaterialApp(
      home: Scaffold(
        appBar: AppBar(
          title: Text('LogecomDio Example'),
        ),
        body: Center(
          child: ElevatedButton(
            onPressed: () {
              fetchData();
            },
            child: Text('Fetch Data'),
          ),
        ),
      ),
    );
  }
}

Future<void> fetchData() async {
  try {
    final response = await LogecomDio.instance.get('/endpoint');
    print('Response data: ${response.data}');
  } catch (e) {
    print('Error: $e');
  }
}