ume_kit_dio #

概述

ume_kit_dio 是一个用于增强 Flutter 网络请求功能的插件。它基于 Dio 库，并提供了更方便的 API 和一些额外的功能。

安装

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

dependencies:
  ume_kit_dio: ^版本号

初始化

在应用启动时进行初始化：

import 'package:ume_kit_dio/ume_kit_dio.dart';
void main() {
runApp(MyApp());
}
class MyApp extends StatelessWidget {
@override
Widget build(BuildContext context) {
UmeKitDio.init();
return MaterialApp(
home: Scaffold(
appBar: AppBar(title: Text(‘ume_kit_dio 示例’)),
body: Center(child: Text(‘欢迎使用 ume_kit_dio’)),
),
);
}
}

发送网络请求

使用 ume_kit_dio 发送 GET 请求：

import 'package:ume_kit_dio/ume_kit_dio.dart';
Future<void> fetchData() async {
try {
final response = await UmeKitDio.instance.get(‘https://jsonplaceholder.typicode.com/posts/1’);
print(‘响应数据: ${response.data}’);
} catch (e) {
print(‘错误信息: $e’);
}
}

发送 POST 请求

使用 ume_kit_dio 发送 POST 请求：

import 'package:ume_kit_dio/ume_kit_dio.dart';
Future<void> postData() async {
try {
final response = await UmeKitDio.instance.post(
‘https://jsonplaceholder.typicode.com/posts’,
data: {“title”: “foo”, “body”: “bar”, “userId”: 1},
);
print(‘响应数据: ${response.data}’);
} catch (e) {
print(‘错误信息: $e’);
}
}

处理拦截器

可以添加拦截器来处理请求和响应：

import 'package:ume_kit_dio/ume_kit_dio.dart';
void setupInterceptors() {
UmeKitDio.instance.interceptors.add(InterceptorsWrapper(
onRequest: (options, handler) {
print(‘请求前处理: ${options.path}’);
handler.next(options); // 继续执行下一个拦截器或请求
},
onResponse: (response, handler) {
print(‘响应后处理: ${response.data}’);
handler.next(response); // 继续执行下一个拦截器或响应
},
onError: (error, handler) {
print(‘错误处理: ${error.message}’);
handler.next(error); // 继续执行下一个拦截器或错误处理
},
));
}

完整的示例代码

以下是一个完整的示例代码，展示了如何初始化、发送 GET 和 POST 请求以及设置拦截器：

import 'package:flutter/material.dart';
import 'package:ume_kit_dio/ume_kit_dio.dart';
void main() {
runApp(MyApp());
}
class MyApp extends StatelessWidget {
@override
Widget build(BuildContext context) {
UmeKitDio.init();
setupInterceptors(); // 设置拦截器
return MaterialApp(
  home: Scaffold(
    appBar: AppBar(title: Text('ume_kit_dio 示例')),
    body: Center(
      child: Column(
        mainAxisAlignment: MainAxisAlignment.center,
        children: <Widget>[
          ElevatedButton(
            onPressed: fetchData,
            child: Text('获取数据'),
          ),
          SizedBox(height: 20),
          ElevatedButton(
            onPressed: postData,
            child: Text('发送数据'),
          ),
        ],
      ),
    ),
  ),
);
}
Future<void> fetchData() async {
try {
final response = await UmeKitDio.instance.get(‘https://jsonplaceholder.typicode.com/posts/1’);
print(‘响应数据: ${response.data}’);
} catch (e) {
print(‘错误信息: $e’);
}
}
Future<void> postData() async {
try {
final response = await UmeKitDio.instance.post(
‘https://jsonplaceholder.typicode.com/posts’,
data: {“title”: “foo”, “body”: “bar”, “userId”: 1},
);
print(‘响应数据: ${response.data}’);
} catch (e) {
print(‘错误信息: $e’);
}
}
}
void setupInterceptors() {
UmeKitDio.instance.interceptors.add(InterceptorsWrapper(
onRequest: (options, handler) {
print(‘请求前处理: ${options.path}’);
handler.next(options);
},
onResponse: (response, handler) {
print(‘响应后处理: ${response.data}’);
handler.next(response);
},
onError: (error, handler) {
print(‘错误处理: ${error.message}’);
handler.next(error);
},
));
}