swagger3.0入门代码

  
        
            org.springframework.boot
            spring-boot-starter-web
            2.1.1.RELEASE
        
        
            org.springframework.boot
            spring-boot-autoconfigure
            2.1.1.RELEASE
        

        
            commons-fileupload
            commons-fileupload
            1.3.1
        
        
            commons-io
            commons-io
            2.4
        

        
            org.apache.httpcomponents
            httpcore
            4.4.10
        

        
            org.apache.httpcomponents
            httpclient
            4.5.6
        

        
            io.springfox
            springfox-boot-starter
            3.0.0
        

        
            com.github.xiaoymin
            knife4j-spring-boot-starter
            3.0.2
        
    

swagger3.0config

import com.github.xiaoymin.knife4j.spring.annotations.EnableKnife4j;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;

import springfox.documentation.builders.*;
import springfox.documentation.service.*;
import springfox.documentation.spi.documentationType;
import springfox.documentation.spring.web.plugins.Docket;


@Configuration
@EnableKnife4j
public class Swagger3Config {




    @Bean
    public Docket createRestApi() {

        return new Docket(documentationType.OAS_30)
                //.globalOperationParameters(pars)//设置全局参数
                //.securitySchemes(securitySchemes())
                .groupName("开发组001") //分组
                .enable(true) //swagger开关
                .apiInfo(apiInfo())
                .select()
                .apis(RequestHandlerSelectors.basePackage("com.leiyang.controller"))	// 为指定当前包路径
                .paths(PathSelectors.any())
                .build();
    }

    private ApiInfo apiInfo() {
        return new ApiInfoBuilder()
                .title("测试 Swagger3 RESTful API") 	// 页面标题
                .version("3.0")								// 版本号
                .description("www.huaching.org")				    // 描述
                .build();
    }

    @Bean
    public Docket createRestApi2() {
        return new Docket(documentationType.OAS_30)
                .groupName("测试组001") //分组
                .enable(true) //swagger开关
                .apiInfo(apiInfo2())
                .select()
                .apis(RequestHandlerSelectors.basePackage("com.leiyang.controller2"))	// 为指定当前包路径
                .paths(PathSelectors.any())
                .build();
    }

    private ApiInfo apiInfo2() {
        return new ApiInfoBuilder()
                .title("测试 Swagger3 RESTful API") 	// 页面标题
                .version("3.0")								// 版本号
                .description("www.huaching.org")				    // 描述
                .build();
    }

}

@Api(tags = "swagger测试")
@RestController
public class TestController {
    @ApiOperation("测试接口")
    @ApiImplicitParams({
            @ApiImplicitParam(name = "name",value = "姓名",required = false,dataType = "String"),
            @ApiImplicitParam(name = "age",value = "年龄",required = true,paramType = "query",dataType = "Integer")
    })
}

@EnableOpenApi
@SpringBootApplication
public class testApplication {

    public static void main(String[] args) {
        SpringApplication.run(testApplication.class,args);
    }
}