swagger2基本配置使用，生成文档，设置生产环境不启用

swagger是目前开发环境下主流的一种接口测试工具，并且可以生成swagger文档，省去了接口文档的操心事，当初这只能测试环境下用，上生产的时候我们可以选择不启用。

swagger2基本配置

上来第一步，导入依赖。

	
	
        2.9.2
        1.5.21
    
    
    
    
       io.swagger
       swagger-models
       ${swagger-models.version}
    
	
       io.springfox
       springfox-swagger2
       ${swagger.version}
    
    
       io.springfox
       springfox-swagger-ui
       ${swagger.version}
    

然后写一个swaggerConfig配置一下swagger。

@Configuration
@EnableSwagger2
public class SwaggerConfig {
    @Bean
    public Docket createRestApi(Environment environment) {
        // 设置要显示swagger的环境
        Profiles of = Profiles.of("dev", "local");
        // 判断当前是否处于该环境
        // 通过 enable() 接收此参数判断是否要显示
        boolean b = environment.acceptsProfiles(of);

        return new Docket(DocumentationType.SWAGGER_2)
                .enable(b)
                .pathMapping("/")
                .select()
                //扫描范围
                .apis(RequestHandlerSelectors.basePackage("com.boot.controller"))
                .paths(PathSelectors.any())
                .build().apiInfo(new ApiInfoBuilder()
                        .title("标题")
                        .description("描述")
                        .version("版本1.0")
                        .license("执照")
                        .licenseUrl("自家的地址")
                        .build());
    }

}

当我上面的配置为dev，而没有local时，启动配置local的环境，就无法查看。如果把local加进去上面的配置中，就可以正常显示

生成文档

对了，文档并不是说给你生成一份word，而是这个页面就是api文档了，到时候直接把地址甩给你的前端即可，不过最好是甩个服务器上跑的项目的swagger，而不是你本地的