文章目录
一、FutureBuilder 简介
二、处理 Flutter 中的中文乱码
三、完整代码示例
四、相关资源
一、FutureBuilder 简介
FutureBuilder 本质是组件 : FutureBuilder 构造好以后 , 会自动执行异步操作 , 并返回 Widget 组件 , 因此 FutureBuilder 也是一个组件 , 在不同的状态下显示不同样式的组件 ;
FutureBuilder 泛型设置 : FutureBuilder 的泛型 , 表示异步调用得到的 Future 的泛型 , 也就是返回结果的格式 ; FutureBuilder<CommonModel> 表示异步调用 Future 的返回值是 Future<CommonModel> ;
Future<T> future 参数设置 : 这是设置的是异步操作方法 , 下面的 httpGet() 方法 , 是一个返回 Future<CommonModel> 类型的方法 , 可以直接设置给 FutureBuilder 构造函数作为参数 ;
/// 调用 Http Get 方法 , 获取服务器的 json 数据 Future<CommonModel> httpGet() async { //var url = Uri.parse('https://jsonplaceholder.typicode.com/posts/1'); var url = Uri.parse('https://www.devio.org/io/flutter_app/json/test_common_model.json'); // 异步请求 , 获取远程服务器信息 final response = await http.get(url); /// 处理中文乱码 Utf8Decoder utf8decoder = Utf8Decoder(); /// 将二进制 Byte 数据以 UTF-8 格式编码 , 获取编码后的字符串 String responseString = utf8decoder.convert(response.bodyBytes); // 将 json 字符串信息转为 Map<String, dynamic> 类型的键值对信息 Map<String, dynamic> jsonMap = json.decode(responseString); return CommonModel.fromJson(jsonMap); }
@required AsyncWidgetBuilder<T> builder 参数是必须设置的参数 , 该参数是 AsyncWidgetBuilder<T> 类型 的方法 :
typedef AsyncWidgetBuilder<T> = Widget Function(BuildContext context, AsyncSnapshot<T> snapshot);
传入的参数如下 : 自己写一个匿名函数 , 参数是 BuildContext context, AsyncSnapshot<T> snapshot , 返回值是 Widget ;
(BuildContext context, AsyncSnapshot<CommonModel> snapshot){ return Text(""); }
在上述 匿名函数 中 , 开始根据 AsyncSnapshot<CommonModel> snapshot 参数进行各种操作 , BuildContext context 参数在本次没有用到 ;
通过 snapshot.connectionState 可以获取当前异步请求的状态 , 可以在请求中显示进度条 , 请求后判定是否请求成功 , 如果出错 , 则显示报错信息 , 如果请求成功 , 则显示请求成功的信息 ;
无论怎样 , 最终要返回一个 Widget 组件 ;
FutureBuilder 构造函数完整代码示例 :
@override Widget build(BuildContext context) { return MaterialApp( home: Scaffold( appBar: AppBar( title: Text("HTTP Get 请求"), ), // 线性布局 列 body: FutureBuilder<CommonModel>( // 设置异步调用的方法 future: httpGet(), /// 接收如下类型的对象 /// typedef AsyncWidgetBuilder<T> = Widget Function(BuildContext context, AsyncSnapshot<T> snapshot); builder: (BuildContext context, AsyncSnapshot<CommonModel> snapshot){ /// 判断 AsyncSnapshot 的连接状态 switch(snapshot.connectionState){ case ConnectionState.none: return Text("未连接"); case ConnectionState.waiting: /// 返回一个进度条 return Center(child: CircularProgressIndicator(),); case ConnectionState.active: /// 激活状态 , 返回一个进度条 return Text(""); case ConnectionState.done: /// 请求结束 , 如果出现错误 , 则返回错误信息 /// 如果请求成功 , 返回从网络中请求的数据 if(snapshot.hasError) { return Text("请求失败 , 报错信息 : ${snapshot.error}", style: TextStyle(color: Colors.red),); } else { return Text("请求成功 , 获取信息 : ${snapshot.data?.url}", style: TextStyle(color: Colors.green),); } } }, ), ), ); }
二、处理 Flutter 中的中文乱码
数据是以 UTF-8 格式进行编码的 , 只能以 UTF-8 格式进行解码 ;
创建 Utf8Decoder 解码器 ,
/// 处理中文乱码 Utf8Decoder utf8decoder = Utf8Decoder();
调用解码器的 convert 方法 , 传入原始的二进制数据 , 注意是字节数组类型的数据 ;
/// 将二进制 Byte 数据以 UTF-8 格式编码 , 获取编码后的字符串 String responseString = utf8decoder.convert(response.bodyBytes);
得到的返回值就是编码正确的字符串文本信息 ;
完整代码示例 :
/// 调用 Http Get 方法 , 获取服务器的 json 数据 Future<CommonModel> httpGet() async { //var url = Uri.parse('https://jsonplaceholder.typicode.com/posts/1'); var url = Uri.parse('https://www.devio.org/io/flutter_app/json/test_common_model.json'); // 异步请求 , 获取远程服务器信息 final response = await http.get(url); /// 处理中文乱码 Utf8Decoder utf8decoder = Utf8Decoder(); /// 将二进制 Byte 数据以 UTF-8 格式编码 , 获取编码后的字符串 String responseString = utf8decoder.convert(response.bodyBytes); // 将 json 字符串信息转为 Map<String, dynamic> 类型的键值对信息 Map<String, dynamic> jsonMap = json.decode(responseString); return CommonModel.fromJson(jsonMap); }
