java如何创建json文件

Java如何创建JSON文件：从基础到实践的完整指南

在当今的软件开发中,JSON（JavaScript Object Notation）已成为数据交换的主流格式之一，Java作为企业级应用开发的首选语言，经常需要处理JSON数据的生成和存储，本文将详细介绍如何使用Java创建JSON文件，涵盖从基础API到第三方库的多种方法，帮助开发者根据实际需求选择最合适的解决方案。

使用Java原生API创建JSON文件

Java标准库本身不直接提供JSON处理的工具类,但我们可以通过字符串拼接的方式手动构建JSON数据并写入文件，这种方法虽然简单直接，但在处理复杂JSON结构时容易出错，不推荐在生产环境中使用。

import java.io.BufferedWriter;
import java.io.FileWriter;
import java.io.IOException;
public class NativeJsonCreator {
    public static void main(String[] args) {
        String jsonData = "{\n" +
                "  \"name\": \"张三\",\n" +
                "  \"age\": 30,\n" +
                "  \"isStudent\": false,\n" +
                "  \"courses\": [\"数学\", \"英语\", \"编程\"]\n" +
                "}";
        try (BufferedWriter writer = new BufferedWriter(new FileWriter("user.json"))) {
            writer.write(jsonData);
            System.out.println("JSON文件创建成功！");
        } catch (IOException e) {
            e.printStackTrace();
        }
    }
}

使用第三方库创建JSON文件

使用Gson库

Google开发的Gson库是Java中处理JSON的流行选择之一,它提供了简洁的API来将Java对象转换为JSON字符串。

首先添加Gson依赖（Maven）：

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

示例代码：

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 GsonJsonCreator {
    public static void main(String[] args) {
        // 创建Java对象
        User user = new User("李四", 25, false, Arrays.asList("物理", "化学"));
        // 创建Gson实例
        Gson gson = new GsonBuilder().setPrettyPrinting().create();
        // 转换为JSON字符串
        String json = gson.toJson(user);
        // 写入文件
        try (FileWriter writer = new FileWriter("user_gson.json")) {
            writer.write(json);
            System.out.println("使用Gson创建JSON文件成功！");
        } catch (IOException e) {
            e.printStackTrace();
        }
    }
    static class User {
        private String name;
        private int age;
        private boolean isStudent;
        private List<String> courses;
        // 构造方法、getter和setter省略...
    }
}

使用Jackson库

Jackson是另一个高性能的JSON处理库,广泛用于Spring框架中。

添加Jackson依赖（Maven）：

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

示例代码：

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 JacksonJsonCreator {
    public static void main(String[] args) {
        // 创建Java对象
        User user = new User("王五", 28, true, Arrays.asList("历史", "地理", "政治"));
        // 创建ObjectMapper实例
        ObjectMapper mapper = new ObjectMapper();
        mapper.enable(SerializationFeature.INDENT_OUTPUT);
        // 写入文件
        try {
            mapper.writeValue(new File("user_jackson.json"), user);
            System.out.println("使用Jackson创建JSON文件成功！");
        } catch (IOException e) {
            e.printStackTrace();
        }
    }
    static class User {
        private String name;
        private int age;
        private boolean isStudent;
        private List<String> courses;
        // 构造方法、getter和setter省略...
    }
}

使用org.json库

org.json是一个轻量级的JSON处理库，API简单易用。

添加依赖（Maven）：

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

示例代码：

import org.json.JSONArray;
import org.json.JSONObject;
import java.io.FileWriter;
import java.io.IOException;
public class OrgJsonCreator {
    public static void main(String[] args) {
        // 创建JSONObject
        JSONObject user = new JSONObject();
        user.put("name", "赵六");
        user.put("age", 35);
        user.put("isStudent", false);
        // 创建JSONArray
        JSONArray courses = new JSONArray();
        courses.put("文学");
        courses.put("艺术");
        user.put("courses", courses);
        // 写入文件
        try (FileWriter writer = new FileWriter("user_org.json")) {
            writer.write(user.toString(2)); // 2表示缩进2个空格
            System.out.println("使用org.json创建JSON文件成功！");
        } catch (IOException e) {
            e.printStackTrace();
        }
    }
}

创建复杂JSON结构

当需要创建嵌套的复杂JSON结构时,建议使用对象模型的方式，而不是手动拼接字符串，以下是一个使用Jackson创建复杂JSON的示例：

import com.fasterxml.jackson.databind.ObjectMapper;
import com.fasterxml.jackson.databind.SerializationFeature;
import com.fasterxml.jackson.databind.node.ArrayNode;
import com.fasterxml.jackson.databind.node.ObjectNode;
import java.io.File;
import java.io.IOException;
public class ComplexJsonCreator {
    public static void main(String[] args) {
        ObjectMapper mapper = new ObjectMapper();
        mapper.enable(SerializationFeature.INDENT_OUTPUT);
        // 创建根节点
        ObjectNode root = mapper.createObjectNode();
        root.put("projectName", "电商平台");
        root.put("version", "1.0.0");
        // 创建配置节点
        ObjectNode config = mapper.createObjectNode();
        config.put("debug", true);
        config.put("timeout", 5000);
        root.set("config", config);
        // 创建用户数组
        ArrayNode users = mapper.createArrayNode();
        ObjectNode user1 = mapper.createObjectNode();
        user1.put("id", 1);
        user1.put("name", "用户A");
        users.add(user1);
        ObjectNode user2 = mapper.createObjectNode();
        user2.put("id", 2);
        user2.put("name", "用户B");
        users.add(user2);
        root.set("users", users);
        // 写入文件
        try {
            mapper.writeValue(new File("complex.json"), root);
            System.out.println("复杂JSON文件创建成功！");
        } catch (IOException e) {
            e.printStackTrace();
        }
    }
}