ac_fetch 是一个用于 Flutter 的数据获取插件，它简化了网络请求和数据获取的过程。通过 ac_fetch，你可以轻松地发送 HTTP 请求并处理响应数据。以下是如何使用 ac_fetch 插件的详细步骤。

1. 添加依赖

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

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

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

2. 导入包

在你的 Dart 文件中导入 ac_fetch 包：

import 'package:ac_fetch/ac_fetch.dart';

3. 发送 GET 请求

使用 ac_fetch 发送一个简单的 GET 请求：

void fetchData() async {
  try {
    final response = await AcFetch.get('https://jsonplaceholder.typicode.com/posts');
    if (response.statusCode == 200) {
      // 请求成功
      print('Response data: ${response.body}');
    } else {
      // 请求失败
      print('Failed to load data: ${response.statusCode}');
    }
  } catch (e) {
    // 处理异常
    print('Error: $e');
  }
}

4. 发送 POST 请求

发送 POST 请求并传递数据：

void postData() async {
  try {
    final response = await AcFetch.post(
      'https://jsonplaceholder.typicode.com/posts',
      body: {
        'title': 'foo',
        'body': 'bar',
        'userId': 1,
      },
      headers: {
        'Content-Type': 'application/json',
      },
    );
    if (response.statusCode == 201) {
      // 请求成功
      print('Response data: ${response.body}');
    } else {
      // 请求失败
      print('Failed to post data: ${response.statusCode}');
    }
  } catch (e) {
    // 处理异常
    print('Error: $e');
  }
}

5. 处理响应数据

ac_fetch 的响应对象 Response 包含了请求的状态码、响应体等信息。你可以根据需要处理这些数据。

void fetchAndProcessData() async {
  try {
    final response = await AcFetch.get('https://jsonplaceholder.typicode.com/posts/1');
    if (response.statusCode == 200) {
      // 解析 JSON 数据
      final Map<String, dynamic> data = response.body;
      print('Post title: ${data['title']}');
    } else {
      print('Failed to load data: ${response.statusCode}');
    }
  } catch (e) {
    print('Error: $e');
  }
}

6. 处理错误和异常

ac_fetch 会自动处理一些常见的网络错误，但你仍然需要捕获并处理可能的异常。

void fetchDataWithErrorHandling() async {
  try {
    final response = await AcFetch.get('https://jsonplaceholder.typicode.com/invalid-endpoint');
    if (response.statusCode == 200) {
      print('Response data: ${response.body}');
    } else {
      print('Failed to load data: ${response.statusCode}');
    }
  } on SocketException catch (e) {
    print('Network error: $e');
  } on HttpException catch (e) {
    print('HTTP error: $e');
  } on FormatException catch (e) {
    print('Data parsing error: $e');
  } catch (e) {
    print('Unknown error: $e');
  }
}

7. 配置全局选项

你可以通过 AcFetchConfig 配置全局选项，例如设置默认的请求头、超时时间等。

void configureGlobalOptions() {
  AcFetchConfig(
    baseUrl: 'https://jsonplaceholder.typicode.com',
    headers: {
      'Authorization': 'Bearer your_token',
    },
    timeout: Duration(seconds: 10),
  );
}

8. 使用拦截器

ac_fetch 支持请求和响应拦截器，你可以在发送请求或处理响应之前进行一些操作。

void setupInterceptors() {
  AcFetch.interceptors.add(
    InterceptorsWrapper(
      onRequest: (options, handler) {
        // 在发送请求之前做一些事情
        print('Request URL: ${options.url}');
        return handler.next(options);
      },
      onResponse: (response, handler) {
        // 在处理响应之前做一些事情
        print('Response status code: ${response.statusCode}');
        return handler.next(response);
      },
      onError: (error, handler) {
        // 处理请求错误
        print('Error: $error');
        return handler.next(error);
      },
    ),
  );
}