在我们普通的应用中,如果我们要定制一个类对象的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”。
演示代码
需要定制输出的类:
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”类的源码。
可控时的实现
在可修改源码的情况下,定制输出是很简单的:
import com.fasterxml.jackson.annotation.JsonProperty; @Data @AllArgsConstructor public class Person { @JsonProperty("fullName") private String name; private Integer age; }
运行访问:
http://localhost:8080/getDemoPerson
@Data @AllArgsConstructor public class Person { private String name; private Integer age; }
不可控时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
文章评论