java - Swagger 无法识别我的 OpenApi 注释

Question

我正在尝试为我的 API 构建一个 swaggerUI，并且我想为我的 POST 方法指定 pathParameters。

我的代码设置如下：

app.routes {
    post("/cameras") { context -> postCamera(context) }
}

@OpenApi(
    summary = "Create Camera",
    operationId = "postCamera",
    tags = ["Camera"],
    formParams = [OpenApiFormParam("userId", String::class, true),
                  OpenApiFormParam("groupIds", List::class, true),
                  OpenApiFormParam("cameraName", String::class, true)],
    responses = [
        OpenApiResponse("200"),
        OpenApiResponse("400"),
        OpenApiResponse("409")
    ]
)
private fun postCamera(context: Context) {...}

我一直在尝试按照这里写的信息，但最终结果仍然是默认的 swaggerUI POST 方法

我究竟做错了什么？

Answer 1

不幸的是，出于我的理智，解决方案是使我在 IntelliJ 中的缓存无效。我的代码库中没有问题。

Answer 2

对我来说，它有助于在控制器处理程序的注释中指定path和。method