Flutter网络请求辅助插件http_request_utils的使用

Http Request Utils 是一个用于处理 JSON 请求响应的工具包，它提供了对 JSON 中包含的键值更大的控制能力。通常情况下，我们通过模型解析 JSON 数据时，只依赖于映射中的某个键值，但如果其中任何一个键值失败，我们只能通过查看控制台输出来了解缺少了什么或类型是否不正确。而使用此插件后，会抛出特定的 BodyException 异常，明确指出该键值为 null、类型错误还是根本不存在。

此外，该插件还包含一个 HttpException 模型，可以更方便地处理请求失败的情况。通过此异常，您可以集中管理所有请求中发生的异常，并以简单的对话框或自定义的单一小部件进行统一处理。

功能特性

Body Utils

• 解析简单的 JSON 键值。
• 解析多个 JSON 键值。
• 判断某个键值是否可以为 null。
• 在键值为 null 的情况下提供默认值。

新功能

• 现在支持解析列表，可以通过传递一个映射方法来转换列表。
• 现在支持解析类，甚至可以在出现异常时返回 null。

Http Exception

• 接收一条消息。
• 接收一个状态码。
• 接收一个原因。
• 接收一个 HTTP 状态码。

使用方法

对于 Body Utils 的使用

factory RequestData.fromJson (dynamic json) {
    return RequestData(
        id: jsonField<String> (json, ["_id", "\$oid"], nullable: false), // 解析单个键值
        name: jsonField<String> (json, ["name",],  nullable: false), // 解析单个键值
        number: jsonField<num> (json, ["number"],  nullable: false), // 解析单个键值
        integer: jsonField<int> (json, ["integer",],  nullable: false), // 解析单个键值
        shortMap: jsonField<dynamic> (json, ["short_map",],  nullable: false), // 解析单个键值
        object: jsonClassField<Object> (json, ["class"], nullOnException: true), // 解析类对象
        aList: jsonListField<ListObject> (
            json, ["a_list"], 
            map: ListObject.fromJson, // 映射方法
            nullable: false
        ),
        date: DateTime.fromMillisecondsSinceEpoch(
            jsonField<int> (json, ["date", "\$date"]), // 解析日期字段
        )
    );
}

// 调用位置
try {
    RequestData myData = RequestData.fromJson(response_body); // 将 JSON 数据解析为对象
} on BodyException catch (error) {
    // 处理解析异常
}

对于 Http Exception 的使用

try {
    final response = await http.get(Uri.parse("https://example.com/api"), headers: {}); // 发起网络请求

    switch (response.statusCode) {
        case 200:
            // 成功操作
            break;
        default:
            // 错误处理
            throw HttpException(
                response.body, // 错误信息
                code: Code.request, // 自定义错误码
                reason: Reason.server, // 错误原因
                status: response.statusCode // HTTP 状态码
            );
    }
} on HttpException {
    rethrow; // 重新抛出异常
} catch (error) {
    throw HttpException(
        error.toString, // 错误信息
        code: Code.system, // 自定义错误码
        status: -1 // 自定义状态码
    );
}