Не найдено описание для классов с пользовательским Jackson ObjectMapper
Я столкнулся с проблемой с Spring AutoRest Docs. Кажется, проистекает из этого кода
.alwaysDo<DefaultMockMvcBuilder>(JacksonResultHandlers.prepareJackson(objectMapper))
Полная конфигурация:
mockMvc = MockMvcBuilders
.webAppContextSetup(webApplicationContext)
.alwaysDo<DefaultMockMvcBuilder>(JacksonResultHandlers.prepareJackson(objectMapper))
.alwaysDo<DefaultMockMvcBuilder>(document("{class-name}/{method-name}",
Preprocessors.preprocessRequest(Preprocessors.prettyPrint()),
Preprocessors.preprocessResponse(Preprocessors.prettyPrint())))
.apply<DefaultMockMvcBuilder>(documentationConfiguration(this.restDocumentation)
.uris()
.withScheme("https")
.withHost("localhost")
.and().snippets()
.withDefaults(CliDocumentation.curlRequest(),
HttpDocumentation.httpRequest(),
HttpDocumentation.httpResponse(),
AutoDocumentation.requestFields()
.failOnUndocumentedFields(true),
AutoDocumentation.responseFields()
.failOnUndocumentedFields(true),
AutoDocumentation.pathParameters(),
AutoDocumentation.requestParameters(),
AutoDocumentation.description(),
AutoDocumentation.methodAndPath(),
AutoDocumentation.section(),
AutoDocumentation.links()))
.build()
Я немного настроил Джексона, и авторест, похоже, не нравится. Когда я введу свой objectMapper
Я получаю следующие предупреждения:
No Javadoc found for class java.lang.Object
No Javadoc found for class java.io.Serializable
No description found for constraint com.domain.CLASS: Can't find resource for bundle java.util.PropertyResourceBundle, key com.domain.CLASS.description
Я пытался внедрить другие способы получить в объектном картографе, в том числе
MappingJackson2HttpMessageConverter
ObjectMapperResolver
Я также попытался раскрутить свежее приложение Spring Boot и не обнаружил никаких ошибок. Если prepareJackson
больше нет предупреждений, однако в автоматически сгенерированных документах нет данных.
Я застрял в этом вопросе довольно долго, и не уверен, как решить его. Любое руководство будет с благодарностью.
1 ответ
Быстрое обновление по этому вопросу.
Флориан выпустил GitHub по этому поводу, и все исправлено в 2.0.6. Так что просто используйте 2.0.6, и вам будет хорошо.
См. https://github.com/ScaCap/spring-auto-restdocs/issues/336
Спасибо, Флориан и команда Auto Rest Doc!