Fastjson2 Mixin功能详解：如何通过注解注入定制序列化行为-优快云博客

本文链接：https://blog.youkuaiyun.com/gitblog_00021/article/details/148549657

Fastjson2 Mixin功能详解：如何通过注解注入定制序列化行为

fastjson2 阿里巴巴集团推出的第二代高性能JSON处理库，适用于Java和Android开发环境。它可以高效地将Java对象转换为JSON字符串，以及从JSON字符串反序列化为Java对象。特点包括速度快、体积小、兼容性好，并且提供了丰富的API以满足各种复杂场景下的数据序列化和反序列化需求。项目地址: https://gitcode.com/gh_mirrors/fa/fastjson2

什么是Fastjson2的Mixin功能

Fastjson2的Mixin功能是一种强大的序列化定制机制，它允许开发者在不修改原始类代码的情况下，通过外部配置的方式为类添加JSON序列化和反序列化的控制注解。这种设计特别适用于以下场景：

需要序列化第三方库中的类，但无法修改其源代码
需要对同一类在不同场景下使用不同的序列化策略
需要临时覆盖类的默认序列化行为

Mixin基础用法

基本配置步骤

让我们通过一个简单的例子来理解Mixin的基本用法：

定义目标类 - 这是我们需要序列化的类

public class Product {
    public String name;
}

创建Mixin类 - 这个类将包含我们想要"注入"的注解

public abstract class ProductMixin {
    @JSONField(name = "productName")
    String name;
}

注册Mixin - 将Mixin与目标类关联

JSON.mixIn(Product.class, ProductMixin.class);

使用效果 - 序列化时会使用Mixin中定义的注解

Product product = new Product();
product.name = "DataWorks";
String json = JSON.toJSONString(product); 
// 输出: {"productName":"DataWorks"}

技术原理

Mixin的实现原理是通过创建一个代理配置，当Fastjson2处理目标类时，会检查是否有注册的Mixin类，并将Mixin类中的注解应用到目标类上。这种机制类似于AOP中的切面编程，但专门针对JSON序列化场景。

高级用法：构造函数和值字段定制

对于更复杂的场景，比如没有默认构造函数的类，或者需要自定义序列化格式的类，Mixin也能很好地支持。

处理无默认构造函数的类

假设我们有一个Address类，它没有无参构造函数：

public class Address {
    private final String address;

    public Address(String address) {
        this.address = address;
    }

    public String getAddress() {
        return address;
    }
}

我们可以通过Mixin来指定构造函数和序列化方式：

abstract class AddressMixin {
    @JSONCreator
    public AddressMixin(@JSONField(value = true) String address) {}
    
    @JSONField(value = true)
    public String getAddress() { return null; }
}

使用方式：

JSON.mixIn(Address.class, AddressMixin.class);

Address address = new Address("HangZhou");
String json = JSON.toJSONString(address); 
// 输出: "HangZhou" (直接序列化为字符串)

Address parsed = JSON.parseObject(json, Address.class); 
// 从字符串反序列化回对象