使用Swagger2自动生成API文档-基于Spring Boot

1：添加俩依赖

<!--        Swagger自动生成API文档依赖-->
        <dependency>
            <groupId>io.springfox</groupId>
            <artifactId>springfox-swagger2</artifactId>
            <version>2.9.2</version>
        </dependency>
        <dependency>
            <groupId>io.springfox</groupId>
            <artifactId>springfox-ui</artifactId>
            <version>2.9.2</version>
        </dependency>

2：创建config.SpringFoxConfig.java，这个相当于一个模板，大家可以套用，当然一些自定义的可以自己更改根据自己的项目

@Configuration
public class SpringFoxConfig {

    //访问http://localhost:8080/swagger-ui.html可以看到API文档
    @Bean
    public Docket api() {
        return new Docket(DocumentationType.SWAGGER_2)
                .apiInfo(apiInfo())
                .select()
                .apis(RequestHandlerSelectors.any())
                .paths(PathSelectors.any())
                .build();
    }

    private ApiInfo apiInfo() {
        return new ApiInfoBuilder()
                .title("生鲜")
                .description("")
                .termsOfServiceUrl("")
                .build();
    }
}

3：在Application添加注解@EnableSwagger2，也就是boot启动程序

4：创建config.AlphenMallWebMvcConfig.java用于配置地址映射，这是关键，我开始因为这里面的配置写错了，然后就无法访问

/*
* 配置地址映射
* */
@Configuration
public class AlphenMallWebMvcConfig implements WebMvcConfigurer {
    @Override
    public void addResourceHandlers(ResourceHandlerRegistry registry) {
        registry.addResourceHandler("swagger-ui.html").addResourceLocations(
                "classpath:/META-INF/resource/"
        );
        registry.addResourceHandler("/webjars/**").addResourceLocations(
                "classpath:/META-INF/resource/webjars/"
        );
    }
}

5：可以在Controller中的方法上加上注解@ApiOperation("定义")

6：打开Chrome输入http://localhost:8080/swagger-ui.html/

就可以了