Springfox Swagger: не удалось разрешить указатель: / Definitions / Instant

Question

У нас есть проект SpringBoot, и мы используем Springfox Swagger для генерации документации API.

Существует класс ответа, который содержит:

private Collection<Instant> quartzScheduledDates;

Когда я запускаю SwaggerUI, я получаю следующее сообщение:

Ошибка распознавания ошибок на paths./subscription/{subscriptionIdStr} .get.responses.200.schema.properties.quartzScheduledDates.items. $ ref Не удалось разрешить ссылку из-за: Не удалось разрешить указатель: / Definitions / Instant не существует в документе

Мы используем Springfox Swagger 2.9.2, SpringBoot 2.1.2-RELEASE.

Я также пытался использовать трюк Docket в springfox, как видно из Документация Springfox :

    docket.directModelSubstitute(Instant.class, java.util.Date.class);

Без успеха - то же сообщение об ошибке.

Что я делаю не так?

Answer 1

Мне удалось повторить эту проблему.

Эту проблему можно решить путем определения новых AlternateTypeRules при создании Docket для вашего SWAGGER.

Ниже приведен фрагмент кода.

Docket docket= new Docket(DocumentationType.SWAGGER_2)
            .alternateTypeRules( AlternateTypeRules.newRule(
                    typeResolver.resolve(Collection.class, Instant.class),
                    typeResolver.resolve(Collection.class, Date.class), Ordered.HIGHEST_PRECEDENCE))
            .select()
            .apis(RequestHandlerSelectors.basePackage("com.test"))
            .paths(PathSelectors.any())
            .build();