Flutter插件restopi的特性与使用方法详解

本文将探讨一个名为restopi的Flutter插件的功能及其潜在用途。该插件旨在以非常简单的方式执行API调用，并内置了加载功能，同时能够处理各种状态码。

Flutter插件restopi的特性

• 简单的API调用形式
• 内置加载功能
• 处理API错误码

开始使用Flutter插件restopi

设置基础URL

在main()函数中设置基础URL：

Restopi.baseUrl = "gorest.co.in";

启用加载功能

如果需要启用加载动画，可以将enableLoading设置为true：

Restopi.enableLoading = true;

添加加载初始化

如果启用了加载功能，需要在MaterialApp中添加Restopi().builderInit()：

MaterialApp(
  title: 'Flutter Demo',
  theme: ThemeData(
    primarySwatch: Colors.blue,
  ),
  builder: Restopi.builderInit(), // 初始化加载功能
  home: const MyHomePage(title: 'Flutter Demo Home Page'),
);

自定义加载样式

可以通过以下方式自定义加载动画的样式：

Restopi().restopiInitialize(
  indicatorColor: Colors.black, // 加载指示器的颜色
  progressColors: Colors.black, // 进度条颜色
  backgroundColor: Colors.blueAccent, // 背景颜色
  textColor: Colors.red, // 文本颜色
  maskColor: Colors.amber, // 遮罩层颜色
  indicatorSize: 30, // 指示器大小
  radius: 20, // 圆角半径
  userInteractions: true, // 是否允许用户交互
  dismissOnTap: false, // 是否点击时关闭加载
  easyLoadingIndicatorType: EasyLoadingIndicatorType.circle, // 加载动画类型
  easyLoadingStyle: EasyLoadingStyle.dark, // 加载主题风格
);

使用示例

以下是一个完整的API调用示例：

Restopi().hitRestopi(
  buildContext: context, // 当前上下文
  query: {}, // 查询参数
  body: {}, // 请求体
  restopiMethod: RestopiMethods.post, // 请求方法（如POST）
  urlEndPoint: 'public/v2/users', // API端点
  headers: {"content-language": "en"}, // 请求头
  onFail: (value) { // 错误回调
    print("请求失败: $value");
  },
  onConnectionLost: () { // 网络断开回调
    print("网络连接丢失");
  },
  showLoading: true, // 是否显示加载动画
  onSuccess: (value) { // 成功回调
    print("请求成功: $value");
  },
);