flutter_rest_http 是一个用于在 Flutter 中进行网络请求的插件。它提供了简单易用的 API，使得开发者可以轻松地进行 RESTful API 调用。以下是如何使用 flutter_rest_http 插件进行网络请求的基本步骤。

1. 添加依赖

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

dependencies:
  flutter:
    sdk: flutter
  flutter_rest_http: ^1.0.0  # 请检查最新版本

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

2. 导入插件

在你的 Dart 文件中导入 flutter_rest_http 插件。

import 'package:flutter_rest_http/flutter_rest_http.dart';

3. 创建 HTTP 客户端

你可以使用 RestHttpClient 类来创建一个 HTTP 客户端实例。

final httpClient = RestHttpClient();

4. 发送 GET 请求

使用 get 方法发送 GET 请求。

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

5. 发送 POST 请求

使用 post 方法发送 POST 请求。

Future<void> postData() async {
  try {
    final response = await httpClient.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');
  }
}

6. 发送 PUT 请求

使用 put 方法发送 PUT 请求。

Future<void> updateData() async {
  try {
    final response = await httpClient.put(
      'https://jsonplaceholder.typicode.com/posts/1',
      body: {
        'id': 1,
        'title': 'foo',
        'body': 'bar',
        'userId': 1,
      },
    );
    print('Response status: ${response.statusCode}');
    print('Response body: ${response.body}');
  } catch (e) {
    print('Error: $e');
  }
}

7. 发送 DELETE 请求

使用 delete 方法发送 DELETE 请求。

Future<void> deleteData() async {
  try {
    final response = await httpClient.delete('https://jsonplaceholder.typicode.com/posts/1');
    print('Response status: ${response.statusCode}');
    print('Response body: ${response.body}');
  } catch (e) {
    print('Error: $e');
  }
}

8. 处理响应

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

final response = await httpClient.get('https://jsonplaceholder.typicode.com/posts');
print('Status Code: ${response.statusCode}');
print('Response Body: ${response.body}');

9. 错误处理

在进行网络请求时，可能会遇到各种错误，如网络连接问题、服务器错误等。你可以使用 try-catch 来捕获并处理这些错误。

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

10. 自定义请求头

你可以通过 headers 参数来添加自定义请求头。

final response = await httpClient.get(
  'https://jsonplaceholder.typicode.com/posts',
  headers: {
    'Authorization': 'Bearer your_token_here',
  },
);

11. 超时设置

你可以通过 timeout 参数来设置请求的超时时间。

final response = await httpClient.get(
  'https://jsonplaceholder.typicode.com/posts',
  timeout: Duration(seconds: 10),
);

12. 处理 JSON 数据

如果服务器返回的是 JSON 数据，你可以使用 dart:convert 库来解析 JSON 数据。

import 'dart:convert';

final response = await httpClient.get('https://jsonplaceholder.typicode.com/posts');
final List<dynamic> data = json.decode(response.body);
print('First post title: ${data[0]['title']}');