java怎么写入json文件

Java怎么写入JSON文件：全面指南与代码示例

在Java开发中,将数据写入JSON文件是一项常见任务，JSON（JavaScript Object Notation）因其轻量级、易读易写的特性，成为数据交换的主流格式，本文将详细介绍几种在Java中写入JSON文件的方法，包括使用原生Java、第三方库如Gson和Jackson等，并提供完整的代码示例。

使用原生Java写入JSON文件

虽然原生Java没有直接提供JSON操作的API,但可以通过拼接字符串或使用org.json库（需要额外引入）来实现。

1 使用org.json库

需要在项目中添加org.json依赖（Maven）：

<dependency>
    <groupId>org.json</groupId>
    <artifactId>json</artifactId>
    <version>20231013</version>
</dependency>

可以使用以下代码写入JSON文件：

import org.json.JSONObject;
import java.io.FileWriter;
import java.io.IOException;
public class JsonWriterExample {
    public static void main(String[] args) {
        // 创建JSON对象
        JSONObject jsonObject = new JSONObject();
        jsonObject.put("name", "张三");
        jsonObject.put("age", 30);
        jsonObject.put("isStudent", false);
        jsonObject.put("courses", new String[]{"数学", "英语", "物理"});
        // 写入文件
        try (FileWriter file = new FileWriter("person.json")) {
            file.write(jsonObject.toString());
            System.out.println("JSON文件已成功写入");
        } catch (IOException e) {
            e.printStackTrace();
        }
    }
}

2 手动拼接JSON字符串

对于简单的JSON结构,也可以手动拼接字符串：

import java.io.FileWriter;
import java.io.IOException;
public class ManualJsonWriter {
    public static void main(String[] args) {
        String jsonString = "{\"name\":\"李四\",\"age\":25,\"isStudent\":true}";
        try (FileWriter file = new FileWriter("person2.json")) {
            file.write(jsonString);
            System.out.println("JSON文件已成功写入");
        } catch (IOException e) {
            e.printStackTrace();
        }
    }
}

使用Gson库写入JSON文件

Gson是Google提供的用于处理JSON的Java库,使用简单且功能强大。

1 添加Gson依赖（Maven）

<dependency>
    <groupId>com.google.code.gson</groupId>
    <artifactId>gson</artifactId>
    <version>2.10.1</version>
</dependency>

2 使用Gson写入JSON文件

import com.google.gson.Gson;
import com.google.gson.GsonBuilder;
import java.io.FileWriter;
import java.io.IOException;
import java.util.Arrays;
import java.util.List;
public class GsonJsonWriter {
    public static void main(String[] args) {
        // 创建对象
        Person person = new Person("王五", 28, false, Arrays.asList("化学", "生物"));
        // 创建Gson实例
        Gson gson = new GsonBuilder().setPrettyPrinting().create();
        // 转换为JSON字符串
        String jsonString = gson.toJson(person);
        // 写入文件
        try (FileWriter writer = new FileWriter("person3.json")) {
            writer.write(jsonString);
            System.out.println("JSON文件已成功写入");
        } catch (IOException e) {
            e.printStackTrace();
        }
    }
    // 定义Person类
    static class Person {
        private String name;
        private int age;
        private boolean isStudent;
        private List<String> courses;
        public Person(String name, int age, boolean isStudent, List<String> courses) {
            this.name = name;
            this.age = age;
            this.isStudent = isStudent;
            this.courses = courses;
        }
        // getters和setters
    }
}

使用Jackson库写入JSON文件

Jackson是另一个流行的Java JSON处理库，功能强大且性能优秀。

1 添加Jackson依赖（Maven）

<dependency>
    <groupId>com.fasterxml.jackson.core</groupId>
    <artifactId>jackson-databind</artifactId>
    <version>2.15.2</version>
</dependency>

2 使用Jackson写入JSON文件

import com.fasterxml.jackson.databind.ObjectMapper;
import com.fasterxml.jackson.databind.SerializationFeature;
import java.io.File;
import java.io.IOException;
import java.util.Arrays;
import java.util.List;
public class JacksonJsonWriter {
    public static void main(String[] args) {
        // 创建对象
        Person person = new Person("赵六", 35, true, Arrays.asList("历史", "地理"));
        // 创建ObjectMapper实例
        ObjectMapper mapper = new ObjectMapper();
        mapper.enable(SerializationFeature.INDENT_OUTPUT); // 美化输出
        try {
            // 写入文件
            mapper.writeValue(new File("person4.json"), person);
            System.out.println("JSON文件已成功写入");
        } catch (IOException e) {
            e.printStackTrace();
        }
    }
    // 定义Person类
    static class Person {
        private String name;
        private int age;
        private boolean isStudent;
        private List<String> courses;
        public Person(String name, int age, boolean isStudent, List<String> courses) {
            this.name = name;
            this.age = age;
            this.isStudent = isStudent;
            this.courses = courses;
        }
        // getters和setters
    }
}

比较与选择

选择建议：

• 对于简单JSON操作,可以使用原生Java或org.json
• 对于大多数应用场景,Gson提供了良好的平衡
• 对于高性能需求或复杂JSON处理,Jackson是更好的选择

注意事项

1. 异常处理：文件操作可能抛出IOException，需要妥善处理
2. 资源释放：使用try-with-resources确保文件流正确关闭
3. 编码问题：指定UTF-8编码避免中文乱码：

   try (FileWriter file = new FileWriter("person.json", StandardCharsets.UTF_8)) {
       // 写入操作
   }

4. 安全性：处理用户输入时，注意防止JSON注入攻击

本文介绍了三种在Java中写入JSON文件的方法：使用原生Java/org.json、Gson和Jackson库，每种方法都有其优缺点，开发者可以根据项目需求选择合适的方案，对于大多数Java应用，推荐使用Gson或Jackson，它们提供了更简洁、更强大的JSON处理能力，能够显著提高开发效率。

通过这些方法,你可以轻松地在Java应用中将数据序列化为JSON格式并保存到文件中，为数据持久化和交换提供便利。