Лучший способ настроить Swagger/Compojure 404 ответа

Question

В Compojure можно определить по умолчанию 404 поведение, например,

(defroutes app-routes 
    ;; ... 
    (route/not-found "These aren't the droids you're looking for.")) 

Как мы уже были увеличение числа и сложности REST конечных точек, мы искали в переход на Swagger/compojure-api. Swagger кажется более высоким уровнем и сильно отличается от базового Compojure. Какая правильная идиома для настройки поведения 404 с использованием этой библиотеки?

Answer 1

В спецификации Swagger нет определения для обработчика по умолчанию «пропущено все остальное» Compojure. Swagger - это документирование существующей apis, а не несуществующей. Просто обсудили это на #swagger на freenode.

Тем не менее, вы можете описать маршруты по умолчанию вручную с помощью compojure-api, создав образец здесь: https://gist.github.com/ikitommi/cdf19eeaf4918efb051a.

Примечание: Спецификация Swagger на самом деле не понимает метод ANY -http, но, похоже, работает с 1.2 Swagger UI - не будет работать с кодегами. Чтобы быть стандартным, вы должны добавить ручные обработчики для всех методов http (https://github.com/swagger-api/swagger-spec/blob/e42dd2011340a12efbb531f593c0f99c831c4582/schemas/v1.2/operationObject.json#L10) до конца определений маршрутов.

надеюсь, что это поможет.