跨平台开发 / 系统课时
发送 HTTP GET 请求
发送 HTTP GET 请求
本篇将实现 Flutter 应用向服务器获取数据的完整流程,使用 HTTP 客户端发送 GET 请求,解析响应内容,并掌握异步请求中的常见处理方式。
学习目标
- 理解 Flutter 中发送 HTTP GET 请求的基本流程
- 使用 HTTP 客户端完成网络请求并解析 JSON 响应
- 掌握异步请求中的加载、成功和失败处理方式
使用 http 客户端发起 GET 请求
Flutter 本身不直接提供业务层 HTTP 请求封装,实际开发中通常使用 http 等客户端库完成网络通信。一个 GET 请求通常包含创建请求、等待响应、检查状态码和解析数据几个步骤。
在项目中添加依赖后,可以通过 http.get 方法发送请求。下面示例请求一个返回 JSON 数据的接口,并将响应解析为 Dart 对象。
dart
import 'dart:convert';
import 'package:flutter/material.dart';
import 'package:http/http.dart' as http;
void main() {
runApp(const MyApp());
}
class MyApp extends StatelessWidget {
const MyApp({super.key});
Future<void> loadUser() async {
final uri = Uri.parse('https://api.example.com/users/<ID>');
final response = await http.get(uri);
if (response.statusCode == 200) {
final data = jsonDecode(response.body);
print(data['name']);
} else {
throw Exception('请求失败: ${response.statusCode}');
}
}
@override
Widget build(BuildContext context) {
return MaterialApp(
home: Scaffold(
body: Center(
child: ElevatedButton(
onPressed: loadUser,
child: const Text('加载用户'),
),
),
),
);
}
}预期输出
text
控制台打印接口返回 JSON 中的 name 字段值示例中的 <ID> 表示实际资源编号,真实项目中应替换为接口要求的用户标识。
理解 Future 与异步响应
网络请求具有不可预测的耗时,不能阻塞 Flutter 主线程。因此 HTTP 方法返回 Future<Response>,调用方需要使用 await 等待结果。
常见页面状态通常包含三种情况:
| 状态 | 处理方式 |
|---|---|
| 请求中 | 显示加载组件 |
| 请求成功 | 更新页面数据 |
| 请求失败 | 展示错误信息 |
实际开发中通常不会直接在按钮事件里处理全部逻辑,而是放入状态管理层或独立的数据服务类中。
处理响应数据和异常
HTTP 响应主要关注两个部分:状态码和响应体。
200 通常表示请求成功,响应体中的 JSON 可以通过 jsonDecode 转换为 Dart 对象。对于网络异常、服务端错误或数据格式异常,需要提前设计错误处理逻辑。
GET 请求的使用边界
GET 适合读取资源,例如获取用户信息、商品列表、文章内容等。它的请求参数通常放在 URL 查询参数中,不适合提交大量敏感数据。
当接口需要提交数据、修改资源状态或携带复杂请求体时,应考虑使用 POST 或其他 HTTP 方法。
按自己的节奏,确认真正理解。