OpenApi annotation formParam

Hello, I have this kind of request handler:

@OpenApi(
    path = "/activate",
    method = HttpMethod.POST
)
public void activateWithKey(Context ctx) {
    String key = ctx.formParam("key");
    do_smth(key);
}

I can’t find what OpenApiRequestBody annotation should I use for requestBody with formdata key=value? Can you help me?

[tobias-walle]

@sealedtx It seems like I completely forgot to implement this feature. I will add it this weekend. This shouldn’t be much work.

[tobias-walle]

After the merge you can document form parameters with annotations:

@OpenApi(
        formParams = [
            OpenApiFormParam(name = "name", type = String::class, required = true),
            OpenApiFormParam(name = "age", type = Int::class)
        ],
        responses = [
            OpenApiResponse(status = "200")
        ]
)
fun putFormDataHandler(ctx: Context) {
}

@OpenApi(
        requestBody = OpenApiRequestBody(content = [OpenApiContent(Address::class, type = ContentType.FORM_DATA)]),
        responses = [
            OpenApiResponse(status = "200")
        ]
)
fun putFormDataSchemaHandler(ctx: Context) {
}

or the DSL:

val getFormDataDocumentation = document()
        .formParam<String>("name", required = true)
        .formParam<Int>("age")
        .result<Unit>("200")
app.put("/form-data", documented(getFormDataDocumentation) {})

val getFormDataSchemaDocumentation = document()
        .formParamBody<Address>()
        .result<Unit>("200")
app.put("/form-data-schema", documented(getFormDataSchemaDocumentation) {})