Java与Gson：优雅处理初始为空的JSON文件

import java.io.File;
import java.io.FileReader;
import java.io.IOException;
import java.lang.reflect.Type;
import java.util.ArrayList;
import java.util.Arrays;
import java.util.List;

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

// 假设Aventura是您的数据模型类
class Aventura {
    private String name;
    // ... 其他属性和getter/setter
    public Aventura(String name) {
        this.name = name;
    }
    public String getName() {
        return name;
    }
    @Override
    public String toString() {
        return "Aventura{" +
               "name='" + name + '\'' +
               '}';
    }
}

public class AventuraDAO {

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

    public List<Aventura> readFile() {
        File jsonFile = new File(FILE_PATH);
        List<Aventura> aventures = new ArrayList<>();

        // 步骤1: 检查文件是否存在或是否为空
        if (!jsonFile.exists() || jsonFile.length() == 0) {
            System.out.println("JSON文件不存在或为空，返回一个空列表。");
            // 最佳实践：始终返回一个空的集合，而不是null
            return aventures;
        }

        // 步骤2: 尝试读取和解析JSON
        try (FileReader fileReader = new FileReader(jsonFile);
             JsonReader reader = new JsonReader(fileReader)) {

            Gson g = new Gson();
            // 使用TypeToken来处理泛型类型，更安全
            // Type listType = new TypeToken<ArrayList<Aventura>>(){}.getType();
            // aventures = g.fromJson(reader, listType);

            // 如果确定是数组，直接解析为数组也可以
            Aventura[] aveArray = g.fromJson(reader, Aventura[].class);

            // 步骤3: 检查解析结果是否为null，并添加到列表中
            if (aveArray != null) {
                aventures.addAll(Arrays.asList(aveArray));
            } else {
                System.out.println("Gson解析结果为null，可能文件内容不是一个有效的JSON数组或为空。");
            }

        } catch (java.io.FileNotFoundException e) {
            // 尽管前面检查了exists()，但仍可能在极少数并发情况下发生，或者路径问题
            System.err.println("文件未找到: " + e.getMessage());
        } catch (JsonSyntaxException e) {
            // 处理JSON格式错误
            System.err.println("JSON语法错误，文件可能损坏或格式不正确: " + e.getMessage());
            e.printStackTrace();
        } catch (IOException e) {
            System.err.println("读取文件时发生IO错误: " + e.getMessage());
            e.printStackTrace();
        }
        return aventures;
    }

    public static void main(String[] args) {
        AventuraDAO dao = new AventuraDAO();

        // 1. 测试空文件或不存在的文件
        // 确保 Files/adventures.json 不存在或为空
        System.out.println("--- 测试空文件或不存在的情况 ---");
        List<Aventura> emptyAdventures = dao.readFile();
        System.out.println("读取到的冒险列表 (空/不存在文件): " + emptyAdventures);
        System.out.println("列表大小: " + emptyAdventures.size());

        // 2. 创建一个包含空JSON数组的文件
        System.out.println("\n--- 测试包含空JSON数组的文件 ---");
        try {
            Gson gson = new Gson();
            java.nio.file.Files.write(java.nio.file.Paths.get(FILE_PATH), gson.toJson(new Aventura[0]).getBytes());
        } catch (IOException e) {
            e.printStackTrace();
        }
        List<Aventura> emptyJsonArrayAdventures = dao.readFile();
        System.out.println("读取到的冒险列表 (空JSON数组文件): " + emptyJsonArrayAdventures);
        System.out.println("列表大小: " + emptyJsonArrayAdventures.size());

        // 3. 创建一个包含数据的JSON文件
        System.out.println("\n--- 测试包含数据的JSON文件 ---");
        try {
            Gson gson = new Gson();
            List<Aventura> data = new ArrayList<>();
            data.add(new Aventura("失落的神庙"));
            data.add(new Aventura("黑暗森林的秘密"));
            java.nio.file.Files.write(java.nio.file.Paths.get(FILE_PATH), gson.toJson(data).getBytes());
        } catch (IOException e) {
            e.printStackTrace();
        }
        List<Aventura> populatedAdventures = dao.readFile();
        System.out.println("读取到的冒险列表 (包含数据文件): " + populatedAdventures);
        System.out.println("列表大小: " + populatedAdventures.size());
    }
}