Java中安全高效地将JSON对象中的数组转换为List

<dependency>
    <groupId>org.json</groupId>
    <artifactId>json</artifactId>
    <version>20231013</version> <!-- 使用最新稳定版本 -->
</dependency>

implementation 'org.json:json:20231013' // 使用最新稳定版本

import org.json.JSONArray;
import org.json.JSONObject;
import java.util.ArrayList;
import java.util.List;

public class JsonArrayToListConverter {

    public static void main(String[] args) {
        // 待处理的JSON字符串
        String jsonString = "{\"data\":[\"str1\", \"str2\", \"str3\"]}";

        try {
            // 1. 将JSON字符串解析为JSONObject
            JSONObject jsonObject = new JSONObject(jsonString);

            // 2. 从JSONObject中获取JSONArray
            // 使用getJSONArray()方法，它会返回一个JSONArray实例
            JSONArray jsonArray = jsonObject.getJSONArray("data");

            // 3. 遍历JSONArray并将其元素添加到java.util.List中
            List<String> dataList = new ArrayList<>();
            for (int i = 0; i < jsonArray.length(); i++) {
                // 根据数组元素的实际类型调用JSONArray的相应get方法
                // 例如：getString(), getInt(), getBoolean(), getJSONObject() 等
                dataList.add(jsonArray.getString(i));
            }

            System.out.println("原始JSON字符串: " + jsonString);
            System.out.println("成功提取并转换的List: " + dataList);
            System.out.println("List的类型: " + dataList.getClass().getName());
            System.out.println("List的内容: " + dataList);

        } catch (Exception e) {
            System.err.println("解析JSON或转换过程中发生错误: " + e.getMessage());
            e.printStackTrace();
        }
    }
}

原始JSON字符串: {"data":["str1", "str2", "str3"]}
成功提取并转换的List: [str1, str2, str3]
List的类型: java.util.ArrayList
List的内容: [str1, str2, str3]

import org.json.JSONArray;
import org.json.JSONObject;
import java.util.ArrayList;
import java.util.List;

public class RobustJsonArrayToListConverter {

    public static void main(String[] args) {
        String jsonStringValid = "{\"data\":[\"str1\", \"str2\", \"str3\"]}";
        String jsonStringKeyMissing = "{\"otherKey\":\"value\"}";
        String jsonStringValueNotArray = "{\"data\":\"notAnArray\"}";

        System.out.println("--- 有效JSON示例 ---");
        processJson(jsonStringValid, "data");

        System.out.println("\n--- 键缺失示例 ---");
        processJson(jsonStringKeyMissing, "data");

        System.out.println("\n--- 值非数组示例 ---");
        processJson(jsonStringValueNotArray, "data");
    }

    private static void processJson(String jsonStr, String key) {
        System.out.println("处理JSON: " + jsonStr);
        try {
            JSONObject jsonObject = new JSONObject(jsonStr);
            // 使用optJSONArray()来避免键不存在或类型不匹配时的异常
            JSONArray jsonArray = jsonObject.optJSONArray(key);

            if (jsonArray != null) {
                List<String> dataList = new ArrayList<>();
                for (int i = 0; i < jsonArray.length(); i++) {
                    // 在获取元素时也应注意类型，并处理可能的ClassCastException
                    // 这里假设所有元素都是字符串
                    dataList.add(jsonArray.getString(i));
                }
                System.out.println("成功提取并转换的List: " + dataList);
            } else {
                System.out.println("键 '" + key + "' 不存在或其值不是一个JSON数组。");
            }
        } catch (Exception e) {
            System.err.println("处理JSON过程中发生意外错误: " + e.getMessage());
            // e.printStackTrace(); // 生产环境中可能只记录日志
        }
    }
}

// 伪代码，需要引入Jackson依赖
/*
import com.fasterxml.jackson.databind.ObjectMapper;
import com.fasterxml.jackson.core.type.TypeReference;
import java.util.List;

public class JacksonConverter {
    public static void main(String[] args) throws Exception {
        String jsonString = "{\"data\":[\"str1\", \"str2\", \"str3\"]}";
        ObjectMapper mapper = new ObjectMapper();

        // 解析整个JSON字符串
        // Map<String, List<String>> result = mapper.readValue(jsonString, new TypeReference<Map<String, List<String>>>() {});
        // List<String> dataList = result.get("data");

        // 或者，先获取JSONObject，再转换其内部的JSONArray
        JSONObject jsonObject = new JSONObject(jsonString); // 假设这里依然使用org.json的JSONObject
        String jsonArrayString = jsonObject.getJSONArray("data").toString(); // 将JSONArray转换为字符串

        List<String> dataList = mapper.readValue(jsonArrayString, new TypeReference<List<String>>() {});

        System.out.println("Jackson转换结果: " + dataList);
    }
}
*/