详解Flutter中网络框架dio的二次封装
其实dio框架已经封装的很好了,但是在实战项目中,为了项目可以统一管理,还是需要对dio框架进行二次封装。
整体思路:一般情况下,后台返回的数据我们可以分为两部分
- 1.状态数据
- 2.渲染数据
状态数据就是接口有没有正常返回数据相关的数据,这部分数据跟业务无关,我们可以封装起来统一管理,渲染数据就是我们渲染页面所需要的数据,这块的数据需要我们自己处理。
接下来我们就主要处理渲染数据这块的内容,我定义了两个函数,渲染数据可能为一个对象或者一个数组,我做了分别处理,定义两个函数来接受渲染数据。
// 定义两个函数
typedef Success<T> = Function(T data); 请求数据data为obj对象
typedef SuccessList<T> = Function(List<T> data); // 请求数据data为[]数组
首先我们需要定义两种数据接口的bean对象,返回对象示例:
/// 响应数据头数据统一管理
class BaseRes<T> {
int? code;// 状态码
String? message; // 状态码说明
T? data; // 渲染数据
BaseRes({this.code, this.message, this.data});
factory BaseRes.fromJson(json) {
// json 渲染json数据
try {
if (json["code"] != null) {
try {
code = json["code"];
} catch (e) {
code = -1;
}
} else {
return BaseRes(code: -1, message: "服务器开小差了~", data: null);
}
return BaseRes(
code: json["code"] ?? -1,
message: json["message"],
data: BeanFactory.generateOBJ<T>(json["data"]));
} catch (e) {
return BaseRes(code: -1, message: "服务器开小差了~", data: null);
}
}
}
返回数组示例省略... 只把 T?data 改为 List<T?> data 即可,大同小异。
渲染实体类转化:
/// 实体bean转化工厂类
class BeanFactory {
static T? generateOBJ<T>(json) {
//T.toString() 类名
try {
switch (T.toString()) {
case "int":
return json;
case "bool":
return json;
case "String":
return json;
default:
// 实体类序列化
return TestBean.formJson(json) as T;
}
} catch (e) {
return null;
}
}
}
实体类:
/// 测试bean
class TestBean {
String? msg;
bool? isSelector;
TestBean(this.msg,this.isSelector);
TestBean.fromJson(dynamic json) {
msg = json["msg"];
isSelector = json["isSelector"];
}
Map<String, dynamic> toJson() {
var map = <String, dynamic>{};
map["msg"] = msg;
map["isSelector"] = isSelector;
return map;
}
}
实际项目中用的JsonToDart插件一键生成即可。(这个插件唯一不好的地方,不能在已生成的文件里序列化,其他都很好)。
接下来就需要进行对dio请求进行二次封装,dio库核心请求方法是request方法,dio的get、post方法都是基于request方法,所以我们要自己再次对request方法进行封装成我们所需要的。
/// dio配置类
class DioManager {
static const baseUrl = "https://xxx"; // 正式环境
static DioManager instance = DioManager._internal();
Dio? _dio;
final Map<String, dynamic> _headers = {};
// 单例 私有化构造初始化dio
DioManager._internal() {
if (_dio == null) {
BaseOptions options = BaseOptions(
baseUrl: baseUrl,
contentType: Headers.jsonContentType,
responseType: ResponseType.json,
receiveDataWhenStatusError: false,
connectTimeout: _connectTimeout,
receiveTimeout: _receiveTimeout,
headers: _headers);
_dio = Dio(options);
/// 正式环境拦截日志打印
if (!const bool.fromEnvironment("dart.vm.product")) {
_dio?.interceptors
.add(LogInterceptor(requestBody: true, responseBody: true));
}
Future<Uint8List> imageToBytes(String imageUrl) async {
var response = await _dio?.get(imageUrl,
options: Options(responseType: ResponseType.bytes));
return Uint8List.fromList(response?.data);
}
get header => _headers;
/// 更新header
updateHeader() {
_dio?.options.headers = _headers;
}
/// 请求,返回的渲染数据 T
/// method:请求方法,NWMethod.GET等
/// path:请求地址
/// params:请求参数
/// success:请求成功回调
/// error:请求失败回调
Future request<T>(Method method, String path,
{String? baseUrl,
Map<String, dynamic>? params,
data,
ProgressCallback? onSendProgress, // 上传数据进度
ProgressCallback? onReceiveProgress, // 接受数据进度
Success<T>? success,
Function(ErrorRes)? error}) async {
try {
var connectivityResult = await (Connectivity().checkConnectivity());
if (connectivityResult == ConnectivityResult.none) {
if (error != null) {
error(ErrorRes(code: -9, message: "网络异常~,请检查您的网络状态!"));
}
return;
}
_setBaseUrl(baseUrl); // 动态设置baseUrl
Response? response = await _dio?.request(
path,
queryParameters: params,
data: data,
onSendProgress: onSendProgress,
onReceiveProgress: onReceiveProgress,
options: Options(method: methodValues[method]),
);
if (response != null) {
BaseRes entity = BaseRes<T>.fromJson(response.data);
// 对象数据结构
if (entity.code == 200 && entity.data != null) {
if (success != null) success(entity.data);
} else {
if (error != null) {
error(ErrorRes(code: entity.code, message: entity.message));
}
}
} else {
if (error != null) error(ErrorRes(code: -1, message: "未知错误"));
}
} on DioError catch (e) {
if (error != null) error(createErrorEntity(e));
}
}
Http最终调用类:
typedef Success<T> = Function(T data); // 定义一个函数 请求成功回调
typedef Error = Function(ErrorRes errorRes); // 请求失败统一回调
typedef SuccessList<T> = Function(List<T> data); // 请求数据data为[]集合
/// 通用调用接口类
class Http {
// 私有构造
Http._internal();
static Http instance = Http._internal();
/// get请求
/// baseUrl 切换baseUrl
/// params 参数
/// success 请求对象成功回调
/// successList 请求列表成功回调
/// error 错误回调
/// [isList] 请求的数据是否为List列表 默认对象
/// [isList]=true 请求data数据为[]list列表
void get<T>(String url,
{String? baseUrl,
Map<String, dynamic>? params,
Success<T>? success,
SuccessList<T>? successList,
Error? error,
bool isList = false}) {
if (isList) {
_requestList<T>(Method.get, url,
baseUrl: baseUrl, params: params, success: successList, error: error);
} else {
_request<T>(Method.get, url,
baseUrl: baseUrl, params: params, success: success, error: error);
}
}
/// post请求
/// baseUrl 切换baseUrl
/// params 参数
/// data 上传表单数据 formData
/// success 请求对象成功回调
/// successList 请求列表成功回调
/// error 错误回调
/// [isList] 请求的数据是否为List列表 默认对象
/// [isList]=true 请求data数据为[]list列表
void post<T>(String url,
{String? baseUrl,
Map<String, dynamic>? params,
required data,
Success<T>? success,
SuccessList<T>? successList,
Error? error,
bool isList = false}) {
if (isList) {
_requestList<T>(Method.post, url,
data: data,
baseUrl: baseUrl,
params: params,
success: successList,
error: error);
} else {
_request<T>(Method.post, url,
data: data,
baseUrl: baseUrl,
params: params,
success: success,
error: error);
}
}
实战应用调用:
我这边对对业务模块加了一层model处理,页面只需要混入我们的model层调用具体的方法即可。
mixin LoginModel {
// get请求
loadCode(
String value, {
required Success<String> success,
required Error error,
}) {
Http.instance.get(Api.loadxxx,
params: {"key": value}, success: success, error: error);
}
}
可以看到,我们在页面中只需要关注具体的业务请求就可以了。
以上就是详解Flutter中网络框架dio的二次封装的详细内容,更多关于Flutter dio二次封装的资料请关注编程网其它相关文章!
免责声明:
① 本站未注明“稿件来源”的信息均来自网络整理。其文字、图片和音视频稿件的所属权归原作者所有。本站收集整理出于非商业性的教育和科研之目的,并不意味着本站赞同其观点或证实其内容的真实性。仅作为临时的测试数据,供内部测试之用。本站并未授权任何人以任何方式主动获取本站任何信息。
② 本站未注明“稿件来源”的临时测试数据将在测试完成后最终做删除处理。有问题或投稿请发送至: 邮箱/279061341@qq.com QQ/279061341