network_services 是一个用于处理网络请求的 Flutter 插件，它简化了与 RESTful API 的交互。它通常用于执行 HTTP 请求（如 GET、POST、PUT、DELETE 等），并处理响应数据。以下是如何在 Flutter 项目中使用 network_services 插件的基本步骤。

1. 添加依赖

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

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

然后运行 flutter pub get 来获取依赖。

2. 导入插件

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

import 'package:network_services/network_services.dart';

3. 创建 NetworkService 实例

你可以通过 NetworkService 类来执行网络请求。首先，创建一个 NetworkService 实例。

final NetworkService networkService = NetworkService();

4. 执行网络请求

你可以使用 NetworkService 实例来执行各种 HTTP 请求。以下是一些常见的请求示例：

GET 请求

Future<void> fetchData() async {
  final response = await networkService.get('https://jsonplaceholder.typicode.com/posts');
  if (response.statusCode == 200) {
    print('Data fetched successfully: ${response.body}');
  } else {
    print('Failed to load data');
  }
}

POST 请求

Future<void> postData() async {
  final Map<String, dynamic> data = {
    'title': 'foo',
    'body': 'bar',
    'userId': 1,
  };

  final response = await networkService.post(
    'https://jsonplaceholder.typicode.com/posts',
    body: data,
  );

  if (response.statusCode == 201) {
    print('Data posted successfully: ${response.body}');
  } else {
    print('Failed to post data');
  }
}

PUT 请求

Future<void> updateData() async {
  final Map<String, dynamic> data = {
    'id': 1,
    'title': 'foo',
    'body': 'bar',
    'userId': 1,
  };

  final response = await networkService.put(
    'https://jsonplaceholder.typicode.com/posts/1',
    body: data,
  );

  if (response.statusCode == 200) {
    print('Data updated successfully: ${response.body}');
  } else {
    print('Failed to update data');
  }
}

DELETE 请求

Future<void> deleteData() async {
  final response = await networkService.delete('https://jsonplaceholder.typicode.com/posts/1');

  if (response.statusCode == 200) {
    print('Data deleted successfully');
  } else {
    print('Failed to delete data');
  }
}

5. 处理错误

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

Future<void> fetchData() async {
  try {
    final response = await networkService.get('https://jsonplaceholder.typicode.com/posts');
    if (response.statusCode == 200) {
      print('Data fetched successfully: ${response.body}');
    } else {
      print('Failed to load data');
    }
  } catch (e) {
    print('An error occurred: $e');
  }
}

6. 自定义请求头

你可以在请求中添加自定义的请求头。

Future<void> fetchDataWithHeaders() async {
  final Map<String, String> headers = {
    'Authorization': 'Bearer your_token',
    'Content-Type': 'application/json',
  };

  final response = await networkService.get(
    'https://jsonplaceholder.typicode.com/posts',
    headers: headers,
  );

  if (response.statusCode == 200) {
    print('Data fetched successfully: ${response.body}');
  } else {
    print('Failed to load data');
  }
}

7. 处理 JSON 数据

通常，API 返回的数据是 JSON 格式的。你可以使用 dart:convert 库来解析 JSON 数据。

import 'dart:convert';

Future<void> fetchData() async {
  final response = await networkService.get('https://jsonplaceholder.typicode.com/posts');
  if (response.statusCode == 200) {
    final List<dynamic> data = jsonDecode(response.body);
    print('Data fetched successfully: $data');
  } else {
    print('Failed to load data');
  }
}

8. 配置 Base URL

如果你有多个请求指向同一个基础 URL，你可以配置一个基础 URL，然后在请求时只指定路径。

final NetworkService networkService = NetworkService(baseUrl: 'https://jsonplaceholder.typicode.com');

Future<void> fetchData() async {
  final response = await networkService.get('/posts');
  if (response.statusCode == 200) {
    print('Data fetched successfully: ${response.body}');
  } else {
    print('Failed to load data');
  }
}