<think>我们已知：要将JSON字符串转换为application/x-www-form-urlencoded格式，即键值对形式，并且需要进行URL编码。 在Java中，我们可以使用以下步骤： 1. 将JSON字符串解析为JSONObject（使用org.json库）或Map（使用Jackson等库）。 2. 遍历JSON对象的每个键值对，对键和值分别进行URL编码（使用UTF-8字符集）。 3. 将编码后的键值对用等号连接，不同键值对之间用&连接。 注意：如果JSON数据中包含嵌套对象或数组，需要按照一定的规则进行扁平化（例如，将嵌套对象转换为带方括号的键，数组则重复键名等）。但标准的application/x-www-form-urlencoded并不直接支持嵌套结构，因此通常我们只处理简单的键值对，或者按照约定处理嵌套（如PHP风格的数组表示法）。 这里我们假设处理的是简单JSON（没有嵌套），因为嵌套结构在x-www-form-urlencoded中没有标准表示法，不同框架处理方式可能不同（如Spring MVC支持绑定嵌套对象，但要求参数名如`user.name`）。 我们使用org.json库（常用）来实现简单转换。 步骤： 1. 添加依赖（如果项目中没有）： ```xml <dependency> <groupId>org.json</groupId> <artifactId>json</artifactId> <version>20231013</version> </dependency> ``` 2. 编写转换方法： 如果JSON字符串是简单的键值对（无嵌套），我们可以这样转换： 示例JSON字符串：`{"name":"张三","age":25,"city":"北京"}` 期望转换结果：`name=%E5%BC%A0%E4%B8%89&age=25&city=%E5%8C%97%E4%BA%AC` 代码实现： </think> ### Java 实现 JSON 转 application/x-www-form-urlencoded 的方法 在 Java 中实现 JSON 到 `application/x-www-form-urlencoded` 的转换，主要有以下两种方法： #### 方法 1：使用标准 Java 库（推荐） ```java import org.json.JSONObject; import java.net.URLEncoder; import java.nio.charset.StandardCharsets; public class FormEncoder { /** * 将 JSON 字符串转换为 x-www-form-urlencoded 格式 * @param jsonStr 输入的 JSON 字符串 * @return URL 编码后的表单数据 */ public static String convertJsonToFormData(String jsonStr) { try { JSONObject json = new JSONObject(jsonStr); StringBuilder formData = new StringBuilder(); // 遍历 JSON 键值对 for (String key : json.keySet()) { if (!formData.isEmpty()) formData.append("&"); // 获取值并转换为字符串 Object value = json.get(key); String valueStr = value != null ? value.toString() : ""; // URL 编码键值对 formData.append(URLEncoder.encode(key, StandardCharsets.UTF_8)) .append("=") .append(URLEncoder.encode(valueStr, StandardCharsets.UTF_8)); } return formData.toString(); } catch (Exception e) { throw new RuntimeException("JSON 转换失败: " + e.getMessage(), e); } } } ``` #### 方法 2：使用第三方库（Gson） ```java import com.google.gson.JsonElement; import com.google.gson.JsonObject; import com.google.gson.JsonParser; import java.net.URLEncoder; import java.nio.charset.StandardCharsets; public class GsonFormEncoder { /** * 使用 Gson 处理复杂 JSON 结构 * @param jsonStr 输入的 JSON 字符串 * @return URL 编码后的表单数据 */ public static String convertWithGson(String jsonStr) { try { JsonObject json = JsonParser.parseString(jsonStr).getAsJsonObject(); StringBuilder formData = new StringBuilder(); // 遍历 JSON 条目 for (String key : json.keySet()) { if (!formData.isEmpty()) formData.append("&"); // 获取值并处理不同类型 JsonElement element = json.get(key); String value = element.isJsonNull() ? "" : element.isJsonPrimitive() ? element.getAsString() : element.toString(); // URL 编码 formData.append(URLEncoder.encode(key, StandardCharsets.UTF_8)) .append("=") .append(URLEncoder.encode(value, StandardCharsets.UTF_8)); } return formData.toString(); } catch (Exception e) { throw new RuntimeException("Gson 转换失败: " + e.getMessage(), e); } } } ``` ### 使用示例 ```java public class Main { public static void main(String[] args) { String json = "{\"name\":\"张三\",\"age\":25,\"city\":\"北京\",\"interests\":[\"读书\",\"运动\"]}"; // 方法1使用 String formData = FormEncoder.convertJsonToFormData(json); System.out.println("标准库转换结果: " + formData); // 输出: name=%E5%BC%A0%E4%B8%89&age=25&city=%E5%8C%97%E4%BA%AC&interests=%5B%22%E8%AF%BB%E4%B9%A6%22%2C%22%E8%BF%90%E5%8A%A8%22%5D // 方法2使用 String gsonFormData = GsonFormEncoder.convertWithGson(json); System.out.println("Gson 转换结果: " + gsonFormData); } } ``` ### 关键说明 1. **URL 编码处理** - 使用 `URLEncoder.encode(value, "UTF-8")` 确保特殊字符正确处理 - 中文 "张三" → `%E5%BC%A0%E4%B8%89` - 空格 → `%20` - 方括号 `[` → `%5B` 2. **数据类型处理** - 基本类型直接转换为字符串 - 数组/对象使用 `toString()` 转为字符串表示 - `null` 值转为空字符串 3. **嵌套对象处理** 对于复杂结构如 `{"user":{"name":"Tom"}}`，需要先扁平化处理： ```java // 扁平化处理 String flatJson = "{\"user.name\":\"Tom\"}"; ``` 4. **依赖管理** - 标准方法：需要 `org.json:json` 库 - Gson 方法：需要 `com.google.code.gson:gson` Maven 依赖： ```xml <dependency> <groupId>org.json</groupId> <artifactId>json</artifactId> <version>20231013</version> </dependency> <dependency> <groupId>com.google.code.gson</groupId> <artifactId>gson</artifactId> <version>2.10.1</version> </dependency> ``` ### 最佳实践建议 1. **内容类型设置** 发送请求时需添加 Header： ```java connection.setRequestProperty("Content-Type", "application/x-www-form-urlencoded"); ``` 2. **编码一致性** 始终使用 UTF-8 编码避免乱码： ```java URLEncoder.encode(value, StandardCharsets.UTF_8) ``` 3. **数组处理优化** 对数组值特殊处理（如重复键名）： ```java if (value instanceof JSONArray) { JSONArray arr = (JSONArray)value; for (int i = 0; i < arr.length(); i++) { // 添加 key=value1&key=value2 } } ``` > 选择建议：简单结构用标准库，复杂嵌套用 Gson 处理[^2]