Flutter网络通信插件sendingnetworkdart_api_lite的使用

简介

sendingnetworkdart_api_lite 是一个简单的客户端-服务器数据请求接口，提供了通用的API功能来与服务器交互。它不包含任何特定的业务逻辑，也不负责客户端的创建；相反，它专注于为服务器请求提供基本的API方法。

对于更复杂的逻辑，可以参考 sendingnetwork_dart_sdk。在大多数情况下，使用 sendingnetwork_dart_sdk 就足够了，因为它建立在 sendingnetworkdart_api_lite 的基础上。如果需要在业务逻辑层面创建客户端，则可以直接依赖 sendingnetwork_dart_sdk。

使用示例

以下是一个完整的示例，展示如何使用 sendingnetworkdart_api_lite 进行网络通信。

1. 添加依赖

在项目的 pubspec.yaml 文件中添加 sendingnetworkdart_api_lite 依赖：

dependencies:
  sendingnetworkdart_api_lite: ^1.0.0 # 替换为实际版本号

然后运行以下命令安装依赖：

flutter pub get

2. 示例代码

客户端代码

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

void main() {
  runApp(MyApp());
}

class MyApp extends StatelessWidget {
  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      home: NetworkExamplePage(),
    );
  }
}

class NetworkExamplePage extends StatefulWidget {
  @override
  _NetworkExamplePageState createState() => _NetworkExamplePageState();
}

class _NetworkExamplePageState extends State<NetworkExamplePage> {
  String _response = '等待响应...';
  bool _isLoading = false;

  // 发送网络请求的方法
  Future<void> fetchData() async {
    setState(() {
      _isLoading = true;
    });

    try {
      // 创建 API 实例
      final api = SendingNetworkApi();

      // 设置请求参数（例如 URL 和方法）
      final response = await api.sendRequest(
        method: 'GET', // 请求方法
        url: 'https://jsonplaceholder.typicode.com/posts/1', // 目标 URL
      );

      // 处理响应
      if (response.statusCode == 200) {
        setState(() {
          _response = response.body; // 获取响应体
        });
      } else {
        setState(() {
          _response = '请求失败: ${response.statusCode}';
        });
      }
    } catch (e) {
      setState(() {
        _response = '发生错误: $e';
      });
    } finally {
      setState(() {
        _isLoading = false;
      });
    }
  }

  @override
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(
        title: Text('发送网络请求示例'),
      ),
      body: Center(
        child: Column(
          mainAxisAlignment: MainAxisAlignment.center,
          children: [
            ElevatedButton(
              onPressed: fetchData,
              child: Text(_isLoading ? '加载中...' : '发送请求'),
            ),
            SizedBox(height: 20),
            Text(_response),
          ],
        ),
      ),
    );
  }
}

3. 代码解析

导入依赖

import 'package:sendingnetworkdart_api_lite/sendingnetworkdart_api_lite.dart';

导入 sendingnetworkdart_api_lite 包以使用其功能。

初始化 API

final api = SendingNetworkApi();

创建一个 SendingNetworkApi 实例，用于发送网络请求。

发送请求

final response = await api.sendRequest(
  method: 'GET',
  url: 'https://jsonplaceholder.typicode.com/posts/1',
);

调用 sendRequest 方法，指定请求方法（如 GET 或 POST）和目标 URL。这里我们使用了一个公共的 JSONPlaceholder API 来模拟服务器响应。

处理响应

if (response.statusCode == 200) {
  setState(() {
    _response = response.body;
  });
} else {
  setState(() {
    _response = '请求失败: ${response.statusCode}';
  });
}

检查 HTTP 响应状态码，并根据结果更新 UI。

错误处理

catch (e) {
  setState(() {
    _response = '发生错误: $e';
  });
}