Flutter实战-请求封装(一)

注意:无特殊说明,flutter版本为3.0+

        所有程序的开发,包括原生开发,web前端,小程序等都不可避免的做一件事情那就是封装与后台交互的请求,然后便于接收数据,那么我们今天就一步一步把flutter的封装写清楚。

一.模块划分

好的项目结构要模块划分清晰,包括api请求,举个例子

比如base为基础api,包含登录,注册,设置等接口。bi为报表统计接口,以此类推,商品,订单等等。

二.请求封装

我们先看封装需求 1.将请求url定义在头部,方便查找和修改

2.封装请求方法HttpUtils(这个我们在新的篇章单独说)

3.定义请求和返回的实体类。一般的接口返回有几种情况

    返回是否成功等信息,结果可能是String,bool 返回一个实体类,比如用户信息UserDo 返回实体类的列表,List<Object>, 入返回登录用户的权限列表等

我们看一下包括三种类型的简单示例:

class UserApi { /// 查询登录用户 static const String _getUser = "/base/login/user"; /// 登录 static const String _login ="/base/login"; //查询登录权限 static const _selectPermission = "/base/selectPermission"; static Future<UserDo> getUser() async { &nbsp;&nbsp;&nbsp;&nbsp;var res = await HttpUtils.get(_getUser, baseUrl: Config.BASE_API_URL); &nbsp;&nbsp;&nbsp;&nbsp;return UserDo.fromJson(res); } static Future<String> login(dynamic param) async { &nbsp;&nbsp;&nbsp;&nbsp;var res = await HttpUtils.post(_login, data: param, baseUrl: &nbsp;&nbsp;&nbsp;&nbsp;Config.BASE_API_URL, showLoading: showLoad); &nbsp;&nbsp;&nbsp;&nbsp;return res; } static Future<List<Permission>> selectPermission(List<String> permissions) async { var res = await HttpUtils.post( &nbsp;&nbsp;&nbsp;&nbsp;_selectPermission, &nbsp;&nbsp;&nbsp;&nbsp;data: permissions, &nbsp;&nbsp;&nbsp;&nbsp;baseUrl: Config.BASE_API_URL, ); return res.map<Permission>((e) => Permission.fromJson(e)).toList(); }

三.Json处理:FlutterJsonBeanFactory

&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Dart语言在Json转换的方面框架不够成熟,也没有类似Java等语言的反射机制,如果手动处理返回结果的转换,将是非常麻烦的一件事,所幸大神还是非常多的,这里推荐一个转换工具FlutterJsonBeanFactory,可以快速生成,并可以使用上文例子中的转换方法:fromJson和toJson。

安装方法:

Settings/Preferences > Plugins > Marketplace > Search for "FlutterJsonBeanFactory" > Install Plugin

使用:

将PostMan的返回结果,直接复制在工具的创建窗口,就会自动根据类型

生成实体

当然也支持实体类型嵌套。


结语:

感兴趣的读者可以自行研究源码。

附插件地址:

经验分享 程序员 微信小程序 职场和发展