java - Springfox - 手动，以编程方式添加模型

Question

我想添加一个自定义 Controller 来 swagger API 描述符。
使用 spring fox 可以很容易地自定义现有模型。
但是我没有成功地从头开始将自定义 API 添加到 swagger 描述符。
一个例子胜过长篇大论。

我做了一个测试项目springfox-test

我有一个 Controller (ItemController)，它处理两个 URL( /item/name 和 /item/number )并返回两个不同的 bean( ItemName 和 ItemNumber )。

通过 ApiListingScannerPlugin 实现将这两个操作添加到 Swagger 并不难，但我必须引用我的 bean(ItemName 和 ItemNumber)，我不知道如何以及在哪里描述这些 bean。

ApiListingBuilderPlugin 类似乎是这样工作的，但我们只能访问 API 的构建器，然后我必须覆盖所有模型。

有没有办法请春狐来形容这些 bean ？

Answer 1

ApiListingScannerPlugin对于一个简单的 API 来说，似乎需要做更多的工作。您应该能够删除该插件以及 SimpleUrlHandlerMapping bean，然后像这样实现 Controller 。

@RestController
public class ItemController {
    @GetMapping("/item/name")
    public ItemName foo(@RequestParam("value") ItemName name) {
        return name;
    }

    @GetMapping("/item/number")
    public ItemNumber bar(@RequestParam("value") Integer number) {
        return new ItemNumber(number);
    }
}

Springfox 将根据这些方法签名检测两个端点和两个模型，并相应地生成 Swagger 描述。