java如何打印json

Java中优雅地打印JSON：从手动构建到使用库的全面指南**

在Java开发中，JSON（JavaScript Object Notation）作为一种轻量级的数据交换格式，广泛应用于前后端数据交互、配置文件、API响应等场景，在调试、日志记录或数据展示时，我们经常需要将Java对象或JSON字符串以格式化、易读的方式打印出来，本文将详细介绍在Java中如何高效、优雅地打印JSON,涵盖从基础方法到使用专业库的多种实践。

为什么需要“打印”JSON？

直接打印未经格式化的JSON字符串，往往是一行紧凑的文本,可读性很差。

{"name":"张三","age":30,"isStudent":false,"courses":["数学","英语"]}

而格式化后的JSON是这样的：

{
  "name": "张三",
  "age": 30,
  "isStudent": false,
  "courses": [
    "数学",
    "英语"
  ]
}

格式化打印能让我们更清晰地查看数据结构,便于调试和排查问题。

手动构建与打印（不推荐，仅作理解）

对于非常简单的JSON结构，理论上可以手动拼接字符串来打印，但这种方法极易出错，难以维护，且无法处理复杂嵌套和特殊字符，实际开发中强烈不推荐。

public class ManualJsonPrint {
    public static void main(String[] args) {
        String name = "张三";
        int age = 30;
        boolean isStudent = false;
        String[] courses = {"数学", "英语"};
        String jsonString = String.format(
            "{\"name\":\"%s\",\"age\":%d,\"isStudent\":%b,\"courses\":[\"%s\",\"%s\"]}",
            name, age, isStudent, courses[0], courses[1]
        );
        System.out.println(jsonString);
    }
}

输出：

{"name":"张三","age":30,"isStudent":false,"courses":["数学","英语"]}

可以看到，这种方式不仅代码冗长，而且对于转义字符、复杂嵌套等情况处理起来非常棘手。

使用Java标准库（`javax.json`）

Java EE 7及更高版本提供了javax.json包（也称为JSON-P），用于处理JSON数据，虽然它主要用于解析和生成JSON,但也可以用来格式化打印。

步骤：

添加依赖（如果使用Maven，pom.xml中）：

<dependency>
    <groupId>javax.json</groupId>
    <artifactId>javax.json-api</artifactId>
    <version>1.1.4</version>
</dependency>
<dependency>
    <groupId>org.glassfish</groupId>
    <artifactId>javax.json</artifactId>
    <version>1.1.4</version>
</dependency>

代码示例：

import javax.json.Json;
import javax.json.JsonObject;
import javax.json.JsonWriter;
import java.io.StringWriter;
public class JsonpPrint {
    public static void main(String[] args) {
        JsonObject jsonObject = Json.createObjectBuilder()
                .add("name", "张三")
                .add("age", 30)
                .add("isStudent", false)
                .add("courses", Json.createArrayBuilder()
                        .add("数学")
                        .add("英语")
                        .build())
                .build();
        StringWriter stringWriter = new StringWriter();
        try (JsonWriter jsonWriter = Json.createWriter(stringWriter)) {
            jsonWriter.write(jsonObject);
        }
        String jsonString = stringWriter.toString();
        System.out.println("未格式化JSON-P: " + jsonString);
        // 如果需要格式化，JsonWriter本身不直接提供，可以结合其他方式或使用更高级的库
        // 这里简单演示一个手动换行（不完美，仅示意）
        String formattedJson = jsonString.replace(",", ",\n");
        System.out.println("简单格式化JSON-P:\n" + formattedJson);
    }
}

注意：标准的JsonWriter并不直接提供美观的缩进格式化，要实现格式化,可能需要额外的处理或使用其他库。

使用主流第三方库（推荐）

实际开发中，我们更倾向于使用功能强大、易用性高的第三方JSON库来处理JSON,包括格式化打印。

Jackson

Jackson是Java生态中最流行的JSON库之一,它提供了简洁的方式来格式化JSON。

添加依赖（Maven）：

<dependency>
    <groupId>com.fasterxml.jackson.core</groupId>
    <artifactId>jackson-databind</artifactId>
    <version>2.15.2</version> <!-- 使用最新稳定版本 -->
</dependency>

代码示例：

