Flutter API集成插件api_apptimus的使用

ApiBaseRequests 是一个提供方法来执行 API HTTP 请求的类。

使用

导入

首先，将 ApiBaseRequests 类导入到你的 Dart 文件中：

import 'package:api_apptimus/api_apptimus.dart';

创建实例

创建一个 ApiBaseRequests 的实例：

ApiBaseRequests _apiBaseRequests = ApiBaseRequests();

发送 GET 请求

你可以使用 get 方法发送 GET 请求：

var response = await _apiBaseRequests.get('/api/example');
print(response); // 根据响应结构处理响应

发送 POST 请求

你可以使用 post 方法发送 POST 请求：

var response = await _apiBaseRequests.post('/api/example', data: {'key': 'value'});
print(response); // 根据响应结构处理响应

处理响应

响应以动态对象的形式返回。你可以根据 API 的响应结构来处理它们。

NetworkExceptions

NetworkExceptions 是一个提供方法来处理在 API 请求过程中可能发生的网络异常的类。

使用

导入

首先，将 NetworkExceptions 类导入到你的 Dart 文件中：

import 'package:api_apptimus/api_apptimus.dart';

处理 Dio 异常

你可以使用 getDioException 方法来处理 Dio 异常：

try {
  // 发起 API 请求
} catch (e) {
  var networkException = NetworkExceptions.getDioException(e);
  print(networkException.message); // 根据异常情况处理
}

处理其他异常

你可以使用 getDefaultException 方法来处理其他异常：

try {
  // 发起 API 请求
} catch (e) {
  var networkException = NetworkExceptions.getDefaultException(e);
  print(networkException.message); // 根据异常情况处理
}

## 完整示例 Demo

以下是一个完整的示例代码，展示了如何在 Flutter 应用程序中使用 api_apptimus 插件。

```dart
import 'package:api_apptimus/api_apptimus.dart';
import 'package:flutter/material.dart';

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

class MyApp extends StatelessWidget {
  const MyApp({super.key});

  [@override](/user/override)
  Widget build(BuildContext context) {
    return MaterialApp(
      title: 'Api 集成',
      theme: ThemeData(
        colorScheme: ColorScheme.fromSeed(seedColor: Colors.deepPurple),
        useMaterial3: true,
      ),
      home: const MyHomePage(title: '简单的 Api 集成'),
    );
  }
}

class MyHomePage extends StatefulWidget {
  const MyHomePage({super.key, required this.title});

  final String title;

  [@override](/user/override)
  State<MyHomePage> createState() => _MyHomePageState();
}

class _MyHomePageState extends State<MyHomePage> {
  int _counter = 0;
  final ApiBaseRequests _apiBaseRequests = ApiBaseRequests();

  void _incrementCounter() async {
    setState(() {
      _counter++;
    });

    try {
      var response = await _apiBaseRequests.get('https://your/api');
      print(response); // 根据响应结构处理响应
    } catch (e) {
      var networkException = NetworkExceptions.getDioException(e);
      print(networkException.message); // 根据异常情况处理
    }
  }

  [@override](/user/override)
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(
        backgroundColor: Theme.of(context).colorScheme.inversePrimary,
        title: Text(widget.title),
      ),
      body: Center(
        child: Column(
          mainAxisAlignment: MainAxisAlignment.center,
          children: [
            const Text(
              '你已经点击了按钮次数：',
            ),
            Text(
              '$_counter',
              style: Theme.of(context).textTheme.headlineMedium,
            ),
          ],
        ),
      ),
      floatingActionButton: FloatingActionButton(
        onPressed: _incrementCounter,
        tooltip: '增加',
        child: const Icon(Icons.add),
      ),
    );
  }
}