Swagger文档中缺少参数endpoint的Spring BootGET和GET

Question

我在 rest 控制器中有两个 get 映射，一个具有必需的请求参数（项目 ID），一个没有具有相同路径的请求参数。

此外，在项目中设置一个带有UI的基本Swagger。起初，从我之前描述的2 get映射中，有一个是随机丢失的，然后我用swagger注释正确注释它们，但现在不带参数的get不断丢失。

@ApiOperation("Get item with the given ID")
@GetMapping(value="/resource/item", params = "id")
public Item getOne(@ApiParam(value = "the ID of the item want to view") @RequestParam(name = "id") Long id) {
    //things...
}

@ApiOperation("Get all item")
@GetMapping(value="/resource/item")
public List<Item> getAll() {
    //things...
}

有没有办法强制昂首阔步既得图又得图？

更新:是的，路径变量可以是一个很好的解决方案，但由于遗留的原因，我不能这样做。

Answer 1

我将使用Pathvariable而不是RequestParam

@ApiOperation("Get item with the given ID")
@GetMapping(value="/resource/item/{id}")
public Item getOne(@ApiParam(value = "the ID of the item want to view") @PathVariable Long id) {
    //things...
}

这样你的映射就不同了，很可能会大摇大摆地出现。