Flutter网络管理插件flutter_network_manager的使用

特性

通过使用网络管理器（Network Manager），你可以轻松地管理和发送互联网请求，并接收数据。

使用方法

设置基础URL

// 设置基础URL为 https://jsonplaceholder.typicode.com/
Settings Base URL -> NetworkManager("https://jsonplaceholder.typicode.com/", debugMode: true);

设置请求方法

// 设置GET请求
.setGET() => "GET"

// 设置POST请求
.setPOST() => "POST"

// 设置PUT请求
.setPUT() => "PUT"

// 设置DELETE请求
.setDELETE() => "DELETE"

设置超时时间

// 设置发送超时时间为1000毫秒，默认值为3000毫秒
.setSendTimeout(1000) => Default Value 3000.

设置接收超时时间

// 设置接收超时时间为1000毫秒，默认值为3000毫秒
.setReceiveTimeOut(1000) => Default Value 3000.

设置查询参数

// 设置查询参数为{"name":"example"}
.setQueryParameters({"name":"example"})

设置头部信息

// 设置头部信息为{"Content-Type":"example"}
.setHeader({"Content-Type":"example"})

设置请求体

// 设置请求体为{"Content-Type":"example"}
.setBody({"Content-Type":"example"})

设置内容类型

// 设置内容类型为multipart-form
.setContentType("multipart-form")

设置路径

// 设置路径为api/v1/login
.setPath("api/v1/login")

执行请求

// 执行请求并解码模型
.execute<T extends BaseResponseModel, K>(
  T responseModel)

  T extends  => Your Decode Model
  T responseModel => Your Decode Model
  K => Show View Model, ExampleModel, List<ExampleModel>

home_services.dart

import 'package:network_manager/Network/Error/network_error.dart';
import 'package:network_manager/Network/Result/network_result.dart';
import '../../../client/network_client.dart';
import '../model/home_model.dart';

class HomeServices {
  Result<List<HomeModel>, NetworkError> result = const Result.success([]);

  Future<void> getHomeList() async {
    // 模拟网络延迟
    await Future.delayed(const Duration(seconds: 1));
    
    // 发送网络请求
    final response = await NetworkClient.instance.networkManager
        .setGET()
        .setPath("posts")
        .execute<HomeModel, List<HomeModel>>(HomeModel());
    
    // 更新结果
    result = response;
  }
}

home_model.dart

import 'package:network_manager/Network/Interface/model_interface.dart';

class HomeModel extends BaseResponseModel {
  HomeModel({
    this.userId,
    this.id,
    this.title,
    this.body,
  });

  int? userId;
  int? id;
  String? title;
  String? body;

  factory HomeModel.fromJson(Map<String, dynamic> json) => HomeModel(
        userId: json["userId"],
        id: json["id"],
        title: json["title"],
        body: json["body"],
      );

  Map<String, dynamic> toJson() => {
        "userId": userId,
        "id": id,
        "title": title,
        "body": body,
      };

  @override
  fromJson(Map<String, dynamic> json) {
    return HomeModel.fromJson(json);
  }
}

home_screen.dart

import 'package:flutter/material.dart';

import '../services/home_services.dart';

class HomeScreen extends StatelessWidget {
  HomeScreen({Key? key}) : super(key: key);
  final HomeServices homeServices = HomeServices();

  @override
  Widget build(BuildContext context) {
    return Scaffold(
        appBar: AppBar(
          title: const Text("示例网络管理器"),
        ),
        body: FutureBuilder(
          future: homeServices.getHomeList(),
          builder: (context, snapshot) => homeServices.result.when(
            success: (data) {
              return ListView.builder(
                itemBuilder: (context, index) => ListTile(
                  title: Text(data[index].title ?? ""),
                  subtitle: Text(data[index].body ?? ""),
                ),
                itemCount: data.length,
              );
            },
            failure: (error) {
              return Text(error.toString());
            },
          ),
        ));
  }
}

network_client.dart

import 'package:network_manager/Network/network_builder.dart';

class NetworkClient {
  static final NetworkClient instance = NetworkClient();
  final NetworkManager networkManager = NetworkManager("https://jsonplaceholder.typicode.com/", debugMode: true);
}