跨平台开发 / 系统课时
用 Dio 发送 GET 请求
用 Dio 发送 GET 请求
在 Flutter 应用中,Dio 是常用的 HTTP 网络库,它提供了请求封装、响应处理、拦截器和错误管理能力。本篇将创建 Dio 实例并完成一次 GET 请求,读取接口返回的状态码、响应头和数据。
学习目标
- 掌握 Dio 实例创建和 GET 请求调用方式。
- 理解 Response 中状态码、请求头和数据字段的作用。
- 能验证接口调用结果并处理基础异常。
添加 Dio 依赖并创建客户端
Dio 不是 Flutter SDK 自带组件,需要在项目中添加依赖。配置完成后,可以通过 Dio 对象统一管理网络请求。
yaml
# pubspec.yaml 依赖片段示例
# 需要放在 dependencies 节点下
dependencies:
dio: ^5.7.0依赖版本可能随项目时间变化,实际开发中应根据项目约束选择兼容版本。
使用 Dio 发起 GET 请求
下面示例请求公开测试接口,并读取响应状态码、响应头和 JSON 数据。
dart
import 'package:dio/dio.dart';
Future<void> main() async {
final dio = Dio();
try {
final response = await dio.get(
'https://jsonplaceholder.typicode.com/todos/1',
);
print('status: ${response.statusCode}');
print('content-type: ${response.headers.value('content-type')}');
print('data: ${response.data}');
} on DioException catch (error) {
print('request failed: ${error.message}');
}
}预期输出
text
status: 200
content-type: application/json; charset=utf-8
data: {userId: 1, id: 1, title: delectus aut autem, completed: false}Dio 会将 JSON 响应自动解析为 Dart 对象结构。response.data 可以直接用于后续模型转换。
理解 Response 中的重要信息
一次 GET 请求完成后,Dio 返回 Response 对象,其中常用字段如下:
| 字段 | 用途 |
|---|---|
| statusCode | 判断 HTTP 请求是否成功 |
| headers | 获取服务器返回的响应头 |
| data | 获取解析后的响应内容 |
| requestOptions | 查看本次请求配置 |
业务代码通常不会直接依赖完整响应对象,而是根据状态码和数据内容转换成应用需要的模型。
处理 GET 请求失败
网络请求失败不一定代表服务器错误。Dio 常见异常来源包括连接超时、请求取消、服务器返回错误状态等。
可以根据异常类型记录日志或展示用户提示。例如:
- 超时:提示用户检查网络后重试。
- 认证失败:引导用户重新登录。
- 服务异常:记录错误并等待服务恢复。
生产环境中通常会进一步封装 Dio,例如统一设置基础地址、超时时间和请求拦截器,让页面代码只关注业务数据。
GET 请求的适用边界
GET 适合读取资源,例如获取用户信息、商品列表和配置数据。它通常不会改变服务器状态。
如果操作需要提交业务数据或产生状态变化,应根据接口设计选择其他 HTTP 方法,而不是继续使用 GET 传递复杂参数。
按自己的节奏,确认真正理解。