Java Swagger使用教程

<!--Swagger(开始)-->
<dependency>
    <groupId>io.springfox</groupId>
    <artifactId>springfox-swagger2</artifactId>
    <version>2.9.2</version>
</dependency>
<dependency>
    <groupId>io.springfox</groupId>
    <artifactId>springfox-swagger-ui</artifactId>
    <version>2.9.2</version>
</dependency>
<!--Swagger(结束)-->

@Configuration
@EnableSwagger2     // 开启Swagger2
public class SwaggerConfig {
}

@Configuration
@EnableSwagger2     // 开启Swagger2
public class SwaggerConfig {
    /**
     *用于定制化配置Docket的bean实例
     */
    @Bean
    public Docket Docket() {
        return new Docket(DocumentationType.SWAGGER_2)
                .apiInfo(ApiInfo());
    }
    /**
     * 定制化信息的主要设置处
     */
    private ApiInfo ApiInfo() {
        // 作者的个人信息
        Contact contact = new Contact("作者的姓名", "作者的个人社交主页", "作者的邮箱");
        return new ApiInfo(
                "标题：Swagger的测试接口文档",
                "简介：这是一段简介，关于接口文档的简介",
                "版本号:1.0",
                "网页：这是一个网页链接",
                contact,
                "Apache 2.0",
                "http://www.apache.org/licenses/LICENSE-2.0",
                new ArrayList<>()
        );
    }
}

 @Bean
public Docket Docket() {
    return new Docket(DocumentationType.SWAGGER_2)
            .select()
            /**
             * apis就是配置哪些api可以被扫描
             * 主要参数可以包括：
             *  - RequestHandlerSelectors.basePackage()：指定可以扫描的包 参数是包(package)名
             *  - RequestHandlerSelectors.any()：扫描所有
             *  - RequestHandlerSelectors.none()：都不扫描
             *  - RequestHandlerSelectors.withClassAnnotation()：扫描类上注解  参数是注解类的反射对象，eg:@RestController.class
             *  - RequestHandlerSelectors.withMethodAnnotation()扫描方法上注解  参数是注解类的反射对象，eg:@RequestMapping.class
             */
            .apis(RequestHandlerSelectors.basePackage("com.xiaochen.swagger.controller"))
            /**
             * paths就是配置哪些映射路径下的api可以被扫描
             * 主要参数可以包括：
             *  - PathSelectors.ant()：指定映射路径 主要就是斜杠+单词或者通配符
             *  - PathSelectors.any()：扫描所有
             *  - PathSelectors.none()：都不扫描
             *  - PathSelectors.regex()：扫描符合正则的所有路径
             */
            .paths(PathSelectors.ant("/hello"))
            .build()
            .apiInfo(ApiInfo());
}

@Bean
public Docket Docket(Environment environment) {
    // 预设的项目环境(可设置多个)
    Profiles profiles = Profiles.of("dev", "test");
    // 监听项目的环境与预设的是否一致
    boolean flag = environment.acceptsProfiles(profiles);
    return new Docket(DocumentationType.SWAGGER_2)
            .enable(flag);
}