Swagger 无法识别我的 OpenApi 注释

Question

我正在尝试为我的 API 构建一个 swaggerUI，我想为我的 POST 方法指定路径参数。

我的代码设置如下：

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) {...}

我一直在尝试按照写的信息here, but the end result is still the default swaggerUI POST method

我做错了什么？

Answer 1

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

Answer 2

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

Swagger 无法识别我的 OpenApi 注释

Swagger is not recognizing my OpenApi annotation

java

kotlin

swagger

openapi

javalin