如何使用Gson安全地读取空或不存在的JSON文件

import com.google.gson.Gson;
import com.google.gson.JsonSyntaxException;
import com.google.gson.stream.JsonReader;

import java.io.File;
import java.io.FileNotFoundException;
import java.io.FileReader;
import java.io.IOException;
import java.util.ArrayList;
import java.util.Arrays;
import java.util.List;

// 假设Aventura是您的数据模型类
class Aventura {
    String name;
    int level;

    // 构造函数、getter/setter等
    public Aventura(String name, int level) {
        this.name = name;
        this.level = level;
    }

    @Override
    public String toString() {
        return "Aventura{" +
               "name='" + name + '\'' +
               ", level=" + level +
               '}';
    }
}

public class JsonFileReader {

    private static final String FILE_PATH = "Files/adventures.json";

    /**
     * 从JSON文件读取Aventura列表。
     * 如果文件不存在、为空或包含无效JSON，则返回一个空的ArrayList。
     *
     * @return 包含Aventura对象的ArrayList，或在出错时返回空列表。
     */
    public ArrayList<Aventura> readFile() {
        File file = new File(FILE_PATH);
        ArrayList<Aventura> aventures = new ArrayList<>();

        // 步骤1: 检查文件是否存在或是否物理为空
        if (!file.exists()) {
            System.out.println("文件不存在: " + FILE_PATH + "。返回空列表。");
            return aventures;
        }

        if (file.length() == 0) {
            System.out.println("文件为空: " + FILE_PATH + "。返回空列表。");
            return aventures;
        }

        // 步骤2: 使用try-with-resources确保资源自动关闭，并捕获可能的异常
        try (FileReader fileReader = new FileReader(file);
             JsonReader jsonReader = new new JsonReader(fileReader)) {

            Gson g = new Gson();
            Aventura[] aveArray = g.fromJson(jsonReader, Aventura[].class);

            // 步骤3: 检查Gson解析结果是否为null
            if (aveArray != null) {
                aventures.addAll(Arrays.asList(aveArray));
            } else {
                System.out.println("JSON内容解析为null，可能文件包含非数组JSON。返回空列表。");
            }

        } catch (FileNotFoundException e) {
            // 理论上，由于我们已经检查了file.exists()，这里不应该发生，
            // 但为了健壮性，仍然捕获以防竞态条件或权限问题。
            System.err.println("错误：文件未找到，尽管之前已检查。 " + e.getMessage());
        } catch (JsonSyntaxException e) {
            // 捕获JSON格式错误
            System.err.println("错误：JSON文件语法错误。 " + e.getMessage());
            // e.printStackTrace(); // 调试时可开启
        } catch (IOException e) {
            // 捕获其他I/O错误
            System.err.println("错误：读取文件时发生I/O异常。 " + e.getMessage());
            // e.printStackTrace(); // 调试时可开启
        }
        return aventures;
    }

    public static void main(String[] args) {
        // 示例用法
        JsonFileReader reader = new JsonFileReader();

        // 确保Files目录存在
        File dir = new File("Files");
        if (!dir.exists()) {
            dir.mkdirs();
        }

        // 1. 测试空文件或不存在的文件
        System.out.println("--- 测试空文件或不存在的文件 ---");
        List<Aventura> emptyAventures = reader.readFile();
        System.out.println("读取到Aventura数量: " + emptyAventures.size()); // 应该为0

        // 2. 创建一个包含有效JSON的示例文件
        System.out.println("\n--- 测试有效JSON文件 ---");
        try {
            java.nio.file.Files.write(java.nio.file.Paths.get(FILE_PATH), 
                "[{\"name\":\"Quest for Gold\",\"level\":1},{\"name\":\"Dragon's Lair\",\"level\":5}]".getBytes());
        } catch (IOException e) {
            e.printStackTrace();
        }
        List<Aventura> validAventures = reader.readFile();
        System.out.println("读取到Aventura数量: " + validAventures.size()); // 应该为2
        validAventures.forEach(System.out::println);

        // 3. 创建一个包含空JSON数组的示例文件
        System.out.println("\n--- 测试空JSON数组文件 ---");
        try {
            java.nio.file.Files.write(java.nio.file.Paths.get(FILE_PATH), "[]".getBytes());
        } catch (IOException e) {
            e.printStackTrace();
        }
        List<Aventura> emptyJsonArrayAventures = reader.readFile();
        System.out.println("读取到Aventura数量: " + emptyJsonArrayAventures.size()); // 应该为0

        // 4. 创建一个包含无效JSON的示例文件
        System.out.println("\n--- 测试无效JSON文件 ---");
        try {
            java.nio.file.Files.write(java.nio.file.Paths.get(FILE_PATH), "{invalid json}".getBytes());
        } catch (IOException e) {
            e.printStackTrace();
        }
        List<Aventura> invalidJsonAventures = reader.readFile();
        System.out.println("读取到Aventura数量: " + invalidJsonAventures.size()); // 应该为0
    }
}