Swagger配置多个分组

最新推荐文章于 2025-06-07 08:05:16 发布

原创最新推荐文章于 2025-06-07 08:05:16 发布 · 3k 阅读

1 ·

CC 4.0 BY-SA版权

文章标签：

#java

本文详细介绍了如何在Spring Boot项目中使用Swagger进行API文档的分组管理和环境选择，展示了如何配置多个Docket实例并根据环境动态展示不同组的文档。

摘要生成于 C知道，由 DeepSeek-R1 满血版支持，前往体验 >

在Swagger配置文件中

@Configuration
@EnableSwagger2               //开启Swagger2
public class SwaggerConfig {
    @Bean
    public Docket docket1(){
        return new Docket(DocumentationType.SWAGGER_2)
                .groupName("A");
    }
    @Bean
    public Docket docket2(){
        return new Docket(DocumentationType.SWAGGER_2)
                .groupName("B");
    }
    @Bean
    public Docket docket3(){
        return new Docket(DocumentationType.SWAGGER_2)
                .groupName("C");
    }
    @Bean//配置了Swagger的docket的bean实例
    public Docket docket(Environment environment){
        Profiles profiles = Profiles.of("dev","test");//设置要显示的Swagger环境
        //通过acceptsProfiles判断是不是在dev环境中
        boolean b = environment.acceptsProfiles(profiles);
        return new Docket(DocumentationType.SWAGGER_2)
                .apiInfo(apiInfo())
                .groupName("老黄")
                .enable(b)
                .select()
                .apis(RequestHandlerSelectors.basePackage("com.huang.controller"))
                .build();
    }
    //配置swagger信息apiinfo（）
    private ApiInfo apiInfo(){
        Contact contact = new Contact("老黄","","943923227@qq.com");
        return new ApiInfo("Huang的Swagger的Api文档",
                "这个老黄超级帅",
                "1.0",
                "http://localhost:8080/",
                DEFAULT_CONTACT,
                "Apache 2.0",
                "http://www.apache.org/licenses/LICENSE-2.0",
                new ArrayList());
    }

}

注册多个bean的Docket类并用.groupName("xxxx")就可以实现Swagger的分组