Flutter网络请求服务插件igot_http_service_helper的使用

igot_http_service_helper 是一个用于简化 Flutter 应用中网络请求的插件。它提供了一种简单的方式来执行 HTTP 请求，并处理响应数据。以下是如何使用 igot_http_service_helper 的基本步骤：

1. 添加依赖

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

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

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

2. 导入包

在你的 Dart 文件中导入 igot_http_service_helper：

import 'package:igot_http_service_helper/igot_http_service_helper.dart';

3. 初始化服务

在使用之前，你可以初始化 HttpServiceHelper，通常你可以在 main.dart 中进行初始化：

void main() {
  HttpServiceHelper.init(
    baseUrl: 'https://api.example.com', // 你的API基础URL
    headers: {
      'Content-Type': 'application/json',
      'Authorization': 'Bearer your_token',
    },
  );
  runApp(MyApp());
}

4. 发起网络请求

你可以使用 HttpServiceHelper 提供的方法来发起 GET、POST、PUT、DELETE 等请求。

GET 请求

Future<void> fetchData() async {
  try {
    var response = await HttpServiceHelper.get('/endpoint');
    print('Response data: ${response.data}');
  } catch (e) {
    print('Error: $e');
  }
}

POST 请求

Future<void> postData() async {
  try {
    var response = await HttpServiceHelper.post(
      '/endpoint',
      data: {
        'key1': 'value1',
        'key2': 'value2',
      },
    );
    print('Response data: ${response.data}');
  } catch (e) {
    print('Error: $e');
  }
}

PUT 请求

Future<void> updateData() async {
  try {
    var response = await HttpServiceHelper.put(
      '/endpoint',
      data: {
        'key1': 'updated_value1',
        'key2': 'updated_value2',
      },
    );
    print('Response data: ${response.data}');
  } catch (e) {
    print('Error: $e');
  }
}

DELETE 请求

Future<void> deleteData() async {
  try {
    var response = await HttpServiceHelper.delete('/endpoint');
    print('Response data: ${response.data}');
  } catch (e) {
    print('Error: $e');
  }
}

5. 处理响应

HttpServiceHelper 返回的响应对象通常包含 data、statusCode 等信息。你可以根据需要进行处理。

Future<void> fetchData() async {
  try {
    var response = await HttpServiceHelper.get('/endpoint');
    if (response.statusCode == 200) {
      print('Data: ${response.data}');
    } else {
      print('Failed to load data: ${response.statusCode}');
    }
  } catch (e) {
    print('Error: $e');
  }
}

6. 错误处理

HttpServiceHelper 会自动处理一些常见的网络错误，但你也可以在 catch 块中自定义错误处理逻辑。

Future<void> fetchData() async {
  try {
    var response = await HttpServiceHelper.get('/endpoint');
    print('Response data: ${response.data}');
  } on DioError catch (e) {
    print('DioError: ${e.message}');
  } catch (e) {
    print('Error: $e');
  }
}

7. 其他配置

你还可以在 HttpServiceHelper.init 中配置其他选项，如超时时间、拦截器等。

HttpServiceHelper.init(
  baseUrl: 'https://api.example.com',
  headers: {
    'Content-Type': 'application/json',
    'Authorization': 'Bearer your_token',
  },
  connectTimeout: 5000, // 连接超时时间
  receiveTimeout: 3000, // 接收超时时间
  interceptors: [
    (RequestOptions options) {
      // 请求拦截器
      print('Request: ${options.method} ${options.path}');
      return options;
    },
    (Response response) {
      // 响应拦截器
      print('Response: ${response.statusCode}');
      return response;
    },
  ],
);

8. 使用示例

以下是一个完整的示例，展示如何在 Flutter 应用中使用 igot_http_service_helper 进行网络请求：

import 'package:flutter/material.dart';
import 'package:igot_http_service_helper/igot_http_service_helper.dart';

void main() {
  HttpServiceHelper.init(
    baseUrl: 'https://api.example.com',
    headers: {
      'Content-Type': 'application/json',
      'Authorization': 'Bearer your_token',
    },
  );
  runApp(MyApp());
}

class MyApp extends StatelessWidget {
  [@override](/user/override)
  Widget build(BuildContext context) {
    return MaterialApp(
      home: Scaffold(
        appBar: AppBar(
          title: Text('HttpServiceHelper Example'),
        ),
        body: Center(
          child: ElevatedButton(
            onPressed: () {
              fetchData();
            },
            child: Text('Fetch Data'),
          ),
        ),
      ),
    );
  }

  Future<void> fetchData() async {
    try {
      var response = await HttpServiceHelper.get('/endpoint');
      if (response.statusCode == 200) {
        print('Data: ${response.data}');
      } else {
        print('Failed to load data: ${response.statusCode}');
      }
    } catch (e) {
      print('Error: $e');
    }
  }
}