Java中JSON序列化与反序列化的原理与实践方法

{
  "orderId": 12345,
  "orderCode": "xx.20260805.000001",
  "amount": 3999.00,
  "paid": true,
  "items": [
    {"skuId": 100, "name": "11", "qty": 1},
    {"skuId": 200, "name": "22", "qty": 2}
  ],
  "address": null
}

// ❌ 编译期泛型信息会被擦除
List<OrderDto> list = objectMapper.readValue(json, List.class);
// 实际得到的是 List<LinkedHashMap>，不是 List<OrderDto>！
// 因为运行时 JVM 不知道 List 里应该是什么类型

// ✅ TypeReference 保留了完整的泛型信息
List<OrderDto> list = objectMapper.readValue(json, 
    new TypeReference<List<OrderDto>>() {});
// 正确反序列化为 List<OrderDto>

// 嵌套泛型
RestControllerResult<List<OrderDto>> result = objectMapper.readValue(json,
    new TypeReference<RestControllerResult<List<OrderDto>>>() {});

/**
 * Spring MVC 自动处理 JSON 序列化/反序列化.
 * 无需手动调用 ObjectMapper.
 */
@RestController
public class OrderController {

    /**
     * 接收 JSON 请求体 → 自动反序列化为 Java 对象.
     * 返回 Java 对象 → 自动序列化为 JSON 响应.
     */
    @PostMapping("/api/order/create")
    public RestControllerResult<OrderDto> createOrder(@RequestBody CreateOrderDto dto) {
        // Spring 自动完成：
        // 1. 请求体 JSON → CreateOrderDto（反序列化）
        // 2. 返回值 RestControllerResult → JSON 响应体（序列化）
        OrderDto result = orderService.create(dto);
        return new RestControllerResult<>(result);
    }
}

// 前端发送：
// POST /api/order/create
// Content-Type: application/json
// {"orderCode":"SO.001","amount":3999.00,"items":[{"skuId":1,"qty":2}]}

// 后端返回：
// {"success":true,"code":0,"data":{"orderId":123,"orderCode":"SO.001",...}}

/**
 * 手动使用 ObjectMapper 的场景：
 * - 日志记录对象内容
 * - 调用第三方接口组装请求体
 * - Redis 缓存存取
 * - MQ 消息体
 */
public class JsonDemo {

    // 全局单例 ObjectMapper（线程安全，不要每次 new）
    private static final ObjectMapper objectMapper = new ObjectMapper()
        .configure(DeserializationFeature.FAIL_ON_UNKNOWN_PROPERTIES, false)  // 忽略未知字段
        .configure(SerializationFeature.WRITE_DATES_AS_TIMESTAMPS, true);     // 日期转时间戳

    /**
     * 对象 → JSON 字符串.
     */
    public static String toJson(Object obj) {
        try {
            return objectMapper.writeValueAsString(obj);
        } catch (JsonProcessingException e) {
            log.error("JSON序列化失败", e);
            return "";
        }
    }

    /**
     * JSON 字符串 → 对象.
     */
    public static <T> T fromJson(String json, Class<T> clazz) {
        try {
            return objectMapper.readValue(json, clazz);
        } catch (Exception e) {
            log.error("JSON反序列化失败", e);
            return null;
        }
    }

    /**
     * JSON 字符串 → 泛型对象（如 List<T>、Map<K,V>）.
     */
    public static <T> T fromJson(String json, TypeReference<T> typeRef) {
        try {
            return objectMapper.readValue(json, typeRef);
        } catch (Exception e) {
            log.error("JSON反序列化失败", e);
            return null;
        }
    }
}

/**
 * Fastjson 
 * 
 */
public class FastjsonDemo {

    // 序列化
    String json = JSON.toJSONString(orderDto);

    // 反序列化 - 简单类型
    OrderDto dto = JSON.parseObject(json, OrderDto.class);

    // 反序列化 - 泛型类型
    DuResultDto<List<QueryResultDto>> result = JSONObject.parseObject(
        responseStr,
        new TypeReference<DuResultDto<List<QueryResultDto>>>() {});

    // 获取 JSON 中某个字段
    JSONObject jsonObject = JSONObject.parseObject(responseStr);
    String success = jsonObject.getString("isSuccess");
    Integer code = jsonObject.getInteger("code");
}

@Data
public class DeliveryOrderDto {

    private Integer id;

    // JSON key 与 Java 字段名不同
    @JsonProperty("delivery_code")
    private String deliveryCode;

    // 序列化时忽略（内部使用，不返回前端）
    @JsonIgnore
    private Date achieveUserOrderCutDate;

    // 日期格式化
    @JsonFormat(pattern = "yyyy-MM-dd HH:mm:ss", timezone = "GMT+8")
    private Date createTime;

    // null 值不序列化到 JSON 中
    @JsonInclude(JsonInclude.Include.NON_NULL)
    private String remark;

    // 反序列化时接受多个字段名（兼容不同上游系统）
    @JsonAlias({"shuttleBus", "shuttle_bus", "busSchedule"})
    private List<String> shuttleBus;
}

// 序列化结果：
// {"id":1,"delivery_code":"SO.001","createTime":"2026-08-05 10:00:00","shuttleBus":["1","3","5"]}
// 注意：achieveUserOrderCutDate 被忽略，remark 为 null 时不输出

/**
 * 对接第三方系统时，对方用下划线命名，我方用驼峰.
 */

// 方式1：全局配置 ObjectMapper
ObjectMapper snakeMapper = new ObjectMapper()
    .setPropertyNamingStrategy(PropertyNamingStrategies.SNAKE_CASE);

// Java 对象 {"orderCode":"SO.001"} → JSON {"order_code":"SO.001"}
String json = snakeMapper.writeValueAsString(dto);

// 方式2：类级别注解
@JsonNaming(PropertyNamingStrategies.SnakeCaseStrategy.class)
public class ThirdPartyResponseDto {
    private String orderCode;       // JSON 中对应 "order_code"
    private Integer deliveryWay;    // JSON 中对应 "delivery_way"
}