170 похожих чатов

Уважаемые, как попросить swagger-ui отобразить оба эндпоинта /api/countries и /api/countries?name=some

- path один, различаются только наличием параметра. В коде контроллера это два метода, но в swagger-ui отображается только один из них.

@RestController
@RequestMapping("/api/countries")
.. class ..

// /api/countries
@io.swagger.annotations.ApiOperation("list all countries")
@GetMapping
public List<Country> findAll() {
return service.findAll();
}


// /api/countries?name=some
@ApiOperation("list countries filtered by name")
@GetMapping(params = "name")
public List<Country> findByName(@RequestParam String name) {
return service.findByName(name);
}

Гуглил всякое типа "swagger separate api by parameters". Пока нагулил только, что swagger так не умеет. Как бы тогда задизайнить?
Можно, конечно, в одном методе и сделать параметр required=false, но так, по-моему, хуже.
Картинко из swagger-ui.

12 ответов

22 просмотра

Может оба метода на один метод повесить? Не знаю как на это отреагирует сваггер, но спринг справится

/api/countries/{name} как вариант PathParam или как там его

Cyclone- Автор вопроса
Sergey Bezrukov
/api/countries/{name} как вариант PathParam или ка...

Не REST-API'шечно. Я же не одну county по name выбираю.

Это выглядит, как корявый дизайн апи, почему это разные эндпоинты с точки зрения внешнего пользователя-то?

Чем это не один метод апи?

Cyclone- Автор вопроса
Alexandr ∨∧‾ Emelyanov
Чем это не один метод апи?

По аналогии со спринг датой - findAll без параметров, findByName с параметром name.

Cyclone
По аналогии со спринг датой - findAll без параметр...

просто findAll без параметров? прям все из базы вытащить? если по аналогии со spring data, то хотя бы Pageable параметр туда передавать нужно в случае со свагерром - хз. я до сих пор на старой версии 2.7.0 свагера сижу. мня устраивает, свои функции выполняет. новый чето не нравиться. возможно вам нужно выбрать какуюто стабильную версию

Shamil Sabirov
просто findAll без параметров? прям все из базы вы...

Просто findAll без параметров Есть и перегрузки с Examaple /Pageable и т д

Похожие вопросы

Обсуждают сегодня

Мужики и девушки, привет) в Вelphi xe7 в настройках во вкладке "Editor Options" далее " Color" есть список: "Elements", открыв который мы можем настраивать отображение разных...
Kraszx
14
Добрый вечер. Есть вопрос, а может и предложение. Был у меня диалог в другой группе о делфи и я задался вопросом: "А нельзя ли в делфи цвет //коментария и {комментария} сде...
Kraszx
24
Я вот подумал. SSE выполняет операции максимум с 64-битной точностью. А FPU - всегда с 80-битной. Разве не должно быть FPU точнее тогда?
The Bird of Hermes
13
как быть с принтером? такой подход прокатит?
zamtmn
12
Мдя, прикол, боевая сборка запускается (именно под отладчиком) после F9 примерно полторы минуты (97 секунд если быть точным). Начал копать - проблема детектится сразу - зависа...
Александр (Rouse_) Багель
38
Всем привет! Подскажи, пожалуйста, как передать в TComboBox сразу значение и id записи. На Delphi я делал так: ComboBox1.Items.AddObject('Какое-то значение', Pointer(id запис...
Евгений
13
Здравствуйте, вопрос по структурам данных. Были у вас случаи, когда пришлось писать деревья или двунаправленные списки?
/ /
50
Я не понимаю, это троллинг или что? Швабрика поддерживают, который буквально пишет на ассемблере взаимодействия с винапи. Я это ещё написал загрузчик и хоть что-то изучаю в о...
Shadow Akira
6
А вот это что за конструкция? Вернее, она тут нафига?
Serjone
10
Привет. Подскажите, как правильно сматчить лист фиксированного размера, чтобы компилятор не говорил мне о неполном паттерне? Допустим что-то такое [x', y'] = sort [x, y]?
Arseny
8
Карта сайта