Создание документации Swagger из существующего REST API

Учитывая существующий JAX-RS-аннотированный API, который принимает и возвращает json с аннотированными типами Джексона, есть ли способ, которым я могу генерировать некоторую документацию YAML Swagger? Мой план B состоит в том, чтобы написать некоторый код, который использует отражение, чтобы найти REST-аннотированные типы, создать хэш-карту их аргументов и возвратов, а затем отсканировать эти классы для аннотаций Джексона и таким образом сгенерировать документацию.

Я бы предпочел использовать решение, которое уже существует, для написания одноразовой вещи. Я нашел этот модуль Swagger, который утверждает, что он может анализировать конфигурации Джексона (https://github.com/FasterXML/jackson-module-swagger) но я не знаю достаточно о Swagger, чтобы понять, что такое модули и могу ли я использовать его для генерации Swagger из существующего кода.

Ответы на вопрос(2)

Ваш ответ на вопрос