用 FutureBuilder 提升开发效率

常见场景

  1. 展现请求按钮
  2. 用户点击按钮,显示loading
  3. 展现数据或者错误

抽象模式

  1. 展现请求按钮(初始状态
  2. 用户点击按钮,显示loading(请求中状态
  3. 展现数据或者错误 (结束状态(成功或失败)

转换成程序语言

以上三种现实状况对应 AsyncSnapshot 三个状态json

  • ConnectionState.none 初始态
  • ConnectionState.waiting 请求态
  • ConnectionState.done 完成态
    • snapshot.hasError 完成(异常)
    • snapshot.hasData 完成(正常)

使用 FutureBuilder 处理这个场景

这篇文章的主角,FutureBuilder 就是为了解决这个问题存在的。它接收一个 Future 请求,和对应以上几种状况的 widget 回调。便可把数据和界面串联起来,避免额外声明仅用来传递数据用的变量网络

提早声明了一个 _showResult 变量,以表示页面是否触发请求。 而且封装了一个 _fetch() 网络请求。async

Future<Map> _fetch() async {
    return (await Dio().get("https://jsonplaceholder.typicode.com/users/1"))
    .data;
}
复制代码

请求的结果是任意的,无论是封装好的对象,maplist,均可以,只要是一个 Future<T>fetch

把这个 Future 调用安放到 FutureBuilderfuture 参数上, 并用 _showResult 来控制什么时候来触发这个请求。jsonp

FutureBuilder(
    future: _showResult ? _fetch() : null,
    ...
)
复制代码

再把每个 Future 的结果对应的 widget 设置到 builder 参数上:ui

FutureBuilder(
    ...
    builder: (context, snapshot) {
      switch (snapshot.connectionState) {
        case ConnectionState.none: // -------- 初始态
          return RaisedButton(
            onPressed: () {
              setState(() {
                _showResult = true; // 点击按钮,触发请求
              });
            },
            child: Text("start"),
          );
        case ConnectionState.waiting: // -------- 请求态
          return CircularProgressIndicator();
        case ConnectionState.done: // -------- 完成态
          if (snapshot.hasError) { // 异常
            return Text(
              '${snapshot.error}', 
              style: TextStyle(color: Colors.red),
            );
          } else { // 正常
            return Text(snapshot.data["name"]);
          }
          break;
        default:
          break;
      }
      return Container();
    },
  ),
复制代码

总结

FutureBuilder 把数据请求的 Future<T> 中的数据 T 经过 BuilderConnectionState 衍生出全部可能性,并在每一个可能性里 return 一个 Widgets。最终实现了 state -> UI 的目的spa

相关文章
相关标签/搜索