在我们普通的应用中,如果我们要定制一个类对象的Json输出的话,我们可以轻松的通过Jackson提供的注解如:@JsonProperties
等注解在类上轻松实现对Json输出的定制。
但也存在着这样的Java类对象的源码不受控制的情况:
1、Java类在第三方的类库中,你无法修改;
2、不想修改已有的类的代码,因当前业务和已有业务在不同的模块中。
Jackson为我们mixin来解决这个问题,在不修改已有的Java类库的情况下,定制Json的输出。Spring Boot 2.7为我们提供了@JsonMixin
注解来快速注册mixin。
1、演示项目
打开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);
}
}
运行访问: localhost:8080/getDemoPerson
下面我们需要将“name”输出修改为“fullName”,我们先用最简单的常规实现,这意味着我们能直接修改“Person”类的源码。
3、可控时的实现
在可修改源码的情况下,定制输出是很简单的:
import com.fasterxml.jackson.annotation.JsonProperty;
@Data
@AllArgsConstructor
public class Person {
@JsonProperty("fullName")
private String name;
private Integer age;
}
运行访问: localhost:8080/getDemoPerson
4、不可控时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
}
- Spring Boot的Jackson自动配置将扫描应用程序的包以查找带有“@JsonMixin”注释的类,并将它们注册到自动配置的“ObjectMapper”。 注册动作由Spring Boot的“JsonMixinModule”执行。“Person.class”是被附加mixin的目标类。
- 被定制的新名称。
- 被定制的原属性。