Dart 如何将 JSON 转换为 x-www-form-urlencoded

在 Dart 中，我们可以使用 http 包来进行 HTTP 请求。有时候，我们需要将一个 JSON 对象转换为 x-www-form-urlencoded 格式的字符串，接着将其作为请求体发送给服务器。本文将介绍如何在 Dart 中实现这个操作。

什么是 x-www-form-urlencoded？

x-www-form-urlencoded 是一种编码方式，它将表单数据编码为键值对的形式，例如：

name=John+Doe&age=25

在 HTTP 请求中，x-www-form-urlencoded 数据通常被放在请求体中，而不是在 URL 中。

实现方法

我们可以使用 http 包提供的 Uri 类来编码 x-www-form-urlencoded 数据。具体过程如下：

1. 将 JSON 对象转换为 Map 形式。
2. 使用 Uri.encodeQueryComponent() 方法对 Map 中的每个键值对进行编码。
3. 将编码后的键值对按照 "&" 连接，最终生成 x-www-form-urlencoded 字符串。

下面是具体实现的代码片段：

import 'dart:convert';
import 'package:http/http.dart' as http;

Future<void> postData() async {
  // 原始的 JSON 数据
  final json = {
    'name': 'John Doe',
    'age': 25,
    'email': 'john.doe@example.com'
  };

  // 将 JSON 对象转换为 Map
  final formData = Map<String, String>.from(jsonDecode(jsonEncode(json)));

  // 对 Map 中的每个键值对进行编码
  final encodedFormData = formData.entries
      .map((e) => '${Uri.encodeQueryComponent(e.key)}='
          '${Uri.encodeQueryComponent(e.value)}')
      .join('&');

  // 发送请求
  final response = await http.post(
    Uri.parse('https://example.com/api'),
    headers: {'Content-Type': 'application/x-www-form-urlencoded'},
    body: encodedFormData,
  );

  // 处理响应
  if (response.statusCode == 200) {
    print(response.body);
  } else {
    throw Exception('Failed to post data: ${response.statusCode}');
  }
}

以上代码将 JSON 数据转换为 x-www-form-urlencoded 格式，并将其作为 POST 请求的请求体发送到示例 API 地址。如果请求成功，将会打印响应体。

总结

在 Dart 中，我们可以使用 Uri.encodeQueryComponent() 方法将 x-www-form-urlencoded 数据进行编码。通过将 JSON 对象转换为 Map 形式，我们也可以将 JSON 数据快速转换为 x-www-form-urlencoded 格式的字符串。