1. 简介
在基于 RESTful 架构的 Web 应用开发里，后端服务与前端客户端之间的数据交互通常采用 JSON 格式。然而，不同的业务场景对数据的需求存在差异。例如，在用户列表展示场景中，仅需返回用户的基本信息，如用户名、头像等；而在用户详情查看场景中，则需要返回用户的全部信息，包括敏感信息如密码等。
为满足这种多样化的数据需求，传统方式可能需要创建多个数据传输对象（DTO），分别对应不同的数据展示场景，但这会导致代码冗余和维护成本增加。
@JsonView 它是 Jackson 库中的一个强大注解。通过定义不同的视图类（通常为接口或类），并在实体类的字段上使用 @JsonView 注解标记该字段在哪个视图中可见，同时在控制器方法中通过 @JsonView 注解指定返回的视图，就可以灵活控制返回的字段内容，实现了根据不同场景动态选择序列化字段的目的，大大提高了代码的简洁性和可维护性。
2. 实战案例
2.1 基本使用
实体类定义
public class User {
public interface PublicView {} ;
public interface InternalView extends PublicView {} ;
@JsonView(PublicView.class)
private Long id ;
@JsonView(PublicView.class)
private String name ;
@JsonView(PublicView.class)
private String address ;
@JsonView(InternalView.class)
private String password ;
@JsonView(InternalView.class)
private String idCard ;
@JsonView(PublicView.class)
private String email ;
// getters, setters
}
Controller接口
@RestController
@RequestMapping("/users")
public class UserController {
@JsonView(User.PublicView.class)
@GetMapping("/query")
public User query() {
return new User(1L, "pack", "四川乌鲁木齐市", "123456",
"152528202504096514", "pack@qq.com");
}
}
如果将接口上的@JsonView修改为InternalView：
所有的字段都输出了。
注意，如果你有字段没有添加@JsonView注解，那么将不会被输出（默认情况）。
2.2 编程方式
如果你想以编程方式实现上述功能（而不是声明一个 @JsonView 注解），可以将返回值用 MappingJacksonValue 对象包裹起来，并利用它来指定序列化视图：
@GetMapping("/getUser")
public MappingJacksonValue getUser() {
User user = new User(1L, "pack", "四川乌鲁木齐市", "123456",
"152528202504096514", "pack@qq.com") ;
MappingJacksonValue value = new MappingJacksonValue(user);
value.setSerializationView(User.PublicView.class);
return value;
}
2.3 视图Json
对于依赖视图的控制器，只需将序列化视图类添加到model中即可，如下例所示：
@Controller
public class UserViewController {
@GetMapping("/userview")
public ModelAndView userView(Model model) {
User user = new User(1L, "pack", "四川乌鲁木齐市", "123456",
"152528202504096514", "pack@qq.com") ;
model.addAttribute("user", user) ;
model.addAttribute(JsonView.class.getName(), User.PublicView.class) ;
return new ModelAndView(new MappingJackson2JsonView()) ;
}
}
我们以JsonView的完整类名作为key添加到Model中，最后返回时定义MappingJacksonJsonView视图对象即可控制输出的字段。
2.4 限制反序列化
当我们不希望某些字段被反序列化时，我们也可以通过该视图技术来限制，如下示例：
@PostMapping("/deserialize_json")
public User deserialize(@RequestBody String json) throws Exception {
ObjectMapper mapper = new ObjectMapper() ;
User user = mapper
.readerWithView(User.PublicView.class)
.forType(User.class)
.readValue(json) ;
return user ;
}
我们的接口并没有对password和idCard两个字段进行反序列化。
2.5 配置默认行为
通过上面的示例我们了解到，可以利用 @JsonView 注解来指定字段在哪些视图下可以被序列化输出。如果字段未添加 @JsonView 注解，则默认情况下该字段不会被输出。然而，当实体类的字段数量较多时，为每个字段单独添加注解会非常繁琐。为此，我们可以通过如下配置来更改这一默认行为：
spring: jackson: mapper: default-view-inclusion: true
接下来，我们将User修改如下：
public class User {
private Long id ;
private String name ;
private String address ;
@JsonView(InternalView.class)
private String password ;
@JsonView(InternalView.class)
private String idCard ;
private String email ;
}
我们将公共字段上的注解去掉，接下来，我们再次访问上面的/users/query接口
没有添加注解的字段也可以输出了（这属于默认字段）。
注：我们的接口上还是需要@JsonView(User.PublicView.class)注解。
来源 ：https://mp.weixin.qq.com/s?__biz=MzA5MzI5NjQxNQ==&mid=2447623394&idx=1&sn=cd2fcbf7fed054c2c5e13bcbb34213ce&scene=21&poc_token=HPnHbWijepO33RfQC37I9dEZsyxWbJHLke-TV6gg
