本文转载自知乎:Spring Boot 2.7新特性:@JsonMixin - 蓬莱山辉夜的文章 - 知乎
引言
在我们普通的应用中,如果我们要定制一个类对象的Json输出的话,我们可以轻松的通过Jackson提供的注解如:“@JsonProperties”等注解在类上轻松实现对Json输出的定制。
但也存在着这样的Java类对象的源码不受控制的情况:
- 1、Java类在第三方的类库中,你无法修改;
- 2、不想修改已有的类的代码,因当前业务和已有业务在不同的模块中。
Jackson为我们mixin来解决这个问题,在不修改已有的Java类库的情况下,定制Json的输出。
Spring Boot 2.7为我们提供了“@JsonMixin”注解来快速注册mixin。
1、演示项目
打开https://start.spring.io,Spring Boot版本选择2.7.x依赖选择“Spring Web”和“Lombok”。
2、演示代码
需要定制输出的类:
import lombok.AllArgsConstructor;
import lombok.Data;
@Data
@AllArgsConstructor
public class Person {
private String name;
private Integer age;
}
演示用控制器:
@RestController
public class PersonController {
@GetMapping("/getDemoPerson")
Person getDemoPerson(){
return new Person("wiselyman",18);
}
}
运行访问:
http://localhost:8080/getDemoPerson
下面我们需要将“name”输出修改为“fullName”,我们先用最简单的常规实现,这意味着我们能直接修改“Person”类的源码。
2.1、可控时的实现
在可修改源码的情况下,定制输出是很简单的:
import com.fasterxml.jackson.annotation.JsonProperty;
@Data
@AllArgsConstructor
public class Person {
@JsonProperty("fullName")
private String name;
private Integer age;
}
运行访问:
http://localhost:8080/getDemoPerson
2.1、不可控时mixin的实现
我们通过定义一下个抽象类来实现mixin的功能,然后通过Spring Boot的“@JsonMixin”注解将这个抽象类注册到自动配置的“ObjectMapper”。
首先我们的“Person”类恢复原样。
@Data
@AllArgsConstructor
public class Person {
private String name;
private Integer age;
}
定义一个叫抽象类“FullNameMixin”,将“FullNameMixin”附加到目标类“Person”:
import com.fasterxml.jackson.annotation.JsonProperty;
import org.springframework.boot.jackson.JsonMixin;
@JsonMixin(Person.class) //1
public abstract class FullNameMixin {
@JsonProperty("fullName") //2
String name; //3
}
- 1、Spring Boot的Jackson自动配置将扫描应用程序的包以查找带有“@JsonMixin”注释的类,并将它们注册到自动配置的“ObjectMapper”。 注册动作由Spring Boot的“JsonMixinModule”执行。“Person.class”是被附加mixin的目标类。
- 2、被定制的新名称。
- 3、被定制的原属性。运行访问:http://localhost:8080/getDemoPerson
运行访问:
http://localhost:8080/getDemoPerson