JSON序列化和反序列化

Mixin对于前端开发者可不陌生，Vue、React 等知名前端框架都使用了Mixin。而对于后端开发，尤其是 Java 后端开发来说Mixin却是一个很陌生的概念。今天来我们通过 Jackson 让后端开发者也来认识一下Mixin。

场景

比如我们引用了一个 Jar 包，其中的某个类在某个场景需要反序列化，但是这个类没有提供默认构造。咋办呢？把原来的项目拉下来，重写一下？下下策! 你可以使用 Jackson 提供的Mixin特性来解决这个问题。

Jackson 中的 Mixin

Jackson 中的Mixin（混入）我们可以这样解读它：将目标对象无法实现的序列化或反序列化功能通过一个混入对象进行配置，在序列化或反序列化的时候把这些个性化配置混入到目标对象中。混入不改变目标对象本身的任何特性，混入对象和目标对象是映射的关系。接下来我们来实现一个混入的 DEMO。

Mixin 的实现

我们有一个User类，为了演示需要，我们极端一些，实际开发中不太会出现这种极端情况。这个User没有无参构造，也没有属性的getter方法。

public class User {
    private final String name;
    private final Integer age;

    public User(String name, Integer age) {
        this.name = name;
        this.age = age;
    }
    @Override
    public String toString() {
        return "User{" +
                "name='" + name + '\'' +
                ", age=" + age +
                '}';
    }
}

编写 Mixin 类

我想对这个极端的User进行序列化和反序列化。按以前的玩法我们在User类上加上@JsonAutoDetect注解就可以实现序列化了；加上@JsonDeserialize注解并指定反序列化类就可以反序列化了。不过今天我们不需要对User进行任何更改，只需要编写一个Mixin类把上述两个注解配置好就可以了。

@JsonAutoDetect(fieldVisibility = JsonAutoDetect.Visibility.ANY, getterVisibility = JsonAutoDetect.Visibility.NONE,
        isGetterVisibility = JsonAutoDetect.Visibility.NONE)
@JsonIgnoreProperties(ignoreUnknown = true)
@JsonDeserialize(using = UserMixin.UserDeserializer.class)
public abstract class UserMixin {

    /**
     * 反序列化类
     **/
    static class UserDeserializer extends JsonDeserializer<User> {

        @Override
        public User deserialize(JsonParser p, DeserializationContext ctxt) throws IOException {
            ObjectMapper mapper = (ObjectMapper) p.getCodec();
            JsonNode jsonNode = mapper.readTree(p);

            String name = readJsonNode(jsonNode, "name").asText(null);
            String age = readJsonNode(jsonNode, "age").asText(null);
            Integer ageVal = Objects.isNull(age)? null: Integer.valueOf(age);
            return new User(name,ageVal);
        }

        private JsonNode readJsonNode(JsonNode jsonNode, String field) {
            return jsonNode.has(field) ? jsonNode.get(field) : MissingNode.getInstance();
        }
    }

}

Mixin 映射目标类

编写完Mixin类后，我们通过ObjectMapper中的addMixIn方法把UserMixin和User映射起来。并编写一个序列化和反序列化的例子。

ObjectMapper objectMapper = new ObjectMapper();
objectMapper.addMixIn(User.class, UserMixin.class);

User felord = new User("felord", 12);
String json = objectMapper.writeValueAsString(felord);
//{"name":"felord","age":12} 
System.out.println("json = " + json);

String jsonStr = "{\"name\":\"felord\",\"age\":12}";

User user = objectMapper.readValue(jsonStr, User.class);
// User{name='felord', age=12}
System.out.println("user = " + user);

这样我们在不对目标类进行任何改变的情况下实现了个性化的 JSON 序列化和反序列化。

Jackson 中的 Module

Jackson 还提供了模块化功能，可以将个性化配置进行模块化统一管理，而且可以按需引用，甚至可插拔。它同样能够管理一组Mixin。声明一个Jackson Module非常简单，继承SimpleModule覆写它的一些方法即可。针对Mixin我们可以这样写：

public class UserModule extends SimpleModule {
   public UserModule() {
       super(UserModule.class.getName());
   }

   @Override
   public void setupModule(SetupContext context) {
        context.setMixInAnnotations(User.class,UserMixin.class);
   }
}

Module同样可以注册到ObjectMapper中，同样也能实现我们想要的效果：

ObjectMapper objectMapper = new ObjectMapper();
objectMapper.registerModule(new UserModule());
// 省略

Module的功能更加强大。平常我们会使用以下几个Module:

• jackson-module-parameter-names  此模块能够访问构造函数和方法参数的名称；
• jackson-datatype-jdk8 除了 Java8 的时间 API 外其它新特性的的支持；
• jackson-datatype-jsr310  用以支持 Java8 新增的JSR310时间 API。

另外Spring Security也提供了Module支持SecurityJackson2Modules，它包含了下面的一些模块：

ObjectMapper mapper = new ObjectMapper();
mapper.enableDefaultTyping(ObjectMapper.DefaultTyping.NON_FINAL, JsonTypeInfo.As.PROPERTY);
mapper.registerModule(new CoreJackson2Module());
mapper.registerModule(new CasJackson2Module());
mapper.registerModule(new WebJackson2Module());
mapper.registerModule(new WebServletJackson2Module());
mapper.registerModule(new WebServerJackson2Module());
mapper.registerModule(new OAuth2ClientJackson2Module());

建议看一下SecurityJackson2Modules源码，研究并模仿一下 Module 的使用。