You need to enable JavaScript to run this app.
优惠活动
大模型
产品
解决方案
定价
更多

如何在ObjectWriter中排除指定字段?避免引入DTO的实现

解决Jackson序列化时包含不需要的calculationSeed字段问题

首先,我们来拆解你遇到的核心问题:你的Person类注解配置存在冲突,导致Jackson在序列化请求体时,把默认值为0.0的calculationSeed字段也包含了进去,而你希望这个字段仅出现在服务端响应中,请求体里完全不包含它。

问题根源分析

你当前的注解组合逻辑矛盾:

  • 字段上的@JsonIgnore被getter方法上的@JsonProperty覆盖了——Jackson优先识别方法级别的注解,因此会将这个字段纳入序列化范围。
  • 由于double类型的默认值是0.0,当你用Builder创建Person对象时,calculationSeed会被自动初始化为0.0,序列化时就会被写入JSON请求体。

解决方案

根据你的需求(请求不包含该字段,响应强制包含),推荐两种简洁的实现方式:

方案1:使用@JsonProperty.Access.READ_ONLY结合@JsonInclude

这种方式既能确保该字段仅在响应中序列化,又能排除默认值的干扰:

@Data
@Builder
@NoArgsConstructor
@AllArgsConstructor
@JsonPropertyOrder({"firstName", "lastName", "age", "calculationSeed"})
public class Person {
    @NotNull
    @JsonProperty("first_name")
    private String firstName;
    
    @NotNull
    @JsonProperty("last_name")
    private String lastName;
    
    private int age;
    
    // 标记为只读:仅允许序列化输出(响应),拒绝反序列化输入(请求)
    @JsonProperty(value = "calculation_seed", access = JsonProperty.Access.READ_ONLY)
    // 仅当值不为默认值0.0时才序列化,彻底避免请求体出现该字段
    @JsonInclude(JsonInclude.Include.NON_DEFAULT)
    private double calculationSeed;
}
  • access = JsonProperty.Access.READ_ONLY:明确告诉Jackson这个字段只能从对象读取(序列化到响应),不能从JSON写入(反序列化到对象)。
  • @JsonInclude(JsonInclude.Include.NON_DEFAULT):确保只有当calculationSeed被服务端设置为非默认值(即非0.0)时,才会被序列化到JSON中,完美适配你“请求无、响应有”的需求。

方案2:使用Jackson视图(JsonView)区分请求和响应

如果需要更灵活的字段权限控制,可以用视图分离请求和响应的序列化规则:

  1. 定义视图类:
public class PersonViews {
    // 请求视图:仅包含客户端需要提交的字段
    public static class Request {}
    // 响应视图:继承请求视图,追加服务端生成的字段
    public static class Response extends Request {}
}
  1. 修改Person类注解:
@Data
@Builder
@NoArgsConstructor
@AllArgsConstructor
@JsonPropertyOrder({"firstName", "lastName", "age", "calculationSeed"})
public class Person {
    @NotNull
    @JsonProperty("first_name")
    @JsonView(PersonViews.Request.class)
    private String firstName;
    
    @NotNull
    @JsonProperty("last_name")
    @JsonView(PersonViews.Request.class)
    private String lastName;
    
    @JsonView(PersonViews.Request.class)
    private int age;
    
    @JsonProperty("calculation_seed")
    @JsonView(PersonViews.Response.class)
    private double calculationSeed;
}
  1. 在测试中使用请求视图序列化:
@BeforeAll
public static void setUp() {
    mapper = new ObjectMapper();
    // 使用请求视图序列化请求体,只会包含标记为Request视图的字段
    ow = mapper.writerWithView(PersonViews.Request.class)
               .withDefaultPrettyPrinter();
}

同时,在你的Spring控制器中,返回响应时指定Response视图,确保calculationSeed被包含在响应里。

验证修改效果

调整后重新运行测试,请求体将不再包含calculationSeed字段,而响应中会正常返回服务端生成的该字段值,完全符合你的需求。

内容的提问来源于stack exchange,提问作者J.Olufsen

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.05.09 15:27:28