Springdoc OpenAPI v2是否支持为QueryDSL谓词路径生成查询参数文档?
Spring Data REST + QueryDSL + Springdoc v2集成的OpenAPI查询参数文档生成问题
Spring Data REST可简化CRUD REST控制器的模板创建。与QueryDSL集成后,HTTP查询参数可绑定到QueryDSL路径以过滤集合资源,例如:GET /items?myProperty=foo
甚至支持关联属性的嵌套过滤:GET /items?myRelation.myProperty=foo
只要仓库继承QuerydslPredicateExecutor和QuerydslBinderCustomizer,并使用@RepositoryRestResource注解,就能开箱即用上述过滤功能,无需手动定义端点方法或查询参数。
但在集成Springdoc v2生成OpenAPI规范时,无法自动为所有可能的属性路径生成对应的查询参数文档。
这种情况其实符合预期,理论上可通过反射检查生成的EntityPath实现类或实体类字段来实现该功能,但旧讨论显示该功能曾在OpenAPI v1 + Spring Boot v2的组合中可用:
- 2023年的类似问题,未找到适配Springdoc v2的解决方案
- 2022年的类似问题,存在适用于Springdoc v1的可行方案
目前三者集成的相关文档和讨论较少,想请教:
- 该功能是否仍可通过配置实现?
- 是否有可用的演示示例或相关文档参考?
内容的提问来源于stack exchange,提问作者Ben
相关产品推荐
相关产品推荐

