Разбор аннотаций Джексона с помощью Swagger

По умолчанию Swagger анализирует элементы данных класса, чтобы документировать объекты, используемые в качестве параметров или возвращаемые данной веб-службой. Если вы используете Jackson, аннотации Jackson предоставляют гораздо более точное описание API.

Кто-нибудь знает (простой) способ заставить Swagger анализировать аннотации Джексона. Возможно, переопределенный парсер?


jackson json rest swagger api-doc
person Eyal    schedule 13.02.2013    source источник

Ответы (2)


arrow_upward
2
arrow_downward

Не уверен, что это поможет, но Джексон 2.1 и более поздние версии раскрывают структуру POJO, как ее видит сам Джексон (ObjectMapper.acceptJsonFormatVisitor), которую можно использовать для создания различных видов артефактов. Например, я написал с ним генератор схемы Avro (как часть модуля Jackson Avro). )

person StaxMan    schedule 14.02.2013
comment
Вау, это может быть отличным решением. К сожалению, мы используем Jackson 1.9... Надо посмотреть, насколько сложно обновиться. Любые подсказки помимо этого ответа? - person Eyal; 14.02.2013
comment
На самом деле изменения в основном механические, и с IDE я удалил старый импорт и начал заменять его новым, чтобы решить большинство проблем компиляции, а затем переходил к остаткам. Но, возможно, это -- cowtowncoder.com/blog/archives/2012/04. /entry_469.html -- поможет? - person StaxMan; 14.02.2013

arrow_upward
0
arrow_downward

Начиная с версии 1.2, Swagger может самостоятельно анализировать аннотации Джексона. Я подтвердил это, используя Jackson 2.1.

person Eyal    schedule 13.11.2013