Swagger2在java中的入门操作

在使用Swagger2之前是需要添加maven依赖就行了,不用安装其他插件,添加你Maven的时候都会自动添加.
这里使用的是
springFox Swagger2 V2.9.2 的版本
springFox Swagger UI V2.9.2版本
Swagger 官网: swagger.io

    io.springfox
    springfox-swagger2
    2.9.2




    io.springfox
    springfox-swagger-ui
    2.9.2

刷新maven后直接 使用Tomcat端口+swagger-ui.html
例如

 http://localhost:8091/swagger-ui.html

打开idea 创建以个Swagger2Config类
Docket 类中的方法作用介绍
RequestHandlerSelectors 配置包 类 或 方法
basePackage("") 扫描该包下的所有restFul
any() 扫描全部restFul
none() 全不扫描
withMethodAnnotation(PostMapping.class) 扫描方法上的restFul注解的class对象
withMethodAnnotation(RequestMapping.class) 扫描类上的restFul注解的class对象
paths() 路径过滤
enable(false) 开启过关闭swagger2,就是swagger2 的开true关false
groupName(“allow”) 分组

@Configuration
@EnableSwagger2  //开启swagger2
public class Swagger2Config {
//分组
    @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 docket(){//配置swagger2的bean实例
        return new Docket(documentationType.SWAGGER_2)
                .apiInfo(apiInfo())
                .groupName("allow")
                .enable(true)
                .select()
                .apis(RequestHandlerSelectors.basePackage("com.by.baiyue.controller"))
                //.paths(PathSelectors.ant("/doLanding"))
                .build();
    }
   // 配置apiInfo()
    private ApiInfo apiInfo(){
        //作者信息
       Contact contact= new Contact("allow",
                                    "www.baidu.com",
                                    "1303358675@qq.com");
        return  new ApiInfo(
                "allow swagger2",
                "世界之大",
                "V1.0",
                "urn:tos",
                contact,
                "Apache 2.0",
                "http://www.apache.org/licenses/LICENSE-2.0",
                new ArrayList());
    }
}

配置完Swagger2Config类基本上就完成了
对于Swagger2 ui的用法很简单,自己摸索.