quds_server 是一个用于 Flutter 的插件，它简化了与服务器进行交互的过程。它提供了一种简单的方式来发送 HTTP 请求、处理响应以及管理网络状态。以下是如何使用 quds_server 插件的基本步骤：

1. 添加依赖

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

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

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

2. 导入插件

在你的 Dart 文件中导入 quds_server 插件：

import 'package:quds_server/quds_server.dart';

3. 发送 HTTP 请求

quds_server 提供了多种方法来发送 HTTP 请求，例如 get、post、put、delete 等。

发送 GET 请求

void fetchData() async {
  try {
    var response = await QudsServer.get('https://jsonplaceholder.typicode.com/posts');
    print('Response status: ${response.statusCode}');
    print('Response body: ${response.body}');
  } catch (e) {
    print('Error: $e');
  }
}

发送 POST 请求

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

4. 处理响应

QudsServer 的请求方法返回一个 Response 对象，你可以通过它来获取响应的状态码、响应体等信息。

void fetchData() async {
  try {
    var response = await QudsServer.get('https://jsonplaceholder.typicode.com/posts');
    if (response.statusCode == 200) {
      // 请求成功
      var data = response.body; // 获取响应体
      print('Data: $data');
    } else {
      // 请求失败
      print('Failed to load data');
    }
  } catch (e) {
    print('Error: $e');
  }
}

5. 处理错误

QudsServer 会自动处理一些常见的网络错误，但你也可以使用 try-catch 来捕获和处理异常。

void fetchData() async {
  try {
    var response = await QudsServer.get('https://jsonplaceholder.typicode.com/posts');
    print('Response status: ${response.statusCode}');
    print('Response body: ${response.body}');
  } catch (e) {
    print('Error: $e');
  }
}

6. 配置请求

你可以通过 QudsServer 的 configure 方法来配置全局的请求参数，例如设置超时时间、添加请求头等。

void configureServer() {
  QudsServer.configure(
    timeout: Duration(seconds: 10),
    headers: {
      'Authorization': 'Bearer your_token_here',
    },
  );
}

7. 使用拦截器

QudsServer 还支持拦截器，你可以在请求发送前或响应返回后执行一些操作。

void addInterceptor() {
  QudsServer.addInterceptor((request) async {
    print('Request URL: ${request.url}');
    return request;
  });

  QudsServer.addResponseInterceptor((response) async {
    print('Response status: ${response.statusCode}');
    return response;
  });
}

8. 取消请求

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

void fetchDataWithCancel() async {
  var cancelToken = CancelToken();

  try {
    var response = await QudsServer.get(
      'https://jsonplaceholder.typicode.com/posts',
      cancelToken: cancelToken,
    );
    print('Response status: ${response.statusCode}');
    print('Response body: ${response.body}');
  } catch (e) {
    if (CancelToken.isCancel(e)) {
      print('Request canceled');
    } else {
      print('Error: $e');
    }
  }

  // 取消请求
  cancelToken.cancel();
}