目 录CONTENT
以下是
勤为径苦作舟
的文章
-
Knife4j/Swagger 忽略实体类或 List 属性，含接收 MyBatis Plus 分页 Page 参数、返回 Page 对象写法 在使用 MyBatis Plus 进行分页查询时，Controller 层通常直接继承 Page<T> 对象作为入参（PageQO），以便直接传递给 Service 层。但这会导致 Swagger/Knife4j 文档中暴露 records、orders、optimizeCountSql 等大量无关内部字段，干扰前端对接。 本文详细介绍了如何优雅地解决这一问题，并提供了针对不同 Swagger 版本的解决方案： Swagger 3 (io.swagger.core.v3)：通过 @JsonIgnoreProperties 注解一键忽略非业务参数。 Swagger 2 (2.10.x / Knife4j 2.0.9)：针对 @ApiModelProperty(hidden = true) 无法隐藏非基础类型（如 List、OrderItem）的 Bug，提供了重写 ModelAttributeParameterExpander 源码及自定义 @MyApiIgnore 注解的深度解决方案。 领域模型规范：演示了如何通过 PageQO（查询对象）与 PageVO（视图对象）分离，结合 BaseController 封装，实现清爽、规范的 RESTful 分页接口。