Flutter网络通信核心插件flutter_network_layer_core的使用

flutter_network_layer_core

flutter_network_layer_core 是 Flutter 网络层项目的核心包。

它提供了实现以下功能的框架：

• flutter_network_layer_dio (pub.dev)

使用

建议与上述实现一起使用。 然而，你也可以实现自己的网络层。

创建网络调用实现

// 网络调用实现

import 'package:flutter_network_layer_core/flutter_network_layer_core.dart';

class NetworkInvoker implements INetworkInvoker {
  @override
  Future<void> init(String baseUrl) async {
    // 在这里创建你的网络客户端。
  }

  @override
  Future<ResponseResult<T>> request<T extends ResponseModel>(RequestCommand<T> request) async {
    // 使用网络客户端处理请求。
  }
}

创建响应模型

import 'package:flutter_network_layer_core/flutter_network_layer_core.dart';

class ResponseExample extends JsonResponseModel {
  final String id;
  final String name;
  final int age;

  const ResponseExample({
    required this.id,
    required this.name,
    required this.age,
  });

  const ResponseExample.empty()
      : id = '',
        name = '',
        age = 0;

  @override
  factory ResponseExample.fromJson(dynamic json) {
    if (json is! Map<String, dynamic>) {
      throw Exception('无效的JSON类型');
    }

    return ResponseExample(
      id: json['id'] as String,
      name: json['name'] as String,
      age: json['age'] as int,
    );
  }

  @override
  Map<String, dynamic> toJson() {
    return {
      'id': id,
      'name': name,
      'age': age,
    };
  }
}

创建请求模型

import 'package:flutter_network_layer_core/flutter_network_layer_core.dart';

class RequestUser implements RequestCommand<ResponseUser> {
  @override
  Map<String, dynamic> get data => const {};

  @override
  Map<String, dynamic> get headers => const {};

  @override
  HttpRequestMethod get method => HttpRequestMethod.get;

  @override
  OnProgressCallback? onReceiveProgressUpdate;

  @override
  OnProgressCallback? onSendProgressUpdate;

  @override
  String get path => '/example';

  @override
  RequestPayloadType get payloadType => RequestPayloadType.json;

  @override
  ResponseExample get sampleModel => const ResponseExample.empty();
}

或者，你可以扩展 RequestCommand 类。RequestCommand 的默认字段值已经在该方法中实现，但如果你需要，可以覆盖它们。

import 'package:flutter_network_layer_core/flutter_network_layer_core.dart';

class RequestUser extends RequestCommand<ResponseUser> {
  @override
  String get path => '/example';

  @override
  ResponseExample get sampleModel => const ResponseExample.empty();
}

最终使用网络层

import 'package:flutter_network_layer_core/flutter_network_layer_core.dart';

void main() async {
  // 创建并初始化调用器
  final networkInvoker = NetworkInvoker();
  await networkInvoker.init('https://api.example.com');

  // 发送请求
  final response = await networkInvoker.request(RequestUser());

  // 处理响应
  response.when(
    success: (data) {
      print(data);
    },
    error: (error) {
      print(error);
    },
  );
}