POJO 转 JSON

Jackson —— Spring 默认使用

Spring Boot ships Jackson by default. ObjectMapper is thread-safe — reuse a single instance.

import com.fasterxml.jackson.databind.ObjectMapper;

private static final ObjectMapper MAPPER = new ObjectMapper();

public static String toJson(Object pojo) throws JsonProcessingException {
    return MAPPER.writeValueAsString(pojo);
}

// Pretty-printed:
String pretty = MAPPER.writerWithDefaultPrettyPrinter().writeValueAsString(pojo);

Annotate fields with @JsonProperty("snake_case") when the JSON field name differs from the Java field. @JsonIgnore skips a field; @JsonInclude(NON_NULL) drops nulls.

Gson —— 依赖最小，对 Android 友好

import com.google.gson.Gson;
import com.google.gson.GsonBuilder;

private static final Gson GSON = new GsonBuilder()
    .serializeNulls()              // include null fields
    .setPrettyPrinting()           // optional
    .create();

public static String toJson(Object pojo) {
    return GSON.toJson(pojo);
}

Use @SerializedName("json_field") on a Java field to override the JSON key. Mark fields transient to skip them.

Moshi —— 优先支持 Kotlin，可选代码生成

import com.squareup.moshi.Moshi;
import com.squareup.moshi.JsonAdapter;

Moshi moshi = new Moshi.Builder().build();
JsonAdapter<User> adapter = moshi.adapter(User.class);

String json = adapter.toJson(user);
// Pretty:
String pretty = adapter.indent("  ").toJson(user);

POJO 转 JSON 与其他替代方案的对比

常见问题

什么是 POJO 转 JSON？

POJO 转 JSON 是指把一个 Java 实例——即包含字段、getter 和 setter 的 Plain Old Java Object——序列化为 JSON 字符串的过程。常用的标准库有 Jackson（`ObjectMapper.writeValueAsString(obj)`）、Gson（`new Gson().toJson(obj)`）和 Moshi（`moshi.adapter(MyType.class).toJson(obj)`）。每个库都会通过反射遍历对象的字段，应用相应注解（如果有的话，例如 `@JsonProperty`、`@SerializedName`），然后生成合法的 JSON。

功能特性

示例

class User { Integer id = 42; String name = "Ada"; boolean active = true; }  //  new ObjectMapper().writeValueAsString(user)

{"id":42,"name":"Ada","active":true}

常见使用场景

1. 1

   序列化 Spring Boot 响应

   使用 Jackson 示例在 REST 控制器中将 POJO 转换为 JSON。

2. 2

   重命名 JSON 键

   应用合适的注解，将驼峰命名的 Java 字段输出为蛇形命名（snake_case）的 JSON 键。

3. 3

   选择 JSON 库

   对比 Jackson、Gson 和 Moshi，为你的技术栈选出最合适的库。

参考资料

• Jackson Databind — FasterXML
• Gson 用户指南 — Google
• Moshi — Square
• RFC 8259 — JSON 数据交换格式 — IETF

相关工具