java - 如何在 Swagger 中添加有关 API 的更多信息？

Question

我在我的项目中包含了 swagger-springmvc 并设法使 Swagger UI 正常工作，但现在关于 UI 中的 API 的信息非常少。我所看到的只是通过反射提取的信息。

这是 Controller 方法的样子:

/**
 * Read all users matching given filter
 * @param String filter The text by which to filter the usernames
 * @return User[] Array of users matching given filter
 * @throws Exception
 */
@RequestMapping(value = "/users/{filter}", method = RequestMethod.GET)
public
@ResponseBody
Collection<User> getUsers(@PathVariable("filter") String filter) throws Exception {
    return domain.getUsersFilteredBy(filter);
}

并且在每个方法的右侧，Swagger 记录了方法的名称，在这种情况下:

get Users

但我期待看到这个:

Read all users matching given filter

在 helloreverb.com 上的示例中，我看到了对每个方法的描述。我怎样才能像这样 Swagger 将我的 Controller 方法的描述添加到 UI 中？

Answer 1

@ApiOperation(value = "Read all users matching given filter",  notes = "Will get all the users for the given filter")