@ApiModel и @ApiModelProperty обязательны при переходе с Swagger 1.2 на Swagger 2.0. ⇐ JAVA

[Anonymous]

Вопросы и ответы (заполните следующую информацию)

[*]ОС: macos
[*]Браузер: Chrome
[*]Версия: 130.0.6723.117
[*]Способ установки: https://swagger.io/docs/open-source-too ... stallation /#unpkg
[*]Версия Swagger-UI: 5.11.0
[*]Версия Swagger/OpenAPI: Swagger 2.0

Содержимое и конфигурация
Я перехожу с версии Swagger 1.2 на версию Swagger 2.0. Мои API настроены таким образом

Код: Выделить всё

@ApiOperation(value = "Get user", notes = "get user", response = User.class)
@ApiResponses(value = { @ApiResponse(code = RestConstant.STATUS_CODE_400, message = "Invalid User Input"),
@ApiResponse(code = RestConstant.STATUS_CODE_500, message = "Internal Server Error") })
@Override
@GZIP
@Path("/{number}")
@PUT
public Response getUser( @ApiParam(value = "Profile object with hostname", required = true) User user,
@PathParam("accountNumber") String number) {

Определение Swagger/OpenAPI:
Моя схема для запроса и ответа имеет нулевое значение

Код: Выделить всё

"User": {
"type": "object",
"properties": {

},
"xml": {
"name": "user"
}
}

Параметры конфигурации Swagger-UI:

Код: Выделить всё

SwaggerUI







window.onload = () => {
window.ui = SwaggerUIBundle({
url: 'restservices/swagger.json',
dom_id: '#swagger-ui',
presets: [
SwaggerUIBundle.presets.apis,
SwaggerUIStandalonePreset
],
layout: "StandaloneLayout",
});
};

Чем мы можем помочь?
Я не использовал @ApiModel и @ApiModelProperty с swagger 1.2 и swagger смог сгенерировать схему, но теперь она сломана. Так это теперь обязательно? Кроме того, я создаю классы моделей из файлов xsd. Предоставьте документ, как это аннотировать?


Подробнее здесь: https://stackoverflow.com/questions/791 ... -1-2-to-sw