提问者:小点点

如何更改SwaggerUI中的默认组/规范?


我的项目中的Swagger留档有多个组。每个组都有一个Docket,endpoint(每个组的成员)都标有自定义注释。例如,这里是用于身份验证组的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()));
}

对于所有可用的endpoint,还有一个(默认)Docket。问题是当我调用留档URL…/swagger-ui. html时,SwaggerUI默认加载最顶部的组。在我的例子中,它是身份验证组,因为组是按字母顺序排序的。所需的行为是将默认组加载为默认API组。我如何实现这一点?

我尝试使用. groupName("all")命名默认的Docket,因此它是最顶部的组(all

Springfox 2.9.2在项目中使用。


共2个答案

匿名用户

我快速而肮脏的黑客:

  • 我在前面加上“@”以在列表中首先创建一个组(因此默认)
  • 我在前面加上~"使一组在列表中最后

匿名用户

在文档中使用urls.https://github.com/swagger-api/swagger-ui/blob/v3.17.1/docs/usage/configuration.md#parameters参数