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

Tof*_*off 5 java spring swagger springfox

我想向 swagger API 描述符添加一个自定义控制器。使用 Spring Fox 自定义现有模型非常容易。但我没有成功从头开始将自定义 API 添加到 swagger 描述符。一个例子胜过长篇大论。

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

我有一个控制器 (ItemController),它处理两个 URL(/item/name/item/number)并返回两个不同的 bean(ItemNameItemNumber)。

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

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

有没有办法让Spring Fox描述一下这些豆子?