Flutter网络通讯插件fly_networking的使用

fly_networking 是一个用于 Flutter 的网络通信插件，旨在简化 HTTP 请求的发送和处理。它提供了一种简洁的方式来处理网络请求，支持 GET、POST、PUT、DELETE 等常见的 HTTP 方法，并且可以轻松地处理 JSON 数据。

以下是如何使用 fly_networking 插件的基本步骤：

1. 添加依赖

首先，在 pubspec.yaml 文件中添加 fly_networking 依赖：

dependencies:
  flutter:
    sdk: flutter
  fly_networking: ^latest_version

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

2. 导入包

在你的 Dart 文件中导入 fly_networking：

import 'package:fly_networking/fly_networking.dart';

3. 创建 Fly 实例

你可以创建一个 Fly 实例来管理网络请求。通常，你可以在应用的顶层或某个服务类中创建这个实例。

final fly = Fly();

4. 发送请求

使用 Fly 实例发送 HTTP 请求。以下是一些常见的请求示例：

GET 请求

void fetchData() async {
  try {
    var response = await fly.get('https://jsonplaceholder.typicode.com/posts');
    print(response.data);
  } catch (e) {
    print(e);
  }
}

POST 请求

void postData() async {
  try {
    var response = await fly.post(
      'https://jsonplaceholder.typicode.com/posts',
      data: {
        'title': 'foo',
        'body': 'bar',
        'userId': 1,
      },
    );
    print(response.data);
  } catch (e) {
    print(e);
  }
}

PUT 请求

void updateData() async {
  try {
    var response = await fly.put(
      'https://jsonplaceholder.typicode.com/posts/1',
      data: {
        'id': 1,
        'title': 'foo',
        'body': 'bar',
        'userId': 1,
      },
    );
    print(response.data);
  } catch (e) {
    print(e);
  }
}

DELETE 请求

void deleteData() async {
  try {
    var response = await fly.delete('https://jsonplaceholder.typicode.com/posts/1');
    print(response.data);
  } catch (e) {
    print(e);
  }
}

5. 处理响应

fly_networking 返回的响应是一个 Response 对象，你可以通过 response.data 获取响应的数据。通常，返回的数据是一个 JSON 对象，你可以根据需要将其解析为 Dart 对象。

6. 错误处理

fly_networking 会自动处理一些网络错误，但你也可以在 try-catch 块中捕获并处理异常。

7. 配置 Fly 实例

你可以通过配置 Fly 实例来设置一些全局的选项，例如 base URL、超时时间、拦截器等。

final fly = Fly(
  baseUrl: 'https://jsonplaceholder.typicode.com',
  timeout: Duration(seconds: 10),
  interceptors: [
    (RequestOptions options) {
      // 添加请求拦截器
      options.headers['Authorization'] = 'Bearer token';
      return options;
    },
  ],
);

8. 使用拦截器

拦截器允许你在请求发送前或响应返回后执行一些操作。例如，你可以在请求拦截器中添加认证信息，或者在响应拦截器中处理错误。

fly.interceptors.add(
  (RequestOptions options) {
    // 请求拦截器
    options.headers['Authorization'] = 'Bearer token';
    return options;
  },
);

9. 取消请求

你可以使用 CancelToken 来取消一个正在进行的请求。

final cancelToken = CancelToken();

void fetchData() async {
  try {
    var response = await fly.get(
      'https://jsonplaceholder.typicode.com/posts',
      cancelToken: cancelToken,
    );
    print(response.data);
  } catch (e) {
    print(e);
  }
}

void cancelRequest() {
  cancelToken.cancel('Request cancelled');
}

10. 处理文件上传

fly_networking 也支持文件上传。你可以使用 FormData 来上传文件。

void uploadFile() async {
  try {
    var response = await fly.post(
      'https://example.com/upload',
      data: FormData.fromMap({
        'file': await MultipartFile.fromFile('path/to/file'),
      }),
    );
    print(response.data);
  } catch (e) {
    print(e);
  }
}