Flutter网络请求增强插件embrace_dio的使用

embrace_dio 是一个用于捕获通过 Dio 包发起的网络请求的插件。它可以帮助你更好地管理和监控你的网络请求。

使用

要使用 embrace_dio，你需要将 EmbraceInterceptor 添加到 Dio 实例中。

var dio = Dio();
dio.interceptors.add(EmbraceInterceptor());

下面是一个完整的示例代码，展示如何在 Flutter 应用中使用 embrace_dio 来发送和记录网络请求。

// ignore_for_file: inference_failure_on_function_invocation

import 'package:dio/dio.dart';
import 'package:embrace/embrace.dart';
import 'package:embrace_dio/embrace_dio.dart';
import 'package:flutter/material.dart';

Future<void> main() async {
  // 启动 Embrace 并运行应用
  await Embrace.instance.start(() => runApp(const EmbraceDioDemo()));
}

class EmbraceDioDemo extends StatelessWidget {
  const EmbraceDioDemo({Key? key}) : super(key: key);

  [@override](/user/override)
  Widget build(BuildContext context) {
    return const MaterialApp(home: EmbraceDioMenu());
  }
}

class EmbraceDioMenu extends StatefulWidget {
  const EmbraceDioMenu({Key? key}) : super(key: key);

  [@override](/user/override)
  State<EmbraceDioMenu> createState() => _EmbraceDioMenuState();
}

class _EmbraceDioMenuState extends State<EmbraceDioMenu> {
  late final _dio = Dio(); // 创建 Dio 实例

  [@override](/user/override)
  void initState() {
    super.initState();
    _dio.interceptors.add(EmbraceInterceptor()); // 将 EmbraceInterceptor 添加到 Dio 实例
  }

  [@override](/user/override)
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(title: const Text('网络请求')),
      body: Padding(
        padding: const EdgeInsets.all(8),
        child: Center(
          child: Column(
            children: [
              ElevatedButton(
                onPressed: () => sendAndLogRequest(HttpMethod.get), // 点击时调用 sendAndLogRequest 方法
                child: const Text('GET 请求'),
              ),
              ElevatedButton(
                onPressed: () => sendAndLogRequest(HttpMethod.post), // 点击时调用 sendAndLogRequest 方法
                child: const Text('POST 请求'),
              ),
              ElevatedButton(
                onPressed: () => sendAndLogRequest(HttpMethod.put), // 点击时调用 sendAndLogRequest 方法
                child: const Text('PUT 请求'),
              ),
              ElevatedButton(
                onPressed: () => sendAndLogRequest(HttpMethod.patch), // 点击时调用 sendAndLogRequest 方法
                child: const Text('PATCH 请求'),
              ),
              ElevatedButton(
                onPressed: () => sendAndLogRequest(HttpMethod.delete), // 点击时调用 sendAndLogRequest 方法
                child: const Text('DELETE 请求'),
              ),
              ElevatedButton(
                onPressed: error404Request, // 点击时调用 error404Request 方法
                child: const Text('错误: 404'),
              ),
              ElevatedButton(
                onPressed: invalidDomainRequest, // 点击时调用 invalidDomainRequest 方法
                child: const Text('错误: 无效域名'),
              ),
            ],
          ),
        ),
      ),
    );
  }

  [@override](/user/override)
  void dispose() {
    _dio.close(); // 关闭 Dio 实例
    super.dispose();
  }

  // 发送请求并记录日志
  Future<void> sendAndLogRequest(HttpMethod method) async {
    switch (method) {
      case HttpMethod.put:
        await _dio.put('https://httpbin.org/put'); // 发送 PUT 请求
        break;
      case HttpMethod.post:
        await _dio.post('https://httpbin.org/post'); // 发送 POST 请求
        break;
      case HttpMethod.patch:
        await _dio.patch('https://httpbin.org/patch'); // 发送 PATCH 请求
        break;
      case HttpMethod.delete:
        await _dio.delete('https://httpbin.org/delete'); // 发送 DELETE 请求
        break;
      case HttpMethod.get:
        await _dio.get('https://httpbin.org/get'); // 发送 GET 请求
        break;
      case HttpMethod.other:
        await _dio.get('https://httpbin.org/get'); // 发送其他类型的请求
        break;
    }
  }

  // 发送 404 错误请求
  Future<void> error404Request() async {
    await _dio.get('https://httpbin.org/status/404'); // 发送返回 404 的请求
  }

  // 发送无效域名请求
  Future<void> invalidDomainRequest() async {
    await _dio.get('https://httpbin.invalid'); // 发送无效域名的请求
  }
}