fluent_networking_api 是一个用于 Flutter 的网络通信插件，它提供了简洁的 API 来处理 HTTP 请求和响应。虽然目前 Flutter 社区中更常用的是 http 或 dio 插件，但 fluent_networking_api 提供了一种流式的方式来处理网络请求，使得代码更加简洁和易读。

以下是如何使用 fluent_networking_api 插件进行网络通信的基本步骤：

1. 添加依赖

首先，你需要在 pubspec.yaml 文件中添加 fluent_networking_api 插件的依赖：

dependencies:
  flutter:
    sdk: flutter
  fluent_networking_api: ^0.0.1  # 请检查最新版本

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

2. 导入插件

在你的 Dart 文件中导入 fluent_networking_api：

import 'package:fluent_networking_api/fluent_networking_api.dart';

3. 创建网络请求

使用 fluent_networking_api 发起网络请求非常简单。以下是一个 GET 请求的示例：

void fetchData() async {
  final response = await FluentNetworking.get('https://jsonplaceholder.typicode.com/posts')
      .execute();

  if (response.statusCode == 200) {
    // 请求成功，处理响应数据
    print('Response data: ${response.body}');
  } else {
    // 请求失败，处理错误
    print('Request failed with status: ${response.statusCode}');
  }
}

4. 处理 POST 请求

如果你想发送 POST 请求，可以这样做：

void postData() async {
  final response = await FluentNetworking.post('https://jsonplaceholder.typicode.com/posts')
      .body({
        'title': 'foo',
        'body': 'bar',
        'userId': 1,
      })
      .execute();

  if (response.statusCode == 201) {
    // 请求成功，处理响应数据
    print('Response data: ${response.body}');
  } else {
    // 请求失败，处理错误
    print('Request failed with status: ${response.statusCode}');
  }
}

5. 添加请求头

你可以通过 .headers() 方法添加请求头：

void fetchDataWithHeaders() async {
  final response = await FluentNetworking.get('https://jsonplaceholder.typicode.com/posts')
      .headers({
        'Authorization': 'Bearer your_token_here',
      })
      .execute();

  if (response.statusCode == 200) {
    print('Response data: ${response.body}');
  } else {
    print('Request failed with status: ${response.statusCode}');
  }
}

6. 处理错误

fluent_networking_api 提供了 .onError() 方法来处理请求过程中的错误：

void fetchDataWithErrorHandling() async {
  final response = await FluentNetworking.get('https://jsonplaceholder.typicode.com/invalid')
      .onError((error) {
        print('An error occurred: $error');
      })
      .execute();

  if (response.statusCode == 200) {
    print('Response data: ${response.body}');
  } else {
    print('Request failed with status: ${response.statusCode}');
  }
}

7. 处理 JSON 数据

你可以使用 jsonDecode 来解析 JSON 数据：

import 'dart:convert';

void fetchJsonData() async {
  final response = await FluentNetworking.get('https://jsonplaceholder.typicode.com/posts')
      .execute();

  if (response.statusCode == 200) {
    final List<dynamic> data = jsonDecode(response.body);
    print('Fetched ${data.length} posts');
  } else {
    print('Request failed with status: ${response.statusCode}');
  }
}

8. 其他 HTTP 方法

fluent_networking_api 还支持其他 HTTP 方法，如 PUT、DELETE 等。使用方法与 GET 和 POST 类似：

void updateData() async {
  final response = await FluentNetworking.put('https://jsonplaceholder.typicode.com/posts/1')
      .body({
        'title': 'updated title',
        'body': 'updated body',
        'userId': 1,
      })
      .execute();

  if (response.statusCode == 200) {
    print('Response data: ${response.body}');
  } else {
    print('Request failed with status: ${response.statusCode}');
  }
}

9. 取消请求

你可以通过 .cancel() 方法来取消正在进行的请求：

void fetchDataWithCancellation() async {
  final request = FluentNetworking.get('https://jsonplaceholder.typicode.com/posts')
      .onError((error) {
        print('An error occurred: $error');
      });

  final response = await request.execute();

  // 取消请求
  request.cancel();

  if (response.statusCode == 200) {
    print('Response data: ${response.body}');
  } else {
    print('Request failed with status: ${response.statusCode}');
  }
}