@JsonView + 单一 DTO：如何实现多场景 JSON 字段动态渲染

1、@JsonView 注解产生的背景

@JsonView 是 Jackson 库提供的一个注解，用于控制 Java 对象序列化为 JSON 时的字段可见性。通过定义不同的“视图”（View），可以灵活地决定哪些字段在特定场景下被序列化，从而避免为不同接口编写多个相似的 DTO 类。

2、为了满足不同场景下返回对应的属性的做法有哪些？

2.1 最快速的实现则是针对不同场景新建不同的 DTO 对象

细心的童鞋可以发现：虽然是不同的 DTO，但是存在共同的属性，而且比如后面再来一个需求，这个接口仅返回基本信息的字段（外加一个手机号字段），那么我们是不是还需要创建一个新的 DTO 对象呢？如果针对每一个接口返回都定义一个 DTO 对象的话，对于后端代码的维护也是相当的冗余操作，鉴于这种需求，有没有一种对应后端的 其他 解决方案呢？答案是有的。即就是（@JsonView注解）。

2.2 使用 @JsonView 注解实现不同DTO对象的返回

2.2.1 定义同一个 DTO 对象

/**
 * @Description 用户DTO
 * @Author Mr.Gao
 * @Date 2025/4/16 23:43
 */
@Getter
@Setter
public class User {
    /**
     * 用户姓名
     */
    @JsonView(SimpleInfoView.class)
    private String username;
    /**
     * 用户年龄
     */
    @JsonView(SimpleInfoView.class)
    private Integer age;
    /**
     * 用户性别
     */
    @JsonView(SimpleInfoView.class)
    private String sex;

    /**
     * =================以下信息为用户敏感信息不能给用户返回================
     */

    /**
     * 手机号码
     */
    @JsonView(SensitiveInfoView.class)
    private String mobileNo;
    /**
     * 登录密码
     */
    @JsonView(SensitiveInfoView.class)
    private String loginPwd;
    /**
     * 支付密码
     */
    @JsonView(SensitiveInfoView.class)
    private String payPwd;
}

2.2.2 区分不同的响应视图

/**
 * @Description 简单视图展示View信息
 * @Author Mr.Gao
 */
public interface SimpleInfoView {
}

------ 视图与视图之间是可以继承的，那么也就实现既包含基础信息字段又包含需要的字段，进而实现不同DTO的返回 ---
/**
 * @Description 敏感信息
 * @Author Mr.Gao
 */
public interface SensitiveInfoView extends SimpleInfoView {
}

2.2.3 Controller 层的调用

/**
 * @Description 用户控制层
 * @Author Mr.Gao
 * @Date 2025/4/16 23:50
 */
@RestController
public class UserController {

    /**
     * 模拟从数据库获取用户信息
     *
     * @return
     */
    public static User getUserInfoFromDB() {
        User user = new User();
        user.setUsername("Mr.Gao");
        user.setAge(18);
        user.setSex("男");
        user.setMobileNo("12345678901");
        user.setLoginPwd("123456");
        user.setPayPwd("123456");
        return user;
    }

    /**
     * 获取用户简要信息
     *
     * @return
     */
    @JsonView(SimpleInfoView.class) // 返回简要信息的视图DTO
    @GetMapping("/user/getUserSimpleInfo")
    public User getUserSimpleInfo() {
        return getUserInfoFromDB();
    }

    /**
     * 获取用户详细信息
     *
     * @return
     */
    @JsonView(SensitiveInfoView.class)// 返回详情信息的视图DTO
    @GetMapping("/user/getUserDetailInfo")
    public User getUserDetailInfo() {
        return getUserInfoFromDB();
    }

}

2.2.4 简要信息 视图 DTO

2.2.5 详情信息 视图 DTO

2.3 问题已解决（引入原理实现篇）

经过上述代码案例操作，确实是可以解决我们后端程序猿的新建多个 DTO 对象的冗余问题，童鞋们可以都试试，但是出于好奇，为了什么在 一个实体对象 DTO 和 controller 层的方法 增加 @JsonView 注解之后就能实现不同视图的效果呢？其中究竟是使用了什么魔法呢？接下来我们继续进入 Debug 调试篇，继续 gank 它。

3、Debug调试篇

3.1 SpringMvc 切入点 对应的核心代码片段

3.2 字段属性序列化核心逻辑

经过上述分析可得，设置视图的核心代码为 objectMapper.writerWithView(serializationView) ，然后调用 objectMapper.writeValueAsString 方法是否可以实现不同视图的 DTO 输出呢？

3.3 多种 DTO 视图 Demo 验证

3.3.1 ObjectMapper 配置视图 View

@Test
public void testJsonViewAnnotationConvertMutiDTOByObjectMapper() throws JsonProcessingException {
    User user = UserController.getUserInfoFromDB();

    // @1: 设置序列化视图为SimpleInfoView(输出简要信息)
    objectMapper.setConfig(objectMapper.getSerializationConfig()
            .withView(SimpleInfoView.class));

    // @2: 设置序列化视图为SensitiveInfoView(输出详细信息)
    //objectMapper.setConfig(objectMapper.getSerializationConfig()
    //        .withView(SensitiveInfoView.class));

    System.out.println("采用Object序列化视图:" + objectMapper.getSerializationConfig().getActiveView());
    String JsonResult = objectMapper.writeValueAsString(user);
    System.out.println(JsonResult);
}

3.3.2 ObjectWriter 配置视图 View

@Test
public void testJsonViewAnnotationConvertMutiDTOByObjectWriter() throws JsonProcessingException {
    User user = UserController.getUserInfoFromDB();

    // @1: 设置序列化视图为SimpleInfoView(输出简要信息)
    //ObjectWriter objectWriter = objectMapper.writerWithView(SimpleInfoView.class);

    // @2: 设置序列化视图为SensitiveInfoView(输出详细信息)
    ObjectWriter objectWriter = objectMapper.writerWithView(SensitiveInfoView.class);

    System.out.println("ObjectWriter中的序列化视图为: " + objectWriter.getConfig().getActiveView());
    String JsonResult = objectWriter.writeValueAsString(user);
    System.out.println(JsonResult);
}

3.4 小结

最后，我本地的项目 SpringBoot 版本是 2.6.13，而我的 Pom 文件依赖中仅仅引入了spring-boot-starter-web，我可以确定的是没有引入任何 jackson 包的依赖的，而@JsonView 注解是 jackson 包下的注解，那么只有一种可能，那就是对应的 springboot 的 web 依赖集成了对应 jackson 相关 jar 包，出于好奇的我还是点开了 spring-boot-starter-web 依赖，结果发现确实是这样。

4、扩展点

4.1 ResponseBodyAdvice接口

对响应的内容可以进行二次包装处理，例如对响应参数内容统一进行签名、加密等逻辑处理。

4.2 RequestBodyAdvice接口

用来对请求的内容进行请求参数重写处理，例如对接收到请求参数统一进行验签、解密等逻辑处理。

综上所述，相信我们已经掌握了 如何通过一个 DTO 对象来渲染不同需求场景下的 DTO 对象，不过存在唯一的缺点，经过 Debug 调试篇我们可以发现，只有在 序列化的时候才会过滤对应的字段，那么如果一个 DTO 对象的属性太多，根据类的单一设计原则还是建议使用新建新的 DTO 对象来完成。所以我觉得可以视情况而定，想要代码的逻辑清晰一些就新建 DTO 实体，想要减少的代码的编码量（即减少 DTO 实体对象）那么就用@JsonView注解实现。