Java中安全读取与管理初始为空的JSON文件

// ...
Gson g = new Gson();
JsonReader reader = new new JsonReader(new FileReader("Files/adventures.json"));
Aventura[] ave = g.fromJson(reader, Aventura[].class ); // 问题可能发生在这里

if (ave.length==0){ // 如果ave是null，这里会抛出NullPointerException
    System.out.println("The file should be empty");
    ArrayList<Aventura> aventures2 =null; // 不推荐返回null
    return aventures2;
}
// ...

import java.io.File;
import java.io.FileReader;
import java.io.FileWriter;
import java.io.IOException;
import java.util.ArrayList;
import java.util.Arrays; // 用于Arrays.asList
import com.google.gson.Gson;
import com.google.gson.GsonBuilder;
import com.google.gson.stream.JsonReader;

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

    public Aventura(String name, int level) {
        this.name = name;
        this.level = level;
    }

    // Getters and Setters
    public String getName() { return name; }
    public void setName(String name) { this.name = name; }
    public int getLevel() { return level; }
    public void setLevel(int level) { this.level = level; }

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

public class AventuraDAO {
    private static final String FILE_PATH = "Files/adventures.json";
    private final Gson gson = new GsonBuilder().setPrettyPrinting().create(); // 格式化输出，方便阅读

    /**
     * 读取JSON文件中的Aventura列表。
     * 如果文件不存在或为空，则返回一个空的ArrayList。
     * @return 存储Aventura对象的ArrayList，永不返回null。
     */
    public ArrayList<Aventura> readFile() {
        File file = new File(FILE_PATH);

        // 1. 检查文件是否存在或是否物理为空
        if (!file.exists() || file.length() == 0) {
            System.out.println("文件不存在或物理为空，返回空列表。");
            // 最佳实践：总是返回一个空的集合，而不是null
            return new ArrayList<>();
        }

        ArrayList<Aventura> aventures = new ArrayList<>();
        try (FileReader fileReader = new FileReader(file);
             JsonReader reader = new JsonReader(fileReader)) { // 使用try-with-resources确保资源关闭

            Aventura[] aveArray = gson.fromJson(reader, Aventura[].class);

            // 2. 处理文件内容是 "[]" 的情况，或正常读取到的数组
            if (aveArray != null) { // 如果文件内容是"[]"，aveArray将是一个长度为0的数组，而不是null
                aventures.addAll(Arrays.asList(aveArray));
            }
        } catch (IOException e) {
            System.err.println("读取文件时发生IO错误: " + e.getMessage());
            e.printStackTrace();
            return new ArrayList<>(); // 发生错误时也返回空列表
        }
        return aventures;
    }

    /**
     * 将Aventura列表写入JSON文件。
     * @param aventures 要写入的Aventura列表。
     */
    public void writeFile(ArrayList<Aventura> aventures) {
        File file = new File(FILE_PATH);
        // 确保父目录存在
        File parentDir = file.getParentFile();
        if (parentDir != null && !parentDir.exists()) {
            parentDir.mkdirs(); // 创建所有必要的父目录
        }

        try (FileWriter writer = new FileWriter(file)) {
            gson.toJson(aventures, writer);
            System.out.println("数据已成功写入文件：" + FILE_PATH);
        } catch (IOException e) {
            System.err.println("写入文件时发生IO错误: " + e.getMessage());
            e.printStackTrace();
        }
    }

    /**
     * 示例主方法，展示如何使用AventuraDAO。
     */
    public static void main(String[] args) {
        AventuraDAO dao = new AventuraDAO();

        // 1. 尝试读取一个可能为空或不存在的文件
        System.out.println("--- 首次读取 ---");
        ArrayList<Aventura> initialAventures = dao.readFile();
        System.out.println("读取到的Aventura数量: " + initialAventures.size());
        initialAventures.forEach(System.out::println);

        // 2. 添加一些数据并写入文件
        System.out.println("\n--- 写入数据 ---");
        initialAventures.add(new Aventura("森林探险", 1));
        initialAventures.add(new Aventura("洞穴寻宝", 2));
        dao.writeFile(initialAventures);

        // 3. 再次读取，此时文件应该有内容了
        System.out.println("\n--- 再次读取 ---");
        ArrayList<Aventura> updatedAventures = dao.readFile();
        System.out.println("再次读取到的Aventura数量: " + updatedAventures.size());
        updatedAventures.forEach(System.out::println);

        // 4. 清空文件内容（模拟清空操作）
        System.out.println("\n--- 清空文件并写入空列表 ---");
        dao.writeFile(new ArrayList<>()); // 写入一个空的JSON数组 "[]"

        // 5. 再次读取，此时文件内容为 "[]"
        System.out.println("\n--- 读取清空后的文件 ---");
        ArrayList<Aventura> clearedAventures = dao.readFile();
        System.out.println("清空后读取到的Aventura数量: " + clearedAventures.size());
        clearedAventures.forEach(System.out::println);
    }
}

public class AventuraDAO {
    // ... (其他代码与上面相同)

    /**
     * 如果文件不存在或物理为空，则初始化写入一个空的JSON数组 "[]"。
     */
    public void initializeFileIfEmpty() {
        File file = new File(FILE_PATH);
        File parentDir = file.getParentFile();
        if (parentDir != null && !parentDir.exists()) {
            parentDir.mkdirs(); // 确保目录存在
        }

        if (!file.exists() || file.length() == 0) {
            System.out.println("文件不存在或物理为空，初始化写入空JSON数组 '[]'。");
            try (FileWriter writer = new FileWriter(file)) {
                writer.write("[]"); // 写入一个空的JSON数组
            } catch (IOException e) {
                System.err.println("初始化文件失败: " + e.getMessage());
                e.printStackTrace();
            }
        }
    }

    public static void main(String[] args) {
        AventuraDAO dao = new AventuraDAO();
        dao.initializeFileIfEmpty(); // 在任何读取或写入操作前调用此方法

        // ... (后续的读取和写入操作，与上面main方法类似)
    }
}