Можно ли использовать spring-auto-restdocs с Swagger/SpringFox?

Question

Можно ли использовать spring-auto-restdocs с Swagger/SpringFox, swagger2markup?

Я хотел бы: - Использовать Swagger / SpringFox для предоставления тестовой области, НО тогда я хочу, чтобы примеры в этом пользовательском интерфейсе были похожи на то, что - spring-restdoc делает для предоставления фрагментов кода примера И - Используйте spring-auto-restdocs для получите документацию от POJO, представляющую ваш JSON-объект, просто добавив Javadoc в поля, а не аннотации swagger

Answer 1

Я не вижу простого способа добиться этого. Без использования какого-либо кода Swagger (аннотаций или SpringFox DSL) SpringFox или swagger2markup не очень полезны. Если у вас есть и аннотации Swagger, и Spring (Auto) REST Docs, возможно, можно включить фрагменты AsciiDoc, сгенерированные Spring (Auto) REST Docs, в AsciiDoc, используемый для swagger2markup. AsciiDoc поддерживает включение других файлов AsciiDoc, и эта функция также используется при включении фрагментов Spring REST Docs в рукописную документацию.

Я изучил создание файлов Swagger/OpenAPI из фрагментов REST Docs и написал руководство о том, как это сделать https://github.com/fbenz/restdocs-to-swagger Однако это скорее комбинация инструментов, чем простой интеграция. Кроме того, полевая и методическая документация не попадает в Swagger files/UI.