jaguar_resty 是一个基于 jaguar 的 Flutter 网络请求插件，它提供了简洁的 API 来执行 HTTP 请求。jaguar_resty 的设计目标是简化网络请求的代码，使其更易于使用和维护。

以下是如何在 Flutter 项目中使用 jaguar_resty 的步骤：

1. 添加依赖

首先，你需要在 pubspec.yaml 文件中添加 jaguar_resty 依赖。

dependencies:
  flutter:
    sdk: flutter
  jaguar_resty: ^0.7.0

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

2. 导入包

在你的 Dart 文件中导入 jaguar_resty。

import 'package:jaguar_resty/jaguar_resty.dart';

3. 配置全局设置

你可以配置全局的 Resty 实例，例如设置基础 URL 和默认的请求头。

void main() {
  Resty.setDefaults(
    baseUrl: 'https://jsonplaceholder.typicode.com',
    headers: {
      'Content-Type': 'application/json',
    },
  );

  runApp(MyApp());
}

4. 发起 GET 请求

使用 Resty.get 方法来发起 GET 请求。

Future<void> fetchPosts() async {
  final response = await Resty.get('/posts');
  if (response.statusCode == 200) {
    final List<dynamic> posts = response.body;
    print('Posts: $posts');
  } else {
    print('Failed to load posts');
  }
}

5. 发起 POST 请求

使用 Resty.post 方法来发起 POST 请求。

Future<void> createPost() async {
  final response = await Resty.post(
    '/posts',
    body: {
      'title': 'foo',
      'body': 'bar',
      'userId': 1,
    },
  );
  if (response.statusCode == 201) {
    final Map<String, dynamic> post = response.body;
    print('Created Post: $post');
  } else {
    print('Failed to create post');
  }
}

6. 发起 PUT 请求

使用 Resty.put 方法来发起 PUT 请求。

Future<void> updatePost(int postId) async {
  final response = await Resty.put(
    '/posts/$postId',
    body: {
      'id': postId,
      'title': 'foo',
      'body': 'bar',
      'userId': 1,
    },
  );
  if (response.statusCode == 200) {
    final Map<String, dynamic> post = response.body;
    print('Updated Post: $post');
  } else {
    print('Failed to update post');
  }
}

7. 发起 DELETE 请求

使用 Resty.delete 方法来发起 DELETE 请求。

Future<void> deletePost(int postId) async {
  final response = await Resty.delete('/posts/$postId');
  if (response.statusCode == 200) {
    print('Post deleted');
  } else {
    print('Failed to delete post');
  }
}

8. 处理错误

你可以使用 try-catch 块来捕获和处理请求过程中可能发生的错误。

Future<void> fetchPosts() async {
  try {
    final response = await Resty.get('/posts');
    if (response.statusCode == 200) {
      final List<dynamic> posts = response.body;
      print('Posts: $posts');
    } else {
      print('Failed to load posts');
    }
  } catch (e) {
    print('Error: $e');
  }
}

9. 使用拦截器

jaguar_resty 支持拦截器，你可以在请求发送前或响应接收后执行一些操作。

void main() {
  Resty.addInterceptor((request) async {
    print('Request: ${request.method} ${request.url}');
    return request;
  });

  Resty.addInterceptor((request) async {
    final response = await request.send();
    print('Response: ${response.statusCode}');
    return response;
  });

  runApp(MyApp());
}

10. 取消请求

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

Future<void> fetchPosts() async {
  final cancelToken = CancelToken();
  
  try {
    final response = await Resty.get('/posts', cancelToken: cancelToken);
    if (response.statusCode == 200) {
      final List<dynamic> posts = response.body;
      print('Posts: $posts');
    } else {
      print('Failed to load posts');
    }
  } catch (e) {
    if (CancelToken.isCancel(e)) {
      print('Request was cancelled');
    } else {
      print('Error: $e');
    }
  }
  
  // 取消请求
  cancelToken.cancel();
}