swagger-annotations @Schema не предоставляет средства для определения свойств - PullRequest
0 голосов
/ 31 января 2020

Я использую swagger-annotations:2.1.1.

Согласно swagger.io specs конфигурация для составной загрузки файла будет:

"requestBody": {
          "content": {
            "multipart/form-data": {
              "schema": {
                "type": "object",
                "properties": {
                  "file_a": {
                    "type": "string",
                    "format": "binary"
                  },
                  "file_b": {
                    "type": "string",
                    "format": "binary"
                  }
                }
              }
            }
          }

Это - на самом деле - сработало бы и показывало бы две кнопки загрузки файлов в swagger-ui и отправляло бы правильный multipart-запрос на мой сервер.

Я не могу найти какое-либо свойство в аннотации @Schema для предоставления раздела properties. До сих пор я придумал:

@Operation(
            requestBody = @RequestBody(
                    content = @Content(
                            mediaType = MediaType.MULTIPART_FORM_DATA_VALUE,
                            schema = @Schema(
                                    type = "object"
                                    // -> properties[] is missing !!!
                            )
                    ))
    )

Почему @Schema не предоставляет никаких средств для добавления раздела properties?

Best, -Stefan

...