Не найдено описание для классов с пользовательским 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!

Другие вопросы по тегам