import com.fasterxml.jackson.core.JsonProcessingException;
import com.fasterxml.jackson.databind.ObjectMapper;
import java.util.Arrays;
import java.util.HashMap;
import java.util.Map;
public class JacksonPrint {
    public static void main(String[] args) {
        // 方式一：直接将Map/List转换为格式化JSON
        Map<String, Object> data = new HashMap<>();
        data.put("name", "张三");
        data.put("age", 30);
        data.put("isStudent", false);
        data.put("courses", Arrays.asList("数学", "英语"));
        ObjectMapper objectMapper = new ObjectMapper();
        try {
            // 启用美化输出
            String prettyJson = objectMapper.writerWithDefaultPrettyPrinter().writeValueAsString(data);
            System.out.println("Jackson格式化输出:");
            System.out.println(prettyJson);
        } catch (JsonProcessingException e) {
            e.printStackTrace();
        }
        // 方式二：将Java对象（POJO）转换为格式化JSON
        User user = new User("李四", 25, true, Arrays.asList("物理", "化学"));
        try {
            String prettyJsonUser = objectMapper.writerWithDefaultPrettyPrinter().writeValueAsString(user);
            System.out.println("\nJackson POJO格式化输出:");
            System.out.println(prettyJsonUser);
        } catch (JsonProcessingException e) {
            e.printStackTrace();
        }
    }
    static class User {
        private String name;
        private int age;
        private boolean isStudent;
        private java.util.List<String> courses;
        // 构造方法、getters和setters（省略，实际开发中需要）
        public User(String name, int age, boolean isStudent, java.util.List<String> courses) {
            this.name = name;
            this.age = age;
            this.isStudent = isStudent;
            this.courses = courses;
        }
        // 省略其他方法...
    }
}

输出：

Jackson格式化输出:
{
  "name" : "张三",
  "age" : 30,
  "isStudent" : false,
  "courses" : [ "数学", "英语" ]
}
Jackson POJO格式化输出:
{
  "name" : "李四",
  "age" : 25,
  "isStudent" : true,
  "courses" : [ "物理", "化学" ]
}

Jackson的writerWithDefaultPrettyPrinter()方法可以轻松实现美观的缩进格式化。

Gson

Google的Gson是另一个广泛使用的JSON库,同样支持JSON的格式化打印。

添加依赖（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.util.Arrays;
import java.util.HashMap;
import java.util.Map;
public class GsonPrint {
    public static void main(String[] args) {
        // 方式一：直接将Map/List转换为格式化JSON
        Map<String, Object> data = new HashMap<>();
        data.put("name", "张三");
        data.put("age", 30);
        data.put("isStudent", false);
        data.put("courses", Arrays.asList("数学", "英语"));
        Gson gson = new GsonBuilder().setPrettyPrinting().create();
        String prettyJson = gson.toJson(data);
        System.out.println("Gson格式化输出:");
        System.out.println(prettyJson);
        // 方式二：将Java对象（POJO）转换为格式化JSON
        User user = new User("李四", 25, true, Arrays.asList("物理", "化学"));
        String prettyJsonUser = gson.toJson(user);
        System.out.println("\nGson POJO格式化输出:");
        System.out.println(prettyJsonUser);
    }
    static class User {
        private String name;
        private int age;
        private boolean isStudent;
        private java.util.List<String> courses;
        public User(String name, int age, boolean isStudent, java.util.List<String> courses) {
            this.name = name;
            this.age = age;
            this.isStudent = isStudent;
            this.courses = courses;
        }
        // 省略其他方法...
    }
}

正文

java如何打印json

为什么需要“打印”JSON？

手动构建与打印（不推荐，仅作理解）

使用Java标准库（`javax.json`）

使用主流第三方库（推荐）

Jackson

Gson

相关阅读

ios怎么导入json书源

如何获取网站的json接口

怎么将一个数组转为json对象

下载转json怎么写

发表评论取消回复

还没有评论，来说两句吧...

目录[+]

为什么需要“打印”JSON？

手动构建与打印（不推荐，仅作理解）

使用Java标准库（javax.json）

使用主流第三方库（推荐）

Jackson

Gson

相关阅读

ios怎么导入json书源

如何获取网站的json接口

怎么将一个数组转为json对象

下载转json怎么写

发表评论取消回复

还没有评论，来说两句吧...

目录[+]

使用Java标准库（`javax.json`）