Как изменить группу / спецификацию по умолчанию в Swagger UI? - PullRequest
Новая
       77

Как изменить группу / спецификацию по умолчанию в Swagger UI?

0 голосов
/ 04 ноября 2019

Документация Swagger в моем проекте состоит из нескольких групп. Для каждой группы есть Docket, а конечные точки (члены каждой группы) отмечены пользовательской аннотацией. Например, вот группа Docket для аутентификации : 

@Bean
public Docket authenticationApis() {

    return new Docket(DocumentationType.SWAGGER_2)
            .groupName("authentication")
            .useDefaultResponseMessages(false)
            .select()
            .apis(RequestHandlerSelectors.withMethodAnnotation(AuthenticationApiGroup.class))
            .paths(PathSelectors.any())
            .build()
            .apiInfo(apiInfo())
            .securitySchemes(Collections.singletonList(securityScheme()))
            .securityContexts(Collections.singletonList(securityContext()));
}

Существует также (по умолчанию) Docket для всех доступных конечных точек. Проблема заключается в том, что Swagger UI загружает самую верхнюю группу по умолчанию, когда я звоню по URL-адресу документации .../swagger-ui.html. В моем случае это группа аутентификация , поскольку группы отсортированы по алфавиту. Требуемое поведение заключается в том, что группа default загружается в качестве группы API по умолчанию. Как мне этого добиться?

Я попытался назвать значение по умолчанию Docket с помощью .groupName("all"), так что это самая верхняя группа ( все <<strong> аутентификация ), но это решение немного "грязное", и в этом случае в документации будет две дубликаты групп ( все и по умолчанию * 1030)*).

Springfox 2.9.2 используется в проекте.

...