使用 Swagger/Springfox 和 Spring Boot 将查询参数解组到对象中

Question

我的 REST 服务中有一个搜索端点。我正在使用 Spring Boot，所以我有一个 @RestController 设置，它带有一个基于搜索查询返回搜索结果的方法。这是方法定义：

@ApiOperation(value = "Get global search results")
@RequestMapping(method = GET, produces = {"application/json"})
public SearchResults get(SearchQuery query) {
    ...
}

我希望 SwaggerUI 在 UI 中将 SearchQuery 的字段显示为单独的查询参数。它没有；它只显示一个通用的“查询”参数。如果我使用 @RequestBody 注释查询，则用户可以向正文添加 json 有效负载，但这是一个 GET 请求 - 我希望用户只使用查询参数。

有什么想法吗？

Answer 1

用@ModelAttribute 注释SearchQuery，它应该可以按预期工作。

Answer 2

对于 Srspring 2.6.3 和 springdoc 1.6.6 在 SearchQuery 之前使用 @ParameterObject 注释