Flutter网络请求插件sparrow_dio的使用

使用方法

dart-sparrow_dio 是对 dio 的封装，支持通过 async/await 或者回调函数的方式来发送网络请求。

异步请求

dart-sparrow_dio 提供了如下的方法别名：get, post, put, patch, delete, path, head, download，方便开发者直接调用。

示例代码

var res = await Request.get("http://www.baidu.com");
print(res);

回调方式请求

dart-sparrow_dio 还提供了带回调函数的方法别名：getCallback, postCallback, putCallback, patchCallback, deleteCallback, pathCallback, headCallback, downloadCallback。这种方式适用于需要处理成功或失败回调的场景。

示例代码

Request.getCallback(
  "http://www.baidu.com",
  success: (res) {
    _result = res.data;
    setState(() {});
  },
);

项目配置

设置Token

可以设置全局Token用于所有请求。

// 设置Token
Request.setToken('********');

设置钩子函数

当返回401状态码时，可以触发特定的钩子函数。

// 定义钩子函数
Request.setHook401(() {
  print('--------401--------');
});

设置输出

可以自定义输出结果。

// 设置输出
Request.setOutput((value) {
  showToast(value);
});

// 设置错误输出
Request.setOutputError((value) {
  showToastForException(value);
});

完整示例Demo

下面是一个完整的示例代码，展示了如何在Flutter应用中使用 dart-sparrow_dio 插件。

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

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

class MyApp extends StatelessWidget {
  // This widget is the root of your application.
  [@override](/user/override)
  Widget build(BuildContext context) {
    return MaterialApp(
      title: 'Flutter Demo',
      theme: ThemeData(
        primarySwatch: Colors.blue,
        visualDensity: VisualDensity.adaptivePlatformDensity,
      ),
      home: MyHomePage(title: 'Flutter Demo Home Page'),
    );
  }
}

class MyHomePage extends StatefulWidget {
  MyHomePage({Key key, this.title}) : super(key: key);

  final String title;

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

class _MyHomePageState extends State<MyHomePage> {
  String _result = "get 请求示例";

  [@override](/user/override)
  void initState() {
    super.initState();
  }

  Future _getUrl() async {
    /// async await 请求示例
    // var res = await Request.get(url: "http://www.baidu.com");
    // print(res);
    // _result = res.data;
    // setState(() {});

    /// callback 请求示例
    Request.getCallback(
      "http://www.baidu.com",
      data: {},
      queryParameters: {},
      complete: () {},
      success: (res) {
        _result = res.data;
        setState(() {});
      },
      error: (err) {},
    );
  }

  [@override](/user/override)
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(
        title: Text(widget.title),
      ),
      body: Center(
        child: Column(
          mainAxisAlignment: MainAxisAlignment.center,
          children: [
            Expanded(child: Text(_result)),
          ],
        ),
      ),
      floatingActionButton: FloatingActionButton(
        onPressed: _getUrl,
        tooltip: 'Get Url',
        child: Icon(Icons.send),
      ), // This trailing comma makes auto-formatting nicer for build methods.
    );
  }
}