Flutter网络请求插件ac_httpx_client的使用

ac_httpx_client 是一个基于 Dio 的 Flutter 网络请求插件，它提供了更简洁的 API 和更好的封装，适用于 Flutter 应用中的网络请求操作。使用 ac_httpx_client 可以简化网络请求的代码，并且提供了诸如拦截器、请求取消、文件上传等功能。

以下是如何使用 ac_httpx_client 进行网络请求的基本步骤：

1. 添加依赖

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

dependencies:
  flutter:
    sdk: flutter
  ac_httpx_client: ^1.0.0  # 请使用最新版本

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

2. 导入包

在需要使用网络请求的地方导入 ac_httpx_client：

import 'package:ac_httpx_client/ac_httpx_client.dart';

3. 创建实例

你可以通过 AcHttpXClient 类来创建一个网络请求的实例：

final client = AcHttpXClient();

4. 发送 GET 请求

使用 get 方法发送一个 GET 请求：

void fetchData() async {
  try {
    final response = await client.get('https://jsonplaceholder.typicode.com/posts/1');
    print('Response data: ${response.data}');
  } catch (e) {
    print('Error: $e');
  }
}

5. 发送 POST 请求

使用 post 方法发送一个 POST 请求：

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

6. 使用拦截器

ac_httpx_client 支持拦截器，你可以在请求发送前或响应返回后进行一些操作：

client.interceptors.add(InterceptorsWrapper(
  onRequest: (options, handler) {
    // 在请求发送前做一些操作，比如添加请求头
    options.headers['Authorization'] = 'Bearer token';
    return handler.next(options);
  },
  onResponse: (response, handler) {
    // 在响应返回后做一些操作
    print('Response received: ${response.data}');
    return handler.next(response);
  },
  onError: (DioError e, handler) {
    // 在请求失败时做一些操作
    print('Error: $e');
    return handler.next(e);
  },
));

7. 取消请求

你可以通过 CancelToken 来取消一个正在进行的请求：

void cancelRequest() {
  final cancelToken = CancelToken();
  client.get('https://jsonplaceholder.typicode.com/posts/1', cancelToken: cancelToken);
  
  // 取消请求
  cancelToken.cancel('Request cancelled');
}

8. 文件上传

ac_httpx_client 支持文件上传，你可以使用 FormData 来上传文件：

void uploadFile() async {
  final file = await MultipartFile.fromFile('/path/to/file', filename: 'upload.jpg');
  final formData = FormData.fromMap({
    'file': file,
  });

  try {
    final response = await client.post(
      'https://example.com/upload',
      data: formData,
    );
    print('Upload response: ${response.data}');
  } catch (e) {
    print('Error: $e');
  }
}

9. 配置全局选项

你可以通过 AcHttpXClient 的构造函数来配置全局选项，比如 baseUrl、超时时间等：

final client = AcHttpXClient(
  baseUrl: 'https://jsonplaceholder.typicode.com',
  connectTimeout: 5000, // 连接超时时间
  receiveTimeout: 3000, // 接收超时时间
);