spring-mvc - Swagger 无法正确检测请求参数

Question

给定一个控制器，如：

@RequestMapping(value = "/", method = GET)
@ApiOperation(value = "Find items")
public List<Item> find(Query query) {
  ...
}

class Query {
  String text;
  int limit;
}

Spring MVC 让我可以做类似/items/?text=foo&limit=10. 不幸的是，Swagger（或 SpringFox？）认为此端点采用单个“查询”（JSON 对象）参数。我究竟做错了什么？

Answer 1

看起来关键是同时拥有 getter/setter（仅 setter 是不够的）和使用@ModelAttribute（否则在 Spring MVC 中不是必需的）。