Spring Boot中如何用同一POJO类生成不同参数的JSON响应

刚好遇到过类似的REST开发场景，用同一个POJO给不同接口返回不同字段，这里有几个靠谱的解决方案，适配你的现有代码：

方案1：Jackson JsonView注解（最简洁直接） #

这是Jackson提供的原生方案，通过定义视图接口来标记哪些字段在哪些场景下返回，完全不需要额外的DTO类。

步骤1：定义视图接口 #

先创建两个空的标记接口，用来区分不同的返回视图：

// 基础视图：包含propertyId和propertyName
public interface Views {
    interface Basic {}
    // 完整视图：继承基础视图，额外包含propertyType
    interface Full extends Basic {}
}

步骤2：给实体类字段标记对应视图 #

在你的Property实体类中，给每个字段添加@JsonView注解，指定它属于哪个视图：

@Entity 
@Table(name = "property_table") 
public class Property { 
    @Id 
    @Column(name = "property_id") 
    @GeneratedValue(strategy = GenerationType.IDENTITY)
    @JsonView(Views.Basic.class) // 属于基础视图
    private int propertyId; 
    
    @Column(name = "property_name")
    @JsonView(Views.Basic.class) // 属于基础视图
    private String propertyName; 
    
    @Column(name = "property_type")
    @JsonView(Views.Full.class) // 属于完整视图
    private String propertyType; 

    // 记得添加getter/setter（Jackson需要访问字段）
}

步骤3：在接口方法上指定视图 #

修改你的RestController接口，用@JsonView指定该接口返回哪个视图的字段，同时可以省略@ResponseBody（因为@RestController已经包含了这个注解）：

@RestController
public class PropertyController {

    @GetMapping(value = "/getProperties", produces = { "application/json", "application/xml" })
    @JsonView(Views.Basic.class) // 返回基础视图字段：propertyId + propertyName
    public List<Property> getProperties() { 
        // 你的业务逻辑，比如从数据库查询数据
        return propertyService.getAllProperties();
    } 

    @GetMapping(value = "/getPropertyById", produces = { "application/json", "application/xml" })
    @JsonView(Views.Full.class) // 返回完整视图字段：全部三个字段
    public Property getPropertyById(@RequestParam int id) { 
        // 你的业务逻辑，根据ID查询数据
        return propertyService.getPropertyById(id);
    }
}

方案2：动态字段过滤（Jackson ObjectMapper自定义） #

如果需要更灵活的动态控制（比如根据请求参数决定返回字段），可以用Jackson的过滤功能：

步骤1：给实体类添加@JsonFilter注解 #

@Entity 
@Table(name = "property_table")
@JsonFilter("propertyFieldFilter") // 定义过滤器名称
public class Property { 
    // 字段和原有注解保持不变
    private int propertyId;
    private String propertyName;
    private String propertyType;
}

步骤2：在接口中配置过滤规则 #

在getProperties接口中，指定忽略propertyType字段：

@GetMapping("/getProperties")
public MappingJacksonValue getProperties() {
    List<Property> properties = propertyService.getAllProperties();
    
    // 创建过滤规则：序列化所有字段，除了propertyType
    SimpleBeanPropertyFilter filter = SimpleBeanPropertyFilter.serializeAllExcept("propertyType");
    FilterProvider filterProvider = new SimpleFilterProvider().addFilter("propertyFieldFilter", filter);
    
    // 包装数据并设置过滤器
    MappingJacksonValue result = new MappingJacksonValue(properties);
    result.setFilters(filterProvider);
    
    return result;
}

// getPropertyById接口直接返回实体即可，不需要额外处理
@GetMapping("/getPropertyById")
public Property getPropertyById(@RequestParam int id) {
    return propertyService.getPropertyById(id);
}

方案3：DTO数据传输对象（最清晰的架构方案） #

如果你的项目追求更清晰的分层，推荐用DTO来专门处理接口返回数据，避免实体类和返回格式耦合：

步骤1：创建对应的DTO类 #

// 基础DTO：对应getProperties接口的返回格式
public class PropertyBasicDTO {
    private int propertyId;
    private String propertyName;

    // 构造器、getter/setter
    public PropertyBasicDTO(int propertyId, String propertyName) {
        this.propertyId = propertyId;
        this.propertyName = propertyName;
    }

    // getter/setter...
}

// 完整DTO：对应getPropertyById接口的返回格式
public class PropertyFullDTO extends PropertyBasicDTO {
    private String propertyType;

    public PropertyFullDTO(int propertyId, String propertyName, String propertyType) {
        super(propertyId, propertyName);
        this.propertyType = propertyType;
    }

    // getter/setter...
}

步骤2：接口中转换实体为DTO返回 #

@GetMapping("/getProperties")
public List<PropertyBasicDTO> getProperties() {
    List<Property> properties = propertyService.getAllProperties();
    // 把实体转换为基础DTO
    return properties.stream()
            .map(p -> new PropertyBasicDTO(p.getPropertyId(), p.getPropertyName()))
            .collect(Collectors.toList());
}

@GetMapping("/getPropertyById")
public PropertyFullDTO getPropertyById(@RequestParam int id) {
    Property property = propertyService.getPropertyById(id);
    // 把实体转换为完整DTO
    return new PropertyFullDTO(property.getPropertyId(), property.getPropertyName(), property.getPropertyType());
}

提示：可以用MapStruct框架自动生成实体和DTO的转换代码，减少手动编写的工作量。

内容的提问来源于stack exchange，提问作者Mani Bellamkonda