跨平台开发 / 系统课时
发送 POST 请求提交数据
发送 POST 请求提交数据
本篇将完成 Flutter 应用向服务器提交数据的流程,学习如何设置请求头、构造 JSON 请求体,并根据接口响应判断提交结果。
学习目标
- 理解 POST 请求与 GET 请求的数据传递区别
- 使用 Flutter 发送带 JSON 请求体的 POST 请求
- 掌握请求头、响应状态和异常处理方法
构造 POST 请求数据
POST 请求主要用于向服务器提交数据,例如创建用户、提交订单或发送表单。与 GET 将参数放在 URL 中不同,POST 通常把数据放在请求体中。
Flutter 使用 http.post 方法发送 POST 请求,可以通过 headers 指定内容类型,通过 body 传递 JSON 字符串。
dart
import 'dart:convert';
import 'package:http/http.dart' as http;
Future<void> createUser() async {
final uri = Uri.parse('https://api.example.com/users');
final response = await http.post(
uri,
headers: {
'Content-Type': 'application/json',
},
body: jsonEncode({
'name': 'Alice',
'age': 20,
}),
);
if (response.statusCode == 201) {
print('创建成功');
} else {
print('创建失败: ${response.statusCode}');
}
}预期输出
text
创建成功示例中的接口地址仅表示请求目标位置,实际项目中需要替换为后端提供的真实 API 地址。
设置请求头和请求体
服务器需要根据请求头判断如何解析数据。提交 JSON 时通常需要设置:
| 配置 | 作用 |
|---|---|
| Content-Type | 告诉服务器请求体格式 |
| Authorization | 携带身份认证信息 |
| Accept | 声明期望返回的数据格式 |
请求体中的 Dart Map 不能直接作为 HTTP 内容发送,需要使用 jsonEncode 转换为 JSON 字符串。
根据响应判断提交结果
POST 请求完成后,应根据 HTTP 状态码判断操作结果。
常见状态码包括:
| 状态码 | 含义 |
|---|---|
| 201 | 资源创建成功 |
| 400 | 请求参数错误 |
| 401 | 身份认证失败 |
| 500 | 服务端异常 |
业务代码中不要只判断成功或失败,还需要根据不同错误类型给用户提供对应反馈。
处理提交失败情况
网络提交可能因为断网、超时或服务器异常失败。实际应用通常需要捕获异常,并避免因为请求失败导致页面状态异常。
dart
Future<void> submitData() async {
try {
final response = await http.post(
Uri.parse('https://api.example.com/form'),
body: {'value': 'test'},
);
print(response.statusCode);
} catch (error) {
print('网络请求异常: $error');
}
}预期输出
text
请求成功时打印 HTTP 状态码,例如 200
请求异常时打印网络错误信息POST 请求的安全注意事项
POST 可以提交更多数据,但并不代表数据天然安全。敏感信息仍需要通过 HTTPS 传输,并结合身份认证、权限校验和服务端验证。
客户端负责组织请求和展示结果,真正的数据校验必须由服务器完成。
按自己的节奏,确认真正理解。