Springfox swagger3.0项目配置和实战

转
 2023-02-04
©版权
原文作者：PostMapping 原文地址：https://juejin.cn/post/7032092376961122335

由于项目重构，所以需要从springboot 1.5.7版本切换到2.5.6 但切换后出现了swagger 依赖冲突的问题，所以swagger也要换到3.0的版本

首先可以直接引入springfox-boot-starter,这样就简洁点引入依赖了

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

然后修改swagger 配置类，我这里没有用到很多的属性，所以就直接点 其实改动点就是

    DocumentationType SWAGGER_2换成了DocumentationType.OAS_30

配置类

    @Configuration
    @ConditionalOnProperty(prefix="swagger",value={"enable"},havingValue="true")
    public class Swagger2 {
        @Bean
        public Docket createRestApi() {
            return new Docket(DocumentationType.OAS_30)
                    .apiInfo(apiInfo())
                    .select()
                    .apis(RequestHandlerSelectors.basePackage("com.meicloud.meidevops.controller"))
                    .paths(PathSelectors.any())
                    .build();
        }
    
        private ApiInfo apiInfo() {
            return new ApiInfoBuilder()
                    .title("devops api")
                    .description("devops")
                    .termsOfServiceUrl("https://www.meicloud.com")
                    .version("1.0")
                    .build();
        }
    }

然后启动访问http://localhost:8082/swagger-ui/index.html#/

202301012100173841.png