swagger在高版本springboot中的使用

1.swagger的版本很多,但是自从springboot升级到2.6.0以上后,swagger的版本似乎没有很好的去匹配

2.不多说,直接上代码

第一步:pom文件中配置swagger的插件

    <dependency>
            <groupId>io.springfox</groupId>
            <artifactId>springfox-swagger2</artifactId>
            <version>3.0.0</version>
        </dependency>
        <dependency>
            <groupId>io.springfox</groupId>
            <artifactId>springfox-swagger-ui</artifactId>
            <version>3.0.0</version>
        </dependency>
        <dependency>
            <groupId>io.springfox</groupId>
            <artifactId>springfox-boot-starter</artifactId>
            <version>3.0.0</version>
        </dependency>

目前引用的swagger,我找的是比较新的,3.0.0的版本,稍微老一点的版本也是可以的

第二步:配置swagger的配置文件

@Configuration
@EnableSwagger2
public class SwaggerConfig {
    //swagger会帮助我们生成接口文档
    /*
     * 1,配置文档信息
     * 2,配置生成信息
     * 3,Docket封装接口文档信息
     *
     * */
    @Bean
    public Docket getDocket(){
        Docket docket = new Docket(DocumentationType.SWAGGER_2);
        ApiInfoBuilder apiInfoBuilder = new ApiInfoBuilder();
        apiInfoBuilder.title("档案库房项目后端接口说明")
                .description("此文档详细说明了档案库房项目的后端接口规范...")
                .version("1.0");
//                .contact(new Contact("F_M","www.demo.org","ll@163.com"));
        ApiInfo apiInfo = apiInfoBuilder.build();
        docket.apiInfo(apiInfo).select()
                .apis(RequestHandlerSelectors.basePackage("com.smx"))
                .paths(PathSelectors.any())//.regex("/user/")
                .build();
        return docket;
    }
}

这里注意:头部的两个注释

第三步:其实到这里,swagger就配置完成了,但是新版本的springboot还是无法正常编译,出现一堆的错误。

注意:在启动类文件中,增加一个注释来解决这个问题:@EnableWebMvc

第四步:这时候打开swagger文档就可以正常的访问了。注意的是,新版本的swagger地址调整成:swagger-ui/index.html

posted @ 2022-05-12 16:05  成神之路~  阅读(617)  评论(0)    收藏  举报