bzframework_network 是一个用于 Flutter 的网络请求插件，它简化了网络请求的处理过程，提供了便捷的 API 来进行 HTTP 请求。以下是如何使用 bzframework_network 插件的基本步骤：

1. 添加依赖

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

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

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

2. 初始化网络请求

在使用 bzframework_network 之前，你需要初始化网络请求的配置。通常你可以在 main.dart 文件中进行初始化：

import 'package:bzframework_network/bzframework_network.dart';

void main() {
  BZNetwork.init(
    baseUrl: 'https://api.example.com', // 你的 API 基础 URL
    connectTimeout: 5000, // 连接超时时间
    receiveTimeout: 5000, // 接收超时时间
  );

  runApp(MyApp());
}

3. 发起网络请求

bzframework_network 提供了多种方法来发起网络请求，包括 GET、POST、PUT、DELETE 等。

GET 请求

import 'package:bzframework_network/bzframework_network.dart';

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

POST 请求

import 'package:bzframework_network/bzframework_network.dart';

Future<void> postData() async {
  try {
    var response = await BZNetwork.post(
      '/endpoint',
      data: {'key': 'value'}, // 请求体数据
    );
    print('Response data: ${response.data}');
  } catch (e) {
    print('Error: $e');
  }
}

PUT 请求

import 'package:bzframework_network/bzframework_network.dart';

Future<void> updateData() async {
  try {
    var response = await BZNetwork.put(
      '/endpoint',
      data: {'key': 'new_value'}, // 请求体数据
    );
    print('Response data: ${response.data}');
  } catch (e) {
    print('Error: $e');
  }
}

DELETE 请求

import 'package:bzframework_network/bzframework_network.dart';

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

4. 处理响应

BZNetwork 的请求方法返回一个 Response 对象，你可以通过 response.data 来获取响应的数据。

var response = await BZNetwork.get('/endpoint');
print('Response data: ${response.data}');

5. 错误处理

你可以使用 try-catch 来捕获网络请求中的错误：

try {
  var response = await BZNetwork.get('/endpoint');
  print('Response data: ${response.data}');
} catch (e) {
  print('Error: $e');
}

6. 添加请求头

你可以在发起请求时添加自定义的请求头：

var response = await BZNetwork.get(
  '/endpoint',
  headers: {'Authorization': 'Bearer your_token'},
);

7. 其他配置

BZNetwork 还支持其他配置，例如设置拦截器、添加查询参数等。你可以参考插件的文档来了解更多高级用法。

8. 示例代码

以下是一个完整的示例代码，展示了如何使用 bzframework_network 发起 GET 请求并处理响应：

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

void main() {
  BZNetwork.init(
    baseUrl: 'https://api.example.com',
    connectTimeout: 5000,
    receiveTimeout: 5000,
  );

  runApp(MyApp());
}

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

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