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

Question

给定一个 Controller :

@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

看起来关键是同时拥有 getters/setters(仅 setters 是不够的)并使用 @ModelAttribute(否则在 Spring MVC 中不是必需的)。