Flutter网络功能增强插件remedi_net的使用

简介

remedi_net 是一个基于 dio 的网络请求封装库。它提供了更简洁的方式来处理 HTTP 请求，并支持自定义错误处理和数据解析逻辑。

如何使用remedi_net

1. 实现 ApiService

首先，我们需要继承 ApiService 并实现具体的 API 方法。以下是一个示例：

import 'package:remedi_net/remedi_net.dart';

class GoogleApiService extends ApiService<GoogleData> {
  GoogleApiService()
      : super(
          request: DioRequest(
            builder: DioBuilder.json(
              baseUrl: 'https://www.googleapis.com',
            ),
          ),
        );

  /// 定义一个 GET 请求方法
  Future<dynamic> get() async {
    return requestGet(
      path: '/books/v1/volumes',
      queries: {'q': '{http}'},
    );
  }

  /// 自定义 JSON 数据解析逻辑
  [@override](/user/override)
  GoogleData? onSuccess({int? statusCode, dynamic json}) {
    return GoogleData.fromJson(json);
  }

  /// 自定义错误处理逻辑
  [@override](/user/override)
  HttpError onError(HttpError error) {
    // TODO: 可以根据业务需求自定义错误处理逻辑
    return super.onError(error);
  }
}

/// 定义数据模型类
class GoogleData extends IDto {
  GoogleData();

  /// 将 JSON 数据解析为对象
  static GoogleData? fromJson(Map<String, dynamic> json) {
    return GoogleData();
  }

  /// 将对象序列化为 JSON
  [@override](/user/override)
  Map<String, dynamic> get toJson => {};
}

2. 使用 API

在实现好 ApiService 后，我们可以通过调用其方法来发起网络请求，并处理返回的结果。以下是一个完整的示例代码：

import 'dart:developer' as dev;

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

void main() {
  runApp(const MyApp());
}

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

  [@override](/user/override)
  Widget build(BuildContext context) {
    return MaterialApp(
      title: 'Flutter Demo',
      theme: ThemeData(
        primarySwatch: Colors.blue,
      ),
      home: const MyHomePage(),
    );
  }
}

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

  [@override](/user/override)
  State<MyHomePage> createState() => _MyHomePageState();
}

class _MyHomePageState extends State<MyHomePage> {
  dynamic _response;

  [@override](/user/override)
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(
        title: const Text("TEST"),
      ),
      body: Center(
        child: Column(
          mainAxisAlignment: MainAxisAlignment.center,
          children: [
            ElevatedButton(
              onPressed: () async {
                // 调用网络请求方法
                final response = await getGoogle();
                setState(() {
                  _response = response;
                });
              },
              child: const Text('获取数据'),
            ),
            const SizedBox(height: 20),
            Text(
              _response is GoogleData
                  ? (_response as GoogleData).toJson.toString()
                  : _response.toString(),
              textAlign: TextAlign.center,
            ),
          ],
        ),
      ),
    );
  }

  Future<dynamic> getGoogle() async {
    try {
      final result = await GoogleApiService().get();
      if (result is GoogleData) {
        dev.log(result.toJson.toString(), name: 'getGoogle');
        return result;
      } else if (result is HttpError) {
        throw result;
      }
    } catch (e) {
      dev.log(e.toString(), name: 'getGoogle');
      rethrow;
    }
    return null;
  }
}

示例代码说明

以下是从官方示例代码中提取的部分，展示如何通过 remedi_net 发起网络请求并处理响应：

class GoogleApiService extends ApiService<GoogleData> {
  GoogleApiService()
      : super(
          request: DioRequest(
            builder: DioBuilder.json(
              baseUrl: 'https://www.googleapis.com',
            ),
          ),
        );

  Future<dynamic> get() async {
    return requestGet(
      path: '/books/v1/volumes',
      queries: {'q': '{http}'},
    );
  }

  [@override](/user/override)
  GoogleData? onSuccess({int? statusCode, dynamic json}) {
    return GoogleData.fromJson(json);
  }

  [@override](/user/override)
  HttpError onError(HttpError error) {
    // 自定义错误处理逻辑
    return super.onError(error);
  }
}

class GoogleData extends IDto {
  GoogleData();

  static GoogleData? fromJson(Map<String, dynamic> json) {
    return GoogleData();
  }

  [@override](/user/override)
  Map<String, dynamic> get toJson => {};
}