Не найдено описание для классов с пользовательским Jackson ObjectMapper - PullRequest
0 голосов
/ 13 июня 2019

У меня возникла проблема с 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 Ответ

0 голосов
/ 20 июля 2019

Быстрое обновление по этому вопросу.

Флориан выпустил GitHub по этому поводу, и все исправлено в 2.0.6.Так что просто используйте 2.0.6, и вам будет хорошо.

См. https://github.com/ScaCap/spring-auto-restdocs/issues/336

Спасибо, Флориан и команда Auto Rest Doc!

